Saltar al contenido
Volver a Sistemas de agentes y estándares

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.

25 minutos0 de 4 objetivos hechos

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.

  1. Posición 1: SendMessage con la petición de reembolso.
  2. Posición 2: GET de la Agent Card.
  3. Posición 3: Tarea en TASK_STATE_COMPLETED, con el comprobante de reembolso como artefacto.
  4. Posición 4: SendMessage con la respuesta, en la misma tarea.
  5. Posición 5: Tarea en TASK_STATE_INPUT_REQUIRED.
  6. 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.