Usted está aquí:
Elemento Ejecutar agente
Utilice un agente Agentforce para gestionar tareas de forma dinámica en su flujo. Seleccione un agente existente o cree un agente con instrucciones y acciones personalizadas.
Ediciones necesarias
Permisos
Para utilizar agentes existentes en sus flujos, necesita el permiso de usuario Ver configuración. Para crear agentes desde Flow Builder, necesita el permiso de usuario Personalizar aplicación, Einstein Copilot Builder, Einstein Agent Platform Builder o Autoservicio Copilot Builder. Los usuarios con el perfil Administrador del sistema pueden crear y utilizar agentes.
Si no tiene permisos para crear agentes, el botón Crear agente no aparece en el panel de selección de agentes. Solo puede seleccionar agentes existentes.
Uso
Agregue un elemento Ejecutar agente a su flujo. En el campo Agente, busque y seleccione un agente activo o haga clic en Crear agente para crear uno nuevo.
Seleccionar un agente existente
Para utilizar un agente existente, busque el agente por nombre en el campo Agente. Solo los agentes activos aparecen en la lista. Tras seleccionar un agente, configure las entradas y salidas del agente en el panel de propiedades.
Crear un nuevo agente
Para crear un agente, haga clic en Crear agente. En la ventana Nuevo agente, configure la información básica del agente.
| Campo | Descripción |
|---|---|
| Etiqueta | El nombre del agente. |
| Nombre de API | El requisito de exclusividad solo se aplica a elementos dentro del flujo actual. Dos elementos pueden tener el mismo nombre de API, siempre que se utilicen en flujos diferentes. Un nombre de API puede incluir guiones bajos y caracteres alfanuméricos sin espacios. Debe empezar por una letra y no puede terminar por un guion bajo. Además, no puede incluir dos guiones bajos consecutivos. |
| Descripción | Una descripción de lo que hace el agente. |
| Acceso de usuarios | El registro de usuario como el que se ejecuta el agente. Seleccione un usuario existente o haga que el sistema cree un usuario. |
| Instrucciones | Instrucciones que describen lo que hace el agente y guían su razonamiento. |
| Acciones | Las acciones que el agente puede utilizar. Seleccione acciones existentes desde la biblioteca de activos o cree acciones personalizadas. |
Agregar acciones al agente
El agente requiere al menos una acción para realizar tareas. Agregue acciones antes de hacer clic en Crear y activar o en Agentforce Builder después de activar el agente.
Para seleccionar acciones existentes, haga clic en Seleccionar acciones. Busque y seleccione una o más acciones de la biblioteca de activos y, a continuación, haga clic en Agregar a agente. Las acciones disponibles incluyen acciones Knowledge, flujos configurados como acciones invocables y acciones estándar.
Para crear una acción, haga clic en Crear acción. En la ventana Crear acción, configure la acción.
| Campo | Descripción |
|---|---|
| Etiqueta de herramienta Agente | El nombre de la acción. |
| Nombre de API | El requisito de exclusividad solo se aplica a elementos dentro del flujo actual. Dos elementos pueden tener el mismo nombre de API, siempre que se utilicen en flujos diferentes.Un nombre de API puede incluir guiones bajos y caracteres alfanuméricos sin espacios. Debe empezar por una letra y no puede terminar por un guion bajo. Además, no puede incluir dos guiones bajos consecutivos. |
| Descripción | El nombre de la acción. El agente utiliza esta información para determinar cómo y cuándo utilizar esta acción. |
| Tipo de acción de referencia | El tipo de acción, como Flujo o Apex. |
| Categoría de acción de referencia | El subtipo del tipo de acción de referencia. No todas las acciones tienen una categoría de acción de referencia. |
| Acción de referencia | El nombre de la acción a la que hacer referencia. |
Para cada entrada, agregue una descripción acerca de lo que hace la entrada. El agente utiliza la descripción para determinar cómo utilizar la entrada al llamar a la acción. Seleccione Requerir entrada para ejecutar acción para que la entrada sea obligatoria.
Para cada salida, agregue una descripción acerca de las devoluciones de salida y cómo utilizar el resultado en el flujo. Seleccione Filtro del contexto del agente para excluir el resultado del razonamiento del agente. Seleccione Mostrar en plática para incluir este resultado en la respuesta del agente.
Haga clic en Crear y activar para crear y activar su agente.
Configurar el elemento
Tras seleccionar o crear un agente, configure el elemento Ejecutar agente en el panel de propiedades.
| Campo | Descripción |
|---|---|
| Etiqueta | La etiqueta para la acción en el lienzo y en el Gestor de cajas de herramientas. |
| Nombre de API | El requisito de exclusividad solo se aplica a elementos dentro del flujo actual. Dos elementos pueden tener el mismo nombre de API, siempre que se utilicen en flujos diferentes.Un nombre de API puede incluir guiones bajos y caracteres alfanuméricos sin espacios. Debe empezar por una letra y no puede terminar por un guion bajo. Además, no puede incluir dos guiones bajos consecutivos. |
| Descripción | La descripción del elemento. |
Establecer valores de entrada
Configure las entradas del elemento Ejecutar agente en el panel de propiedades.
| Campo | Descripción |
|---|---|
| Solicitud de agente | Una pregunta o solicitud para enviar al agente para esta ejecución de flujo. El agente aplica sus instrucciones a esta solicitud específica para generar resultados. |
| Id. de sesión | Opcional. Utilice el Id. de sesión devuelto por un elemento Ejecutar agente que se ejecuta anteriormente en el flujo. El agente mantiene su contexto de razonamiento completo y la memoria de esa plática. Si no proporciona un Id. de sesión, el agente inicia una nueva plática, pero siempre puede especificar resultados de elementos Ejecutar agente anteriores como entradas. |
Configurar salida estructurada
Para configurar el agente para devolver datos estructurados que su flujo puede utilizar, defina campos de salida estructurados. Cada campo representa una información que el agente extrae o genera.
Si configura resultados estructurados, el agente solo devuelve datos estructurados en el campo Respuesta de agente estructurada. El campo Respuesta de agente devuelve null. Si no configura el resultado estructurado, el agente solo devuelve texto no estructurado en el campo Respuesta del agente.
Para configurar el resultado estructurado, haga clic en Configurar. Configure los campos para cada campo de salida estructurado:
| campo | Descripción |
|---|---|
| Nombre del campo | Obligatorio. Nombre alfanumérico exclusivo del campo de salida estructurado. El nombre no puede contener caracteres o espacios especiales. |
| Descripción | Una breve descripción utilizada con el nombre de campo para aumentar la precisión del modelo de lenguaje grande (LLM). |
| Tipo de datos | Obligatorio. El tipo de datos del campo. Valores válidos: Cadena, Número, Booleano. |
| Obligatorio | Indica que el LLM debe generar una respuesta para este campo de salida. Requerir filas de salida puede dar como resultado respuestas imprecisas o perjudiciales por parte del LLM. |
Almacenar valores de salida
| Campo | Descripción |
|---|---|
| Respuesta de agentes | La respuesta no estructurada del agente. Devuelve nulo si el resultado estructurado está configurado. |
| Id. de sesión | El Id. de la sesión de plática en la que está la respuesta del agente. |
| Respuesta estructurada de agente | Resultado estructurado del agente. Devuelve nulo si no hay ningún resultado estructurado configurado. |
Uso de salida estructurado
Antes de configurar el resultado estructurado, ingrese una etiqueta y un nombre de API para el elemento Ejecutar agente y luego guarde el flujo.
Cuando configura salida estructurada, defina al menos 1 campo de salida estructurada antes de guardar.
Para cada campo de salida estructurado definido, se crean dos campos: uno con el nombre definido y un campo _set booleano relacionado. Por ejemplo, si definió un campo de salida estructurado denominado summary, también se crea un campo booleano denominado summary_set.
| Campo | Descripción |
|---|---|
| Verdadero | El campo se incluyó en la respuesta estructurada del agente, pero no tenía ningún valor establecido. |
| Falso | El campo no se incluyó en la respuesta estructurada del agente. |
Cuando un resultado estructurado definido devuelve null, utilice su campo _set relacionado más adelante en el flujo para determinar por qué el campo es null.
Notas de uso
- Pruebe su flujo antes de activarlo para asegurarse de que el elemento Ejecutar agente funciona como se espera.
- Puede encontrar y modificar agentes creados en Flow Builder en Agentforce Builder en cualquier momento.
- A partir de la versión 67.0 de la API, las acciones de Agente de IA ya no están disponibles desde el elemento Acción. Utilice el elemento Ejecutar agente para trabajar con agentes. Cuando abre un flujo con un elemento Acción que hace referencia a una acción Agente de IA, aparece automáticamente como un elemento Ejecutar agente. Su configuración original se mantiene.
