A2A Server
A2A Server convierte un flujo de NappAI en un agente que otros agentes pueden usar. A2A (Agent2Agent) es un estándar abierto para que agentes de distintas plataformas se comuniquen: lo admiten, entre otras, las herramientas de agentes de Google y el kit oficial del protocolo. Con este componente, tu flujo publica una tarjeta pública con su nombre, lo que hace y ejemplos de uso, y cualquier agente compatible puede enviarle tareas.
El agente es el flujo completo: el mensaje que llega entra por el Chat Input y la respuesta es lo que devuelve el Chat Output. El componente no se conecta a nada; solo describe al agente.
Cuándo usarlo
- Ofrecer tu asistente de atención al cliente a los agentes de un socio, que le preguntan por pedidos o incidencias.
- Que el agente orquestador de tu empresa, construido en otra plataforma, delegue en un flujo de NappAI las tareas de facturación.
- Publicar un agente especializado (por ejemplo, revisión de contratos) para que lo use otro equipo desde sus propias herramientas.
- Conectar dos flujos de NappAI de cuentas distintas: uno publica con A2A Server y el otro llama con A2A Agent.
Configuración
| Campo | Qué hace |
|---|---|
| Description (obligatorio) | Qué hace el agente y cuándo conviene llamarlo. Los otros agentes lo leen para decidir si le encargan una tarea, así que sé concreto. |
| Agent Name | El nombre que ven los demás agentes. Si lo dejas vacío, se usa el nombre del flujo. |
| Skills | Opcional. Una habilidad por línea, con el formato Nombre: qué hace. Si no escribes ninguna, la descripción es la única habilidad. |
Avanzado
| Campo | Qué hace |
|---|---|
| Example Requests | Una petición de ejemplo por línea, para orientar a quien llama. |
| Tags | Palabras clave separadas por comas que ayudan a encontrar el agente. |
| Version | La versión que aparece en la tarjeta del agente. Por defecto, 1.0.0. |
Publicar el agente
- Monta el flujo con un Chat Input, la lógica que necesites, un Chat Output y el componente A2A Server.
- Despliega una versión: los demás agentes usan siempre la versión desplegada. Ver Versiones y publicación.
- Pulsa Acceso a API y abre la pestaña A2A Server. Verás la dirección de la tarjeta del agente, la URL del agente y ejemplos para conectarte desde otras plataformas.
- Elige una clave API: quien llame al agente la necesita. Ver Claves API.
Ficheros
Si quien llama envía ficheros (un PDF, una imagen…), el flujo los recibe en el Chat Input y salen por su salida Binary, igual que un fichero subido en el chat. Puede enviarlos dentro del mensaje o como enlace a una dirección pública de internet.
Los ficheros que genera el flujo, por ejemplo una imagen creada por un componente de generación de imágenes, se devuelven junto con la respuesta. Cada fichero puede ocupar hasta 20 MB, con un máximo de 5 por mensaje.
Resultado
- Agent Card: la tarjeta que verán los demás agentes, para que la revises en el editor. No hace falta conectarla a nada.
Ejemplo
La distribuidora Ferretería Central tiene en NappAI un flujo que consulta el estado de los pedidos en su ERP. Le añade A2A Server con la descripción “Consulta el estado y la fecha de entrega de los pedidos de Ferretería Central a partir del número de pedido” y despliega. Su cliente principal, que gestiona las compras con un agente propio, añade la URL del agente y la clave API que le ha dado Ferretería Central. Desde entonces, su agente pregunta solo por los pedidos pendientes y recibe la respuesta del flujo.