Referencia de integración con Flujos

Dónde se encuentra la acción

En el Flujo Builder, agrega un elemento Acción y luego busca «REDA AI» o filtra por la categoría de acciones de Apex. La etiqueta de la acción es Send Message to REDA AI Agent. Funciona en cualquier tipo de Flow que admita acciones de Apex: desencadenado por registro, de pantalla, programado, desencadenado por eventos de plataforma e iniciado automáticamente.

Para la configuración paso a paso, consulta Invocar REDA AI desde Flujos. Esta página se centra en el contrato.

Entradas

Tres campos son obligatorios; seis son opcionales.

Salidas

Permisos

La acción se ejecuta con el mismo usuario con el que se ejecuta el propio Flow. El usuario que la ejecuta debe poder:

• Usar REDA AI: tener asignado el conjunto de permisos REDA AI User (o REDA AI Admin).
• Leer el registro que se pasa como Record ID.
• Leer los campos de contexto configurados del agente en ese registro.
• Ejecutar las herramientas que el agente vaya a llamar: las herramientas se ejecutan con el mismo usuario.
• Si Auto-Execute Actions está activado: escribir en los objetos que el agente vaya a modificar.

Para los Flujos desencadenados por registro y por eventos de plataforma que se ejecutan en contexto del sistema, evalúa con cuidado si el modo de sistema es apropiado: el agente y las herramientas heredarán ese contexto con privilegios elevados. Para automatizaciones sensibles, ejecuta el Flujo como un usuario de servicio específico con un conjunto de permisos de alcance reducido.

Patrones comunes de Flow

Automatización desencadenada por registro

Se activa al insertar o actualizar un registro (Oportunidad, Caso, Account, objeto personalizado) y pasa el Id del registro que la desencadena junto con la instrucción del agente. Útil para el enrutamiento de casos resumido con IA, la puntuación de oportunidades y la calificación de prospectos.

Automatización programada

Un Flow programado recorre un conjunto de registros y llama a la acción para cada uno. Útil para resúmenes diarios, enriquecimiento periódico y clasificación por lotes. Ten presente el presupuesto diario de límites reguladores de Apex: una llamada por registro puede acumularse.

Desencadenada por eventos de plataforma

Un Flow suscriptor a un evento de plataforma invoca al agente. El ejemplo clásico es el patrón del canal de mensajería: un evento de plataforma de mensaje entrante activa un Flujo que llama al agente y luego publica la respuesta del agente de vuelta a través de una herramienta de mensajería saliente. Consulta Integración del canal de mensajería para conocer el patrón completo.

Flow de pantalla

Un Flow de pantalla interactivo permite que un usuario active un agente a demanda desde un botón o una acción de página. El Flow se ejecuta en el contexto del usuario; la respuesta del agente se muestra de nuevo al usuario mediante los elementos de visualización del Flujo.

Varios turnos dentro de un Flujo

Para los Flujos que necesitan varios turnos de conversación, captura el Conversation ID de la primera llamada y pásalo de vuelta en las llamadas siguientes. La plataforma encadena los turnos en un único registro de Conversación.

Gestión de errores

Siempre ramifica según Success después del elemento de acción:

• true: continúa usando Response.
• false: lee Error Message y decide cómo recuperarte. Patrones comunes: reintentar en un ciclo posterior, establecer un campo de estado en el registro principal, enviar una notificación a un administrador.

Usa Create Incident on Error para controlar si las fallas terminan en el Registro de incidentes de IA:

• Actívalo para automatizaciones de producción en las que cada falla vale la pena investigar.
• Desactívalo para Flows de alto volumen en los que las fallas individuales son tolerables y de otro modo generarían ruido de incidentes.

Ruta asíncrona

Para cargas de trabajo pesadas, en particular archivos de gran tamaño, la plataforma puede enrutar la solicitud al procesamiento asíncrono. Cuando eso ocurre, la acción regresa de inmediato con Is Async = true y un Async Request ID. El Flow ha terminado; la ejecución del agente continúa en segundo plano.

Para reaccionar ante la finalización asíncrona, crea un Flujo desencadenado por registro en Solicitud asíncrona que se active cuando el registro alcance el estado Completed o Failed, y procesa la respuesta del agente desde la Conversación vinculada. Consulta Procesamiento asíncrono de agentes para conocer el ciclo de vida completo.

Procesamiento masivo y límites reguladores

• Una llamada al agente por ejecución de Flow. Cada invocación de la acción es una llamada externa (callout) al modelo. Los Flows que se activan con DML masivo deben pasar los registros a través de un bucle o de un Flujo desencadenado por registro por cada registro: el procesamiento masivo dentro de una sola ejecución de Flow no agrupa las llamadas al modelo.
• Se aplican los límites reguladores de llamadas externas. Salesforce limita las llamadas externas por transacción. Para los Flujos que puedan invocarse de forma masiva, ten en cuenta el límite diario de llamadas externas y el tope por transacción.
• Presupuesto de créditos. Cada llamada consume créditos. Planifica la retención y la frecuencia para que el presupuesto mensual de créditos de la organización no se agote con el tráfico de las automatizaciones.
• Respaldo asíncrono. Si un archivo pesado excediera los límites síncronos, la plataforma recurre al modo asíncrono de forma automática. Aun así, tu Flow debería ramificar según Is Async para mayor integridad.

Auditoría y observabilidad

• Cada llamada impulsada por un Flujo produce un registro de Conversación. Filtra la lista de Conversaciones por Automated Source igual al nombre de tu Flow para encontrar las ejecuciones de una automatización específica.
• El Channel de la conversación refleja el canal configurado del agente (por lo general, API para los agentes impulsados por Flow).
• Las fallas con Create Incident on Error activado aterrizan en el Registro de incidentes de IA con el nombre del Flujo en el contexto.
• Usa el Depurador de conversaciones en cualquier conversación que no haya producido el resultado esperado.

Configuración del agente para uso con Flow

Para que un agente sea accesible desde los Flujos:

• Su Channel debe incluir API.
• Las herramientas que quieras que el agente use desde las llamadas de Flow deben incluir API en el alcance de su canal.
• Si Auto-Execute Actions estará activado, asegúrate de que el conjunto de herramientas del agente esté limitado a operaciones seguras de ejecutar sin revisión humana.
• Considera un agente dedicado para cada caso de uso importante de Flow en lugar de un único agente de propósito general: la personalidad, los prompts y el conjunto de herramientas son más fáciles de gobernar de esa manera.

Prácticas recomendadas

Establece siempre Automated Source. Es el campo más útil para rastrear una conversación hasta el Flujo que la produjo.

Sé deliberado con Auto-Execute Actions. Sin él, un agente que propone una escritura devuelve una tarjeta de confirmación, que un Flujo no tiene forma de mostrar. O bien activas la ejecución automática, o bien limitas el conjunto de herramientas del agente a herramientas de solo lectura y de escritura previamente aprobadas.

Ramifica según Is Async en cada Flow de producción. Tratar la respuesta como síncrona cuando Is Async es true deja al Flow esperando una respuesta que nunca llega en esa llamada.

Usa un usuario de servicio para automatizaciones sensibles. El agente hereda los permisos del usuario que lo ejecuta. Un usuario de servicio dedicado con un conjunto de permisos restringido es más fácil de auditar que un Flujo que se ejecuta como quienquiera que lo haya desencadenado.

Pasa Conversation ID al continuar un hilo. Sin él, cada llamada parece una conversación nueva y el agente no tiene memoria entre turnos.

Prueba en un sandbox antes de salir a producción. Los Flows que impulsan llamadas de IA tienen modos de falla sorprendentes — límites de tasa, agotamiento de créditos, respaldo asíncrono — que no aparecen en las pruebas unitarias. Ejecuta el Flujo contra registros representativos en un sandbox y verifica las transcripciones de Conversación antes de promoverlo.

Automatización y fiabilidad

Las invocaciones masivas desde Flow pueden devolver identificadores de solicitudes diferidas en lugar de respuestas inmediatas. Revise los elementos posteriores que esperan respuesta, créditos o resultados en la misma transacción. Las acciones automáticas conservan el canal y modo configurados, y sus resultados reales quedan en contexto; esto no garantiza un turno narrativo adicional. Se conservan desplazamientos horarios explícitos en eventos, programación, escritura de campos y CSV compatibles. Sin desplazamiento se conserva la interpretación del usuario ejecutor. El modo Sistema no genera advertencias por el mero hecho de usarlo; continúan los registros y notificaciones de nivel ERROR. La extracción respeta el límite de salida, los colores funcionan en los temas Salesforce admitidos y las pruebas empaquetadas evitan referencias estáticas que bloqueaban la instalación sin tipos de registro de Cuenta.

Preguntas frecuentes

Próximos pasos

Lee Invocar REDA AI desde Flujos para ver el tutorial de configuración paso a paso, o Integración del canal de mensajería para conocer el patrón canónico de usar los Flujos como puente hacia sistemas de mensajería externos.