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 subagente.
  
• Probar la acción de agente.
  

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. En el Iniciador de aplicación , busque y seleccione Agentforce Studio.
   
2. Haga clic en Agent Customization (Personalización de agente).
   
3. Haga clic en New Version (Nueva versión).
   
4. En Subagents (Subagentes), seleccione Answer Weather Questions (Responder preguntas sobre el clima).
   
5. En Actions Available For Reasoning (Acciones disponibles para razonamiento), haga clic en Select action (Seleccionar acción) y seleccione Create a custom action (Crear una acción personalizada).
   
6. En Action Name (Nombre de la acción), escriba Check Weather (Comprobar clima).
   
7. En Description (Descripción), escriba This action will return the local weather information. (Esta acción devolverá la información del clima local).
8. En Reference Action Type (Tipo de acción de referencia), seleccione Apex.
   
9. En Reference Action Category (Categoría de acción de referencia), seleccione Invocable Method (Método invocable).
   
10. En Reference Action (Acción de referencia), seleccione Check Weather (Comprobar clima).
    
11. Haga clic en Create and Open (Crear y abrir).
    

Observará que, en la sección Inputs (Entradas), dateToCheck está completado con una descripción del parámetro de descripción de la variable invocable de Apex. Puede actualizarla o agregar instrucciones de ser necesario.

12. Asegúrese de que la opción Require input to execute action (Requerir entrada para ejecutar la acción) esté seleccionada de forma predeterminada. Esto se realiza desde el código, donde el parámetro requerido se establece en true (verdadero).
    
    

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.

13. En la tercera salida, temperatureDescription, seleccione Show in conversation (Mostrar en plática).
    
    

14. Haga clic en Guardar.
    
15. Haga clic en Commit Version (Confirmar versión).
    
16. Vuelva a hacer clic en Commit Version (Confirmar versión).
    
17. Haga clic en Activar.
    
18. Vuelva a hacer clic en Activate (Activar).
    

¡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 puede probarla.

Comprobemos el clima

El Generador de Agentforce le permite trabajar con el agente y obtener una vista previa de él directamente en la herramienta.

1. En el Generador de Agentforce, haga clic en Preview (Vista previa).
   
2. Debería estar en Live Test Mode (Modo Prueba en vivo).
   
3. En la casilla Describe your task or ask a question (Describa su tarea o formule una pregunta), ingrese What’s the weather like this Monday? (¿Cómo está el clima este lunes?) y presione Intro. Es posible que el agente solicite una fecha exacta y le ofrezca la opción para seleccionar una. Seleccione la fecha del próximo lunes y envíe la consulta.
   
4. 
   
   

Analice los pasos que el agente siguió y observe que seleccionó la acción Check Weather (Comprobar clima) para completar la solicitud.

¡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

• Ayuda de Salesforce: Las mejores prácticas para las instrucciones de acción de agentes
• YouTube: Mejores prácticas para crear acciones de Apex de Agentforce | TDX 2025: Aspectos destacados para desarrolladores
• Blog de desarrolladores de Salesforce: Crear acciones de agente personalizadas avanzadas con código