Acciones agénticas declarativas
¿Qué son las acciones agénticas declarativas?
Las acciones agénticas declarativas son acciones de Flujo que te permiten invocar un agente de REDA AI desde un Flujo de Salesforce. En lugar de usar Apex o API, puedes arrastrar y soltar una acción de agente en tu Flujo, configurar las entradas y ejecutar el agente como parte de tu automatización.
Esto habilita casos de uso potentes:
- Procesamiento automatizado — Activa un agente cuando se crea un registro (por ejemplo, "analiza este prospecto" cuando se crea un prospecto)
- Enriquecimiento — El agente completa los campos faltantes con base en datos externos
- Enrutamiento — El agente decide qué cola o usuario debe gestionar un registro
- Notificaciones — El agente genera resúmenes para incluir en correos
Requisitos previos
Antes de usar un agente en un Flujo:
- El agente debe existir — Crea y configura el agente (prompts, herramientas, campos de contexto)
- El agente debe estar activo — El Estado activo del agente debe estar habilitado
- Permitir solicitudes automatizadas debe estar habilitado — Configúralo en la Definición de agente para habilitar las invocaciones desde Flujos
- El Canal debe estar configurado como
API— La superficie invocable de Flujo / Apex solo resuelve agentes cuyo Canal seaAPI. Los agentes Interno, de Comunidad y de Widget externo se rechazan en el momento de la invocación con un error claro.
Un agente con Canal = API está limitado únicamente a la invocación programática: Generador de flujos, Apex, integraciones REST. No se puede colocar en una página de registro (usa el canal Interno), en una página de portal (usa Comunidad) ni en un sitio web público (usa Widget externo). Elige el canal que coincida con la superficie en la que pretendes implementarlo.
Configurar un agente para usarlo en Flujos
-
Abre la Definición de agente
Ve al agente que quieres usar en un Flujo.
-
Marca Permitir solicitudes automatizadas
Habilita esta casilla de verificación para permitir la integración con Flujos.
-
Configura el agente
Asegúrate de que el agente tenga los prompts y las herramientas adecuados para la tarea de automatización.
-
Activa el agente
Habilita el Estado activo del agente.
-
Guarda
El agente ya está listo para usarse en Flujos.
Usar un agente en un Flujo
-
Crea o abre un Flujo
Abre el Generador de flujos de Salesforce (Configuración → Flujos o desde una página).
-
Agrega un elemento de acción
Haz clic en "+" para agregar un elemento. Selecciona "Acción".
-
Busca la acción del agente de REDA AI
Busca "REDA AI" y selecciona la acción llamada "Send Message to REDA AI Agent".
-
Identifica el agente
Establece la entrada Agent Name con el ID de agente (por ejemplo, "default-assistant") — el ID del registro de Definición de agente, no el nombre visible.
-
Configura las entradas
Asigna variables del Flujo a las entradas de la acción:
- Agent Name (obligatoria) — el ID de agente
- Record ID (obligatoria) — el registro de contexto con el que trabaja el agente
- Object API Name (obligatoria) — el nombre de API del objeto del registro (por ejemplo, "Opportunity")
- Message (obligatoria) — el prompt o la instrucción que el agente debe procesar
- Auto-Execute Actions — si se deben confirmar y ejecutar automáticamente las herramientas de Acción (verdadero/falso)
- Conversation ID — pasa el Conversation ID de un turno anterior para continuar una conversación de varios turnos
- Automated Source — una etiqueta para esta automatización (por ejemplo, el nombre del Flujo), que se guarda en la conversación para auditoría
- Create Incident on Error — si es verdadero, los fallos crean un registro de Incidente de IA; si es falso, los errores solo se devuelven en la salida
-
Configura las salidas
Captura la respuesta del agente:
- Response — la respuesta de texto del agente
- Success / Error Message — si la llamada tuvo éxito, y la descripción del fallo si no
- Action Results JSON — arreglo JSON con los resultados de las acciones ejecutadas (cuando Auto-Execute Actions es verdadero)
- Credits Used — créditos de IA consumidos por la llamada
- Conversation ID — pásalo a la siguiente llamada para continuar la conversación
- Is Async / Async Request ID — se establecen cuando la respuesta se procesa de forma asíncrona (consulta Procesamiento asíncrono de agentes)
-
Usa las salidas en pasos posteriores
Pasa la respuesta del agente a otras acciones del Flujo (enviar correo, actualizar registro, etc.).
-
Prueba y guarda
Prueba el Flujo con datos de muestra. Guarda cuando esté listo.
Casos de uso comunes con Flujos
Cuando se crea un prospecto, se activa un Flujo. El Flujo llama a un agente con la información del prospecto. El agente enriquece el prospecto con información de la empresa, identifica el mejor contacto y actualiza el registro del prospecto automáticamente.
Cuando se crea un caso, un Flujo invoca un agente para analizar la descripción y la prioridad del caso. El agente determina qué equipo debe gestionarlo (Ventas, Soporte, Facturación) y el Flujo asigna el caso en consecuencia.
Un Flujo envía un informe semanal de todas las oportunidades abiertas. Para cada oportunidad, llama a un agente para generar un breve resumen. Los resúmenes se compilan en un correo y se envían a los gerentes.
Pasar archivos al agente
Un Flujo puede enviar uno o varios archivos al agente para que los analice — por ejemplo, un PDF, una imagen o un CSV ya almacenado en Salesforce. Usa la entrada File Content Version IDs: proporciona una colección de ID de ContentVersion de los archivos que quieres que el agente lea (uno o varios, hasta 5).
En tu Flujo, obtén los ID de ContentVersion de los archivos — por ejemplo, desde un elemento Obtener registros sobre ContentVersion — pásalos a File Content Version IDs, y el agente leerá el contenido de los archivos como parte de su respuesta. El agente debe tener habilitado Permitir carga de archivos; los tipos admitidos y el límite de tamaño siguen la configuración de tu REDA AI — consulta Carga de archivos.
También existe una entrada de un solo archivo, File Content Version ID, por compatibilidad con versiones anteriores. Para Flujos nuevos, usa File Content Version IDs — admite uno o varios. Si se proporcionan ambos, File Content Version IDs tiene prioridad.
Ejecutar acciones automáticamente
Ejecutar acciones automáticamente es una entrada del Flujo que decide si las acciones propuestas por el agente llegan a ejecutarse. No hay una tercera opción: un Flujo no tiene pantalla, así que una tarjeta de confirmación no tendría dónde aparecer.
- Habilitado: las herramientas de Acción del agente se ejecutan y sus resultados vuelven en la salida Action Results JSON, para que el Flujo pueda ramificar en función de ellos.
- Deshabilitado (el valor predeterminado): el agente puede seguir proponiendo acciones y ninguna se ejecuta. No queda nada pendiente de aprobación ni se lanza ningún error: la propuesta simplemente se descarta.
Esta es la trampa de la automatización con Flujos. Dejar la entrada sin marcar porque esperas el «comportamiento normal de confirmación» no te da un paso de aprobación: te da un agente que responde como si hubiera hecho el trabajo, mientras el registro nunca se creó y el correo nunca se envió. Si el Flujo debe modificar datos, pon Ejecutar acciones automáticamente en true y revisa Action Results JSON para ver el éxito de cada acción.
Con la opción habilitada, el agente considera la solicitud ya autorizada y ejecuta sus herramientas de creación de registros, actualización de registros y envío de correo sin preguntar; así que asigna a un agente invocado desde un Flujo solo las herramientas de Acción que aceptes que se ejecuten sin supervisión.
Flujos de trabajo autónomos de varios pasos
Un solo turno del agente se ejecuta como una transacción de Salesforce. Dentro de ese turno, el agente puede llamar a la IA y a sus herramientas y luego guardar datos, pero no puede llamar a un servicio externo otra vez después de haber guardado. Para la mayoría de las automatizaciones eso es suficiente. Cuando una tarea realmente necesita crear o actualizar un registro, luego llamar a un servicio externo usando ese registro y luego escribir el resultado de vuelta, un agente de canal API puede llevar el trabajo a través de turnos automáticos adicionales.
El agente solicita un turno de seguimiento con la herramienta integrada continue_workflow. Cada turno continuado se ejecuta en su propia transacción nueva —con su propio presupuesto de llamadas externas y de guardado— y retoma donde terminó el turno anterior, con los registros que acaba de confirmar disponibles para él. El agente decide cuándo se necesita otro turno; si puede terminar en un solo turno, simplemente lo hace.
- Solo canal API — la capacidad está disponible exclusivamente para agentes cuyo Canal sea
API. Los agentes Interno, de Comunidad y de Widget externo nunca la reciben. - Activado de forma predeterminada, exclusión por agente — Los agentes API tienen
continue_workflowen su conjunto de herramientas automáticamente. Para evitar que un agente encadene turnos, quita la herramienta de su conjunto de herramientas en Vista previa de ejecución del agente → Editar conjunto de herramientas, o desactiva la herramienta. - Acotado — una sola tarea puede encadenar hasta un número fijo de turnos (20 de forma predeterminada, configurable en Configuración), y cada turno consume créditos bajo el límite normal por turno, por lo que un flujo de trabajo nunca puede descontrolarse.
Un Flujo invoca un agente para dar de alta una nueva Cuenta. El agente crea la Cuenta y luego llama a continue_workflow porque ahora necesita enviar los detalles de esa Cuenta a un servicio de verificación externo. En el siguiente turno realiza la llamada externa de verificación, recibe el resultado y actualiza la Cuenta con el desenlace, todo sin una persona en el proceso.
Solo cuando una llamada externa debe ocurrir después de un guardado. Un agente ya puede leer datos, razonar y crear o actualizar varios registros dentro de un solo turno, por lo que la mayoría de las automatizaciones con Flujos nunca necesitan continuar. Reserva los flujos de trabajo de varios pasos para el patrón crear-luego-llamar-luego-escribir.
Gestión de errores en los Flujos
Si una acción de agente falla en un Flujo:
- El Flujo recibe un estado de error y puede ramificarse en consecuencia
- Puedes agregar un controlador de fallos para registrar el error o enviar una notificación
- El Flujo puede continuar, reintentar o detenerse según el tipo de error
Escenarios de error comunes:
- Agente inactivo — El agente no está activo. Revisa el campo Estado activo y actívalo si es necesario.
- Permiso denegado — El usuario del Flujo no tiene acceso a un registro. Revisa los permisos y el uso compartido.
- Falló la llamada a una herramienta — Una herramienta invocada por el agente falló. Consulta los registros para más detalles.
- Tiempo de espera agotado — El agente tardó demasiado en responder. Revisa el presupuesto de tokens y simplifica si es necesario.
Prácticas recomendadas para la integración con Flujos
Crea prompts específicos para los casos de uso con Flujos. Ejemplo: "Analiza este prospecto y extrae: (1) tamaño de la empresa, (2) sector, (3) rango de presupuesto. Devuélvelo como JSON."
Mantén las llamadas del Flujo ligeras — No pases cantidades enormes de datos a un agente en un Flujo. Mantén las cargas útiles enfocadas en lo que el agente necesita.
Supervisa el uso de tokens — Cada invocación desde un Flujo consume créditos. Supervisa tu consumo de créditos y optimiza los prompts del agente para reducir los tokens.
Establece presupuestos de tokens razonables — Asegúrate de que el Presupuesto de tokens de tu agente sea adecuado para la tarea del Flujo. Una operación por lotes podría usar un presupuesto menor que un agente interactivo.
Prueba a fondo — Prueba tu Flujo con datos reales en un sandbox. Verifica que el agente produzca salidas correctas y no cause efectos secundarios inesperados.
Preguntas frecuentes
No. La acción invocable de Flujo / Apex solo acepta agentes cuyo Canal esté configurado como API. Si un Flujo intenta invocar un agente Interno, de Comunidad o de Widget externo, la acción devuelve un error que explica la discrepancia de superficie. Crea un agente dedicado con el Canal configurado como API para los casos de uso de Flujos.
Consulta el ajuste Longitud máxima del mensaje de tu agente. Las entradas del Flujo están limitadas por este máximo. Si tu mensaje del Flujo supera el límite, el agente lo rechazará.
Sí, si asignas herramientas de escritura (creación de registros, actualización de registros, etc.) y habilitas Ejecutar acciones automáticamente. El agente puede crear y modificar registros como parte del Flujo.
Captura la salida del agente en una variable del Flujo. Luego puedes registrarla en un registro de depuración, enviarla por correo o guardarla en un campo con fines de auditoría.
No dentro del mismo turno: un turno es una transacción, y dentro de ella una llamada externa no puede ir después de un guardado. Para una tarea de crear-luego-llamar-luego-escribir, un agente de canal API usa la herramienta integrada continue_workflow para continuar en un turno nuevo (consulta Flujos de trabajo autónomos de varios pasos más arriba). Esto está disponible solo en los agentes API, está acotado por un límite de turnos configurable y se puede quitar por agente del conjunto de herramientas del agente.
Próximos pasos
Explora la administración de prompts para crear prompts especializados para tus casos de uso con Flujos, o conoce más sobre las herramientas para habilitar las acciones del agente.