Configurar una acción invocable de agente personalizado en Flow Builder
Agregue una acción invocable de agente personalizada a un flujo nuevo o existente para completar una tarea automáticamente con su Agente de servicio Agentforce o agente Agentforce predeterminado.
Ediciones necesarias
| Disponible en: Lightning Experience |
| Disponible en: Enterprise Edition, Performance Edition, Unlimited Edition y Developer Edition. Las licencias complementarias requeridas varían por tipo de agente. |
| Permisos de usuario necesarios | |
|---|---|
| Para crear una acción invocable de agente asociada con un Agente de servicio Agentforce: | Gestionar agentes de servicio Agentforce Y Gestionar agentes de IA O BIEN Personalizar aplicación |
| Para crear una acción invocable de agente asociada con un agente de Agentforce Employee: | Gestionar agentes de IA O BIEN Personalizar aplicación |
| Para crear una acción invocable de agente asociada con Agentforce (Predeterminado): | Gestionar agentes de IA Y los permisos requeridos para su tipo de agente O BIEN Personalizar aplicación |
| Para abrir, modificar o crear un flujo en Flow Builder: | Gestionar flujo |
Si aún no lo hizo, prepárese para llamar a un agente desde una clase o flujo de Apex.
-
En Flow Builder, seleccione Acción. A continuación, desde la categoría Acciones de agente de IA, seleccione la acción invocable personalizada para el agente al que desea llamar desde su flujo.
Solo se enumeran las acciones invocables asociadas con agentes activos.
- Introduzca un nombre para su acción y una descripción opcional.
-
En el campo Mensaje de usuario, introduzca un mensaje de usuario de muestra al agente que define la tarea que completar. El agente utiliza la expresión para buscar en los temas y acciones que tiene asignados para identificar la acción o acciones correctas para la tarea.
Por ejemplo, “Generar un resumen del caso de servicio entrante en menos de 100 caracteres”.
-
(Opcional) En el campo Recurso, seleccione variables para incluir en el mensaje.
Agregue los elementos a los que desea hacer referencia en el mensaje de usuario antes de la acción invocable del agente en el flujo. Por ejemplo, para obtener el Id. de un registro en el mensaje de usuario, agregue el elemento Obtener registros a su flujo.No incluya variables de contexto en el mensaje de usuario. En su lugar, utilice campos de entrada.
-
(Opcional) Especifique un Id. de sesión para la conversación con el agente.
Si incluye múltiples acciones invocables asociadas con el mismo agente en su flujo, puede utilizar el Id. de sesión como una entrada en acciones posteriores. Si no especifica un Id. de sesión, se crea una nueva sesión.
-
(Opcional) Si su acción invocable está en la versión 1.1.0, haga clic en Configurar en la sección Modificar salida estructurada y luego defina al menos un campo de salida estructurado.
Cuando modifica el resultado estructurado de una acción invocable, los cambios se aplican a versiones anteriores del flujo, incluyendo versiones activas.
- (Opcional) Si su acción invocable llama a un Agente de servicio Agentforce, las variables de contexto que agregó al agente se rellenan como entradas. Para utilizar una variable de contexto como entrada, asígnela a una variable. Si no desea utilizar una variable de contexto, deje el campo en blanco. Utilice Agentforce Builder para agregar o eliminar variables de contexto.
- (Opcional) Si su acción invocable está en la versión 1.1.0, defina los campos que desea que la acción devuelva como salida al flujo. Para asegurarse de que la acción siempre devuelve un campo específico, marque el campo como obligatorio.
- Guarde sus cambios.
- Cuando esté listo, otorgue a sus usuarios acceso y active su flujo.
Para probar la configuración de temas y acciones de su agente, en Agentforce Builder, introduzca su mensaje de usuario en la conversación de vista previa. Para obtener una vista previa de la respuesta de su agente, utilice la función Flujo de depuración en Flow Builder. Las pruebas Apex no son compatibles con acciones invocables por agentes personalizados.
Si su acción invocable está en la versión 1.1.0, el agente responde con un objeto Apex que incluye los campos que especificó.
Si su acción invocable está en la versión 1.0.0, el agente responde con una respuesta de cadena de texto. Puede utilizar una clase Apex en un flujo para analizar la respuesta del agente. Consulte Ampliar flujos con Apex.
{
sessionId: "uuid",
message: {
type: text,
value: AGENT RESPONSE
}
}