Crear una acción de agente de Apex
Objetivos de aprendizaje
Después de completar esta unidad, podrá:
- Crear una acción de agente de Apex.
- Agregar una acción de agente a un tema.
- Probar la acción de agente.
Nota
¿Su idioma de aprendizaje es español? Comience el reto en un Trailhead Playground en español y utilice las traducciones proporcionadas entre paréntesis para navegar. Copie y pegue solo los valores en inglés, ya que las validaciones del reto se basan en los datos en inglés. Si no aprueba el reto en su organización en español, le recomendamos que (1) cambie la configuración regional a Estados Unidos, (2) cambie el idioma a inglés, siga las instrucciones descritas aquí y, a continuación, (3) vuelva a hacer clic en el botón Check Challenge (Comprobar el reto).
Consulte la insignia Trailhead en su idioma para obtener más información sobre cómo aprovechar la experiencia de Trailhead en otros idiomas.
Crear una acción de agente de Apex
Ahora que Apex está listo, vamos a agregarlo a una acción. Verá dónde se transfieren los parámetros de Apex a la acción automáticamente.
- Haga clic en Setup (Configuración)
y seleccione Setup (Configuración).
- En el cuadro Quick Find (Búsqueda rápida) de la configuración, busque y seleccione Agentforce Assets (Activos de Agentforce).
- Haga clic en la ficha Actions (Acciones).
- Haga clic en New Agent Action (Nueva acción de agente).
- En Reference Action Type (Tipo de acción de referencia), seleccione Apex.
- En Reference Action Category (Categoría de acción de referencia), seleccione Invocable Method (Método invocable).
- En Reference Action (Acción de referencia), seleccione Check Weather (Comprobar previsión meteorológica). Este es el método invocable.
- En Agent Action Label (Etiqueta de acción de agente), deje Check Weather (Comprobar previsión meteorológica), que se ha extraído del parámetro de la etiqueta del método invocable.
- En Agent Action API Name (Nombre de Api de acción de agente), deje el nombre que se ha completado automáticamente, Check_Weather.
- Haga clic en Next (Siguiente).
El siguiente paso es configurar la acción de agente. Aquí es donde empezará a ver los beneficios de haber establecido los parámetros en Apex.
- En Agent Action Instructions (Instrucciones de acción de agente), deje el texto que se ha completado automáticamente a partir del parámetro de descripción del método invocable de Apex.
- Anule la selección de Show loading text for this action (Mostrar texto de carga para esta acción).
- En Input (Entrada), observe que dateToCheck se ha rellenado previamente.
- En Instructions (Instrucciones), observe que se ha completado con el parámetro de descripción de la variable invocable de Apex. También puede actualizar o agregar las instrucciones según sea necesario.
- En Data Type (Tipo de datos), verá que se ha completado con el tipo de datos de Apex.
- Required input (Entrada obligatoria) aparece marcado de manera predeterminada debido que el parámetro requerido se ha establecido en true.
- Marque Collect data from user (Recopilar datos del usuario).
- En Outputs (Salidas), se han extraído tres a partir de las variables invocables de Apex, maxTemperature, minTemperature y temperatureDescription. La sección Instructions (Instrucciones) se han completado a partir de los parámetros de descripción correspondientes y el tipo de datos.
- En el tercer resultado, temperatureDescription, marque Show in conversation (Mostrar en la conversación).
- Haga clic en Finish (Finalizar).
Excelente. La acción se ha completado. Ya sabe lo que hay que hacer para agregar Apex a las acciones. Además, ya sabe cómo ayudan los parámetros de Apex a crear la acción. Vamos a agregar la acción de agente Check Weather (Comprobar previsión meteorológica) a un tema y a probarla.
Actualizar el tema
- Haga clic en Setup (Configuración)
y seleccione Setup (Configuración).
- En el cuadro Quick Find (Búsqueda rápida) de la configuración, busque y seleccione Agentforce Agents (Agentes de Agentforce).
- Seleccione Einstein Copilot o Agentforce (Default) (Agentforce [predeterminado]).
- Haga clic en Open in Builder (Abrir en Builder).
- Asegúrese de que el agente esté desactivado.
- Seleccione MigrationDefaultTopic.
- Haga clic en This Topic’s Actions (Acciones de este tema).
- Haga clic en New (Nuevo) y seleccione Add from Asset Library (Agregar desde la biblioteca de activos).
- Marque la casilla de la acción Check Weather (Comprobar previsión meteorológica) y haga clic en Finish (Terminar).
- Actualice la ventana de su navegador y, después, haga clic en MigrationDefaultTopic.
- Haga clic en This Topic’s Actions (Acciones de este tema) y compruebe que la acción Check Weather (Comprobar previsión meteorológica) sigue en la lista. Si no es así, repita los pasos del 8 al 11. A veces, en los entornos de práctica, una acción añadida no sigue asociada con el tema la primera vez que se guarda.
- Haga clic en Activate (Activar). Nota: Si aparece el mensaje emergente de Configuration Issues Detected (Se han detectado problemas de configuración), haga clic en Ignore & Activate (Ignorar y activar).
Comprobar la previsión meteorológica
- Aún en Agentforce Builder, introduzca
Check the weather for tomorrow(Comprobar la previsión meteorológica para mañana) en Conversation Preview (Vista previa de la conversación).
- Observe los pasos que ha llevado a cabo el agente y vea que se ha seleccionado la acción Check Weather (Comprobar previsión meteorológica) para cumplir la solicitud.
- ¿Quiere saber la previsión meteorológica de la próxima semana? Introduzca
Check the weather for next week(Comprobar previsión meteorológica para la siguiente semana).
- Vuelva a echar un vistazo a los pasos. El agente ha enviado la fecha de cada día de la semana para crear la respuesta.
¡Bien hecho! Ha utilizado todas las funcionalidades de Apex con las que cuenta su organización y se las ha proporcionado a los agentes de IA para que puedan utilizarlas. Ha aprendido algunas prácticas recomendadas y a establecer parámetros a fin de sacar el máximo partido de sus agentes.