Sistemas de agentes y estándares · Capítulo 2 de 8
A2A: agentes que delegan en agentes
Cómo un agente encuentra a otro mediante su Agent Card y le pasa una tarea que puede seguir hasta el final.
Objetivos
- Lee la Agent Card del agente de pagos.Pendiente
- Sigue una tarea de WORKING a INPUT_REQUIRED y a COMPLETED.Pendiente
- Responde a un id de tarea que no es tuyo y mira cómo se rechaza.Pendiente
- Ordena el intercambio.Pendiente
Paso 1 de 4: La lectura
Un par, no una herramienta
A2A (Agent2Agent, protocolo 1.0) conecta agentes que gestionan partes distintas. En el capítulo anterior el agente de soporte llamaba herramientas en un servidor MCP: funciones con un esquema, ejecutadas tal como se llamaron. Con A2A le pasa trabajo a otro agente, que decide cómo hacerlo con su propio modelo, sus herramientas y su memoria. Quien llama ve solo la tarea y sus resultados.
La Agent Card
Cada servidor A2A tiene una Agent Card. Un agente público la sirve en /.well-known/agent-card.json, donde cualquiera puede leerla sin una credencial. Nombra al agente y sus skills, lista sus interfaces (URL, binding como JSONRPC, versión de protocolo), dice si puede hacer streaming y declara cómo autenticarse, aquí con un bearer token por comercio. Cada petición lleva un header A2A-Version; un servidor rechaza una versión que su tarjeta no lista (error -32009).
Mensajes, tareas y artefactos
El cliente llama a SendMessage con un mensaje hecho de partes: texto para el modelo del otro agente, y partes de datos con un media type para valores en los que puede confiar, como el id del pedido y el monto. La respuesta es un mensaje o, para un trabajo que lleva tiempo, una tarea: un id, un contextId que agrupa una conversación y un estado como TASK_STATE_WORKING, INPUT_REQUIRED o COMPLETED. Los resultados llegan como artefactos en la tarea, aparte del chat.
INPUT_REQUIRED pausa la tarea hasta que el cliente responde. La respuesta es un mensaje nuevo que nombra el mismo taskId y contextId. El servidor mantiene separadas las tareas de cada comercio: una respuesta que nombra una tarea que no es de este comercio recibe -32001, task not found, y no se ejecuta nada.
Streaming o polling
Con SendStreamingMessage el servidor envía server-sent events: primero la tarea, luego actualizaciones de estado y de artefactos, hasta que la tarea se pausa o termina. Sin streaming, SendMessage responde cuando la tarea se pausa o termina; con returnImmediately responde de inmediato, y el cliente consulta GetTask periódicamente.
Qué haces aquí
El agente de soporte de Halden y el agente de pagos ejecutan los dos el SDK oficial de A2A para JavaScript (@a2a-js/sdk 1.3.0) en esta página, cada uno guiado por un modelo de LangChain con guion. Lee la tarjeta, sigue la tarea de reembolso por sus estados y responde tú su pregunta. Luego activa Interceptar y dirige tu respuesta a la tarea de otro comercio. Un paso opcional muestra al agente de pagos llegando a su libro contable por MCP, donde el input_required de MCP se convierte en el INPUT_REQUIRED de la tarea A2A.
Paso 2 de 4: Pruébalo: Una tarea que cruza una frontera
Una tarea que cruza una frontera
Tres pasos, una acción cada uno, y luego dos opcionales. El diagrama debajo de los pasos tiene una columna por participante y una fila por mensaje, de arriba abajo. La línea gruesa discontinua es el límite entre organizaciones.
Modo:RealSimuladoReal: el SDK de A2A para JavaScript (@a2a-js/sdk 1.3.0, A2A 1.0), cliente y servidor, y el SDK de MCP del paso opcional A2A con MCP, se ejecutan en esta página. Simulado: las decisiones de los agentes siguen un guion a menos que conectes un modelo, los pagos son simulados y los datos son ficticios.
Paso 3 de 4: Comprobación
Comprobación
Ordena el intercambio A2A del reembolso.
Arrastra los elementos, o usa los botones de flecha, para ponerlos en orden.
- Posición 1: SendMessage con la petición de reembolso.
- Posición 2: GET de la Agent Card.
- Posición 3: Tarea en TASK_STATE_COMPLETED, con el comprobante de reembolso como artefacto.
- Posición 4: SendMessage con la respuesta, en la misma tarea.
- Posición 5: Tarea en TASK_STATE_INPUT_REQUIRED.
- Posición 6: Tarea en TASK_STATE_WORKING.
Paso 4 de 4: Lo que ya puedes hacer
Lo que ya puedes hacer
- Leer una Agent Card y elegir un skill y una interfaz.
- Enviar un mensaje y seguir los estados de una tarea hasta sus artefactos, por streaming o por polling.
- Responder una tarea en INPUT_REQUIRED con una respuesta en el mismo taskId y contextId.
- Explicar cuándo usar A2A en lugar de MCP.