A2A Agent
A2A Agent conecta tu flujo con un agente externo que use el estándar A2A (Agent2Agent): por ejemplo agentes creados con las herramientas de Google o con el kit oficial del protocolo, o un flujo de NappAI publicado con A2A Server. Le das la dirección del agente; el componente lee su tarjeta, se adapta a la versión del estándar que use ese agente, le envía el mensaje y espera a que termine, aunque la tarea dure varios minutos.
Puedes usarlo de dos maneras:
- Directamente: le pasas un mensaje y devuelve la respuesta del agente externo.
- Como herramienta de un agente: conecta su salida Tool a las herramientas de un agente. La herramienta toma el nombre y la descripción de la tarjeta del agente externo, y tu agente decide cuándo preguntarle. Con varios componentes A2A Agent conectados al mismo agente, este reparte el trabajo entre varios agentes externos.
Cuándo usarlo
- Consultar a un agente especializado de un proveedor (por ejemplo, de logística) desde tu flujo de atención al cliente.
- Montar un agente coordinador que delega en agentes de distintas plataformas según la pregunta.
- Encadenar flujos de NappAI de cuentas distintas que se publican con A2A Server.
- Aprovechar agentes que otros equipos de tu empresa ya han construido fuera de NappAI.
Configuración
| Campo | Qué hace |
|---|---|
| Agent URL (obligatorio) | La dirección del agente externo, o la de su tarjeta. Te la da quien publica el agente. |
| Message | Lo que quieres preguntar al agente. Cuando lo usas como herramienta, déjalo vacío: lo escribe tu agente. |
| API Key | Opcional: solo si el agente externo pide una clave. Se rellena con la credencial A2A Agent. NappAI la envía como indica la tarjeta del agente. Ver Credenciales. |
Avanzado
| Campo | Qué hace |
|---|---|
| Keep Conversation | Mantiene la misma conversación con el agente externo durante toda la sesión, para que recuerde lo que ya le has dicho. Activado por defecto. |
| Max Wait (seconds) | Cuánto tiempo esperar a que el agente externo termine. Por defecto, 300 segundos; entre 10 y 900. Si no termina a tiempo, se le pide que pare la tarea y el componente se detiene indicando que se agotó el tiempo. |
| Extra Headers | Datos adicionales que algunos agentes piden en cada llamada. Úsalo solo si el proveedor del agente lo indica. |
Resultado
- Response: la respuesta del agente externo, como mensaje. Conéctala a un Chat Output o a otro componente.
- Agent Card: la tarjeta del agente externo, con su nombre, su descripción y sus habilidades.
- Tool: el agente externo como herramienta, para conectarlo a las herramientas de un agente.
Si el agente externo devuelve ficheros (por ejemplo, una imagen que ha generado), aparecen adjuntos en la respuesta del chat.
Si el agente externo necesita más información para continuar, la respuesta lo dice, para que tu agente se la pida al usuario. Si el agente externo falla, rechaza la tarea, no responde o no acepta la clave, el componente se detiene con el motivo.
Ejemplo
Una agencia de viajes tiene en NappAI un asistente que atiende a sus clientes por WhatsApp. Su proveedor de hoteles publica un agente A2A que consulta disponibilidad y precios. La agencia añade un A2A Agent con la dirección de ese agente y la credencial que le dio el proveedor, y lo conecta a las herramientas de su asistente. Cuando un cliente pregunta “¿hay habitación doble en Sevilla el próximo fin de semana?”, el asistente consulta al agente del proveedor y responde con la disponibilidad real.
Componentes relacionados
- A2A Server: publica tus propios flujos como agentes A2A.
- MCP Connection: usa en NappAI las herramientas de un servidor MCP.