Skip to main content
El nodo Agente de IA externo conecta a tu flujo un agente de IA que ya vive fuera de Jelou. Jelou mantiene el canal, la seguridad y el registro de cada turno; tu agente decide la respuesta.
El nodo se está habilitando de forma gradual; si no lo ves en el canvas, pide a tu ejecutivo de Jelou que lo active.

Cómo agregar el nodo

Ambos tipos de agente de IA se agregan desde el mismo punto de entrada: el ítem AI Agent en la barra de herramientas del builder. Su comportamiento cambia según cómo lo uses:
  • Clic: agrega un nodo AI Agent normal: el agente de IA de Jelou.
  • Mantener el cursor encima (hover): abre un selector de proveedores de agentes de IA externos. Al elegir un proveedor, Jelou agrega un nodo Agente de IA externo preconfigurado para ese proveedor.
Selector de agentes de IA externos que aparece al mantener el cursor sobre el ítem AI Agent de la barra de herramientas
Este selector funciona igual que el de pasarela de pago en el nodo Pagos: eliges primero el proveedor y el nodo llega con los campos correspondientes ya organizados.
Una vez agregado, el nodo Agente de IA externo se conecta al resto de tu flujo por sus cuatro salidas, igual que cualquier otro nodo:
Nodo Agente de IA externo en un flujo, conectado por sus cuatro salidas a un mensaje de respuesta, una pregunta, un handoff a un humano y un mensaje de disculpa

AI Agent o agente de IA externo

Elige según dónde viva el agente. Para construirlo dentro de Jelou, usa el nodo AI Agent (guía general).

Proveedores disponibles

Cada proveedor pide sus propios campos, tomados directamente de su consola, y valida mientras escribes. Las credenciales se seleccionan por el nombre del secreto de la organización que las guarda; el valor del secreto nunca se muestra ni se guarda en el flujo.

Una tarea o varios turnos

Al configurar el nodo eliges cómo interactúa con tu agente:
  • Una tarea: el nodo envía la tarea una vez, recibe la respuesta y sale del nodo.
  • Varios turnos: el nodo mantiene la conversación con el agente, mensaje a mensaje, hasta que el agente la termine o la derive. Mientras el agente responde sin terminar la conversación, el nodo no toma ninguna salida: envía los mensajes al usuario y espera su siguiente mensaje para continuar con el agente.
Configuración del nodo Agente de IA externo con la interacción Varios turnos seleccionada

Ejemplo: una tarea

El nodo recibe la respuesta, la entrega al usuario y sale por Respondió. No hay una segunda vuelta con el agente: cualquier mensaje posterior del usuario ya no pasa por este nodo.

Ejemplo: varios turnos

El nodo permanece activo entre el primer y el segundo mensaje: no toma ninguna salida hasta que el agente da por terminada la conversación. Recién ahí sale por Respondió.

Salidas del nodo

El nodo Agente de IA externo tiene cuatro salidas:
Comparación de dos nodos Agente de IA externo, uno configurado por A2A y otro por Amazon Bedrock Agents, mostrando las mismas cuatro salidas
Conecta cada salida a lo que deba pasar en tu flujo. Un patrón típico:
  • Respondió → el mensaje del agente ya se entregó; continúa el flujo o termínalo.
  • Pide más información → un nodo de pregunta que recoge el dato faltante y vuelve a llamar al agente.
  • Derivar a operador → tu nodo de transferencia a la Bandeja de entrada.
  • Hubo un error → un mensaje de disculpa y, si aplica, un reintento o una derivación a un operador.

La variable “Guardar la respuesta en”

Cada nodo Agente de IA externo tiene un campo Guardar la respuesta en (por defecto agentReply) donde se escribe la respuesta del agente. Puedes referenciarla en nodos posteriores del flujo con la sintaxis habitual de variables, por ejemplo {{$context.agentReply}} en un nodo de mensaje o en una condición. Si el agente además envía datos estructurados (por ejemplo con la ruta de datos del HTTP personalizado, o con una señal variables_set), esos datos se escriben como variables individuales del contexto del flujo, disponibles para cualquier nodo posterior.

Autenticación y secretos de la organización

Cada proveedor admite uno o varios esquemas de credencial, según lo que su API acepta: En todos los casos, el nodo guarda solo el nombre del secreto de la organización, nunca su valor. El secreto se resuelve en el momento de la llamada y nunca se muestra ni se guarda en el flujo.

Opciones Enterprise para HTTP personalizado

Cuando tu agente usa HTTP (contrato de turno de Jelou) o HTTP personalizado, tu empresa puede tener acceso a opciones adicionales:
Pestaña Conexión del nodo Agente de IA externo con la URL del agente, autenticación, certificado mTLS, firma HMAC y headers fijos
Pestaña Avanzado del nodo Agente de IA externo con el tiempo límite por turno y el número de intentos
Estas opciones están disponibles en planes Enterprise. Si no las ves en tu nodo, pide a tu ejecutivo de Jelou que verifique tu plan.

Firma HMAC: qué se firma y cómo verificarla

Cuando activas la firma de solicitud, Jelou calcula un HMAC-SHA256 sobre el cuerpo exacto de la solicitud (los mismos bytes que se envían) usando el secreto que elijas, y lo envía en un header: Tu propio servidor puede verificar la firma así (Node.js, usando solo el cuerpo):
Verifica siempre sobre el cuerpo crudo de la solicitud, antes de que tu framework lo parsee a JSON. Volver a serializar el JSON parseado puede cambiar el orden de las propiedades o el espaciado y hacer que la firma no coincida aunque el contenido sea el mismo.
El campo Tarea acepta variables. Para enviar al agente el mensaje del usuario, usa {{$message.text}}: contiene el texto del mensaje que llegó al flujo. {{$input.message}} no es una variable de mensaje: $input solo guarda los datos que tu flujo recolectó (por ejemplo, con un nodo Input), así que sale vacío cuando el nodo se ejecuta desde un mensaje de chat.

Scripts previos y posteriores

Los scripts corren en el mismo entorno seguro (sandbox) que usa el nodo API, y solo aplican a proveedores HTTP. Se configuran en la pestaña Transformar del nodo, junto a la tarea que se envía y la variable donde se guarda la respuesta:
Pestaña Transformar del nodo Agente de IA externo con el campo Tarea, la variable Guardar la respuesta en, y el editor de Pre Request / Post Request
Script previo (pre-request): $context.get("agentRequest") contiene { task, sessionId, body, headers }. El script puede modificar agentRequest.body o agentRequest.headers antes de que Jelou envíe la solicitud. Por ejemplo, para envolver el cuerpo en un sobre propio de tu empresa:
Script posterior (post-response): $context.get("agentResponse") contiene { status, body }. El script debe dejar en agentResponse.body el objeto que luego lee el mapeo de la respuesta (las rutas textPath, dataPath, sessionIdPath, etc.).
Un error que lanza el script hace fallar el turno por la salida de error del nodo. Los cambios del script nunca tocan las variables propias del flujo: solo modifican lo que Jelou envía o lee para esta llamada.

Responder después (confirma y responde después)

Algunos agentes externos no contestan dentro de la misma llamada: confirman que recibieron el mensaje y envían su respuesta más tarde, por su cuenta. Para ese caso, el nodo Agente de IA externo tiene un modo opcional. Viene desactivado, así que un nodo existente se comporta exactamente igual que antes. El campo Cómo responde el agente aparece en la pestaña Conexión cuando el tipo de conexión es HTTP (contrato de turno de Jelou) o HTTP personalizado y la interacción es Varios turnos. Tiene dos opciones:
  • En la misma respuesta (por defecto): el agente responde dentro de la misma llamada, como hasta ahora.
  • Confirma y responde después: el agente confirma con cualquier respuesta 2xx. Jelou no entrega nada del cuerpo de la confirmación y deja el nodo esperando el siguiente mensaje del usuario, con el mismo tiempo de inactividad de la sesión. Ese mensaje se reenvía al agente dentro de la misma ejecución.
Pestaña Conexión del nodo Agente de IA externo con Cómo responde el agente en Confirma y responde después, el aviso de la salida de fallo, el interruptor del token con el certificado mTLS y el prefijo de la firma
Con HTTP personalizado, en este modo ya no es obligatoria la Ruta del texto de respuesta, porque no se entrega ningún texto del cuerpo.

Cuándo termina la conversación

En la pestaña Avanzado, estos dos campos opcionales aparecen solo en este modo:
  • Campo que termina la conversación: la ruta del campo en el cuerpo de la confirmación, por ejemplo status, data.state o items[0].s (máximo 200 caracteres).
  • Valores que terminan la conversación: de 1 a 20 valores distintos, separados por comas. Acepta texto, números enteros y verdadero o falso. Cuando el campo trae uno de ellos, la conversación termina y el flujo sigue por la salida Respondió.
Pestaña Avanzado del nodo Agente de IA externo con el campo que termina la conversación y sus valores

Salidas que debes conectar

  • Conecta siempre la salida Hubo un error: es la que toma el nodo cuando vence la espera sin que el usuario escriba. Sin esa conexión no podrás publicar el flujo.
  • Conecta la salida Respondió solo si definiste el campo que termina la conversación. Sin esos campos no se usa.
  • La salida Derivar a operador no es obligatoria.
El nodo muestra un aviso en el lienzo mientras falte una de las conexiones necesarias.
Cuando la espera vence, el flujo sigue por Hubo un error y Jelou no le envía ningún mensaje al usuario. Conecta esa salida a un Fin silencioso, sin mensaje de error.

Mensajes que no son texto

Cuando el usuario envía una imagen, un audio, un documento, una respuesta de WhatsApp Flow, un botón, una lista o una ubicación, el agente ya no recibe una tarea vacía. La tarea llega como [tipo] descripción (o solo [tipo]), y la solicitud incluye un objeto input.inbound con el tipo, el texto, la descripción, el tipo de archivo y el id del mensaje. Los datos sensibles no se envían por defecto. En la pestaña Transformar, el campo Datos sensibles de mensajes no texto que recibe el agente te deja elegir cuáles agregar:
  • URL del archivo
  • Respuesta de botón o lista
  • Respuesta de WhatsApp Flow
  • Ubicación
Marca solo los que tu agente necesita: pueden contener información personal. Esto aplica a cualquier tipo de conexión. El texto simple y los botones con título se envían igual que antes.
Pestaña Transformar del nodo Agente de IA externo con los datos sensibles de mensajes no texto que recibe el agente

Prefijo de la firma

Algunos agentes esperan la firma HMAC con un texto delante, por ejemplo sha256= seguido del valor. En Firmar las solicitudes, el campo Prefijo de la firma (ej. sha256=) agrega ese texto literal antes del valor de la firma. Acepta de 1 a 32 caracteres: letras, números y _ = . : / + -; no admite espacios ni plantillas. El header de la marca de tiempo nunca lleva prefijo. Se aplica a HTTP (contrato de turno de Jelou) y HTTP personalizado, y en cada reintento.

Token OAuth2 por mTLS

Si tu agente usa Credenciales de cliente OAuth2 y exige el certificado de cliente también para pedir el token, elige un Certificado mTLS y activa Pedir el token también con el certificado mTLS. El pedido del token viaja por el mismo certificado que la llamada al agente. La URL del token debe seguir siendo https. El interruptor solo aparece con esa autenticación y con un certificado elegido; si quitas el certificado, se desactiva. Desactivado, el token se pide como siempre.

El contrato de turno de Jelou

Cuando eliges HTTP (contrato de turno de Jelou), tu servidor recibe y responde con una forma fija que Jelou ya sabe interpretar, sin necesidad de mapear rutas manualmente. Esto es lo que Jelou realmente envió y recibió en una prueba real contra un servidor de agente, con la firma HMAC redactada:
En la segunda vuelta de la misma conversación, el agente ya conoce el número de pedido y el nodo entrega la conversación como terminada:
Segunda respuesta del agente
Si tu agente no habla exactamente este contrato, usa HTTP personalizado: ahí defines tú mismo la forma del cuerpo que se envía y las rutas donde Jelou debe leer el texto de respuesta, los datos estructurados y el identificador de sesión, en la pestaña Transformar del nodo.

Probar conexión

Antes de publicar tu flujo, usa el botón Probar conexión en la pestaña Conexión del nodo para verificar que todo está bien configurado, sin esperar a que un usuario real dispare el nodo. La prueba corre una serie de verificaciones encadenadas, deteniéndose en la primera que falle: Si todas las verificaciones pasan, ves una confirmación:
Resultado de Probar conexión cuando todas las verificaciones pasan, con el mensaje 'Conexión correcta'
Si alguna falla, Jelou te dice cuál fue y por qué, para que corrijas la configuración antes de publicar. Por ejemplo, si el agente rechaza la credencial:
Resultado de Probar conexión cuando una verificación falla, con el detalle de qué falló y por qué

Seguridad

  • Las credenciales nunca salen de los secretos de tu organización. El nodo guarda solo el nombre del secreto; su valor nunca se muestra ni se guarda en el flujo.
  • Solo HTTPS. Jelou no llama a direcciones internas ni privadas.
  • Las respuestas de tu agente pasan por los mismos controles de seguridad de Jelou que las respuestas de un AI Agent, antes de llegar al usuario: se filtran igual que cualquier mensaje saliente, sin que tengas que configurar nada adicional en el nodo.

Solución de problemas

Revisa primero Probar conexión: casi siempre señala si el problema es el certificado, el secreto, el token o el propio agente. Las causas más comunes son una credencial que expiró o se revocó, una URL que dejó de responder, o una respuesta del agente que no es JSON válido o no trae el campo esperado en la ruta configurada.
El nodo espera como máximo el tiempo límite por turno configurado (25 segundos por defecto, hasta 120 como máximo). Si tu agente necesita más tiempo, sube el límite en la pestaña Avanzado; si el agente falla de forma intermitente, revisa los reintentos: solo aplican a tiempos de espera, límites de uso (HTTP 429) y errores de servidor (5xx), nunca a una solicitud que el agente rechazó explícitamente.
Verifica siempre sobre el cuerpo crudo de la solicitud, antes de parsear el JSON (ver la sección de firma HMAC más arriba). Confirma también que usas el mismo secreto, la misma codificación (hexadecimal o Base64) y, si activaste timestamp.body, que estás firmando "{timestamp}.{body}" y no solo el cuerpo.
Es esperado: esa salida solo existe en modo una tarea. En varios turnos, cuando el agente necesita un dato adicional simplemente lo pide como un mensaje normal y el nodo sigue esperando la respuesta del usuario, sin tomar ninguna salida.
El nodo se está habilitando de forma gradual. Pide a tu ejecutivo de Jelou que lo active para tu empresa.
Estas opciones están disponibles en planes Enterprise. Pide a tu ejecutivo de Jelou que verifique tu plan.

Disponibilidad

El nodo Agente de IA externo se está habilitando de forma gradual. Si no lo ves en el canvas de tu proyecto, contacta a tu ejecutivo de cuenta de Jelou para solicitar su activación.

Nodo AI Agent

Configuración general del nodo AI Agent.