Skip to main content

Estimación de tiempo

15 minutos aproximadamente

Temas

¿Necesita ayuda?

Pregunte a la Comunidad

Puede recibir una respuesta del equipo de Ayuda o de la comunidad en 24 a 48 horas.

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 para un tema.
  • Probar la acción de agente.
Nota

Nota

¿Es su idioma de aprendizaje español (LATAM)? Comience el reto en un Trailhead Playground en español (LATAM) y utilice las traducciones entre paréntesis para navegar. Copie y pegue solo los valores en inglés, ya que las validaciones del reto dependen de los datos en ese idioma. Si no aprueba el reto en su organización en español (LATAM), recomendamos que (1) cambie la configuración local a Estados Unidos, (2) cambie el idioma a inglés (según estas instrucciones) y, luego, (3) haga clic en el botón “Check Challenge” (Comprobar el reto) nuevamente.

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, agreguemos una acción. Verá cómo los parámetros en Apex se transfieren automáticamente a la acción.

  1. Haga clic en Setup (Configuración) y seleccione Setup (Configuración).
  2. En el cuadro de búsqueda rápida de configuración, busque y seleccione Agentforce Assets (Activos de Agentforce).
  3. Haga clic en la ficha Actions (Acciones).
  4. Haga clic en New Agent Action (Nueva acción de agente).
  5. En Reference Action Type (Tipo de acción de referencia), seleccione Apex.
  6. En Reference Action Category (Categoría de acción de referencia), seleccione Invocable Method (Método invocable).
  7. En Reference Action (Acción de referencia), seleccione Check Weather (Comprobar clima). Este es el método invocable.

    Create an Agent Action (Crear una acción de agente) que muestra los campos que ya se mencionaron.
  1. En Agent Action Label (Etiqueta de acción de agente), deje el campo completado previamente, Check Weather (Comprobar clima), que se extrajo del parámetro de etiqueta para el método invocable.
  2. En Agent Action API name (Nombre de API de acción de agente), deje lo que se completó previamente de forma automática, Check_Weather.
  3. Haga clic en Next (Siguiente).

Como próximo paso, vamos a configurar la acción de agente. Aquí es donde comienza a ver el beneficio de los parámetros que se establecen en Apex.

  1. En Agent Action Instructions (Instrucciones de acción de agente), deje lo que se completó previamente a partir del parámetro de descripción del método invocable de Apex.
  2. Anule la selección de la opción Show loading text for this action (Mostrar texto de carga para esta acción).
  3. En Input (Entrada), observe que dateToCheck ya se completó previamente.
  4. En Instructions (Instrucciones), observe que el campo se completó previamente con el parámetro de descripción de la variable invocable de Apex. También puede actualizar las instrucciones o agregarles contenido de ser necesario.
  5. En Data Type (Tipo de datos), el campo se completó previamente con el tipo de datos de Apex.
  6. Required input (Entrada obligatoria) está seleccionado de forma predeterminada a partir del parámetro obligatorio establecido como verdadero.
  7. Marque Collect data from user (Recopilar datos del usuario).

    Sección de entrada completada como se describe en el contenido.
  1. En Outputs (Salidas), hay tres que se obtuvieron de las variables invocables de Apex, maxTemperature, minTemperature y temperatureDescription. Las instrucciones para cada uno se completaron previamente a partir de los parámetros de descripción correspondientes y el tipo de datos.
  2. En la tercera salida, temperatureDescription, seleccione Show in conversation (Mostrar en plática).

    Salida 3 completada previamente como se describió con la opción Show in conversation (Mostrar en plática) seleccionada.
  1. Haga clic en Finalizar.

¡Excelente! Se completó la acción. Ahora sabe lo que hay que hacer para agregar su Apex a las acciones. También tiene un mejor entendimiento de cómo funcionan los parámetros de Apex para ayudarlo a crear la acción. Ahora agreguemos Check Weather Agent Action (Comprobar acción de agente de clima) a un tema y probemos.

Actualizar el tema

  1. Haga clic en Setup (Configuración) y seleccione Setup (Configuración).
  2. En el cuadro de búsqueda rápida de configuración, busque y seleccione Agentforce Agents (Agentes de Agentforce).
  3. Seleccione Einstein Copilot o Agentforce (Default) (Agentforce [Predeterminado]).
  4. Hace clic en Open in Builder (Abrir en Generador).
  5. Asegúrese de que su agente esté desactivado.
  6. Seleccione MigrationDefaultTopic.
  7. Haga clic en This Topic’s Actions (Acciones de este tema).
  8. Haga clic en New (Nuevo) y seleccione Add from Asset Library (Agregar desde biblioteca de activos).
  9. Marque la casilla para la acción Check Weather (Comprobar clima) y haga clic en Finish (Finalizar).
  10. Actualice la ventana de su navegador y seleccione MigrationDefaultTopic.
  11. Haga clic en This Topic’s Actions (Acciones de este tema) y verifique si la acción Check Weather (Comprobar clima) sigue en la lista. De no ser así, repita los pasos de 8 a 11. A veces, en nuestros entornos de práctica, una acción agregada no permanece asociada al tema la primera vez que la guarda.
  12. Haga clic en Activar. Nota: Si aparece el mensaje emergente Configuration Issues Detected (Se detectaron problemas de configuración), haga clic en Ignore & Activate (Ignorar y activar).

Comprobemos el clima

  1. En el Generador de Agentforce, ingrese Check the weather for tomorrow (Comprueba el clima para mañana) en Conversation Preview (Vista previa de plática).

    Panel de plática que muestra la solicitud Check the weather for tomorrow (Comprueba el clima para mañana) y la respuesta del agente que muestra las temperaturas en Coral Cloud.
  1. Analice los pasos que el agente siguió y observe que seleccionó la acción Check Weather (Comprobar clima) para completar la solicitud.

    Los pasos del Generador de Agentforce que muestran la solicitud, la selección de Migration Default Topic (Tema predeterminado de migración) y de la acción Check Weather (Comprobar clima).
  1. ¿Le interesa saber el pronóstico del clima para la próxima semana? Entonces, ingrese Check the weather for next week (Comprueba el clima para la próxima semana).
  2. Vuelva a observar los pasos. El agente envía la fecha de cada día de la semana para generar la respuesta.

    Los pasos del Generador de Agentforce que muestran varias llamadas a la acción Check Weather (Comprobar clima) con distintas entradas de fecha.

¡Bien hecho! Dio un gran paso para aprovechar todas las funciones de Apex que ya tiene su organización y ponerlas a disposición de los agentes de IA. Descubrió algunas mejores prácticas y aprendió a establecer los parámetros para aprovechar al máximo sus agentes.

Recursos

Comparta sus comentarios de Trailhead en la Ayuda de Salesforce.

Nos encantaría saber más sobre su experiencia con Trailhead. Ahora puede acceder al nuevo formulario de comentarios en cualquier momento en el sitio de Ayuda de Salesforce.

Más información Continuar a Compartir comentarios