Phase 13: Tools & Protocols

A2A Protocolo entre agentes

Type: Build

Languages: Python (stdlib, Agent Card + Task harness)

Prerequisites: Phase 13 · 06 (MCP fundamentals), Phase 13 · 08 (MCP client)

Time: ~75 minutes

Objetivos de aprendizaje

• Distinguir entre el agente a la herramienta (MCP) y los casos de uso entre agentes (A2A).
• Publica una tarjeta de agente en /.well-known/agent-card.jsoncon habilidades ysupportedInterfacesMetadatos.
• Caminar el ciclo de vida de la tarea: TASK_STATE_SUBMITTED¿ Qué ?TASK_STATE_WORKING¿ Qué ?TASK_STATE_INPUT_REQUIRED, y los estados terminales TASK_STATE_COMPLETED¿ Qué ?TASK_STATE_FAILED¿ Qué ?TASK_STATE_CANCELED¿ Qué ?TASK_STATE_REJECTED¿ Qué ?
• Utilice mensajes cuyas partes contienen una de cada text¿ Qué ?raw¿ Qué ?url, odata, y los artefactos como salidas.

El problema

Un agente de servicio al cliente debe delegar la redacción de informes a un agente de redacción especializado.

• Funciona pero cada emparejamiento es una sola vez.
• Base de código compartida requiere que los dos agentes ejecuten el mismo marco.
• MCP: no encaja: MCP es para llamar a herramientas, no para dos agentes colaborando mientras se conserva el razonamiento interno opaco de cada agente.

A2A llena la brecha. Modela la interacción como un agente envía una tarea a otro, con un ciclo de vida, mensajes y artefactos. El estado interno del agente llamado se mantiene opaco.

A2A es el protocolo "dejen que los agentes de los marcos hablen entre sí".

El concepto

Agente Carte

Cada agente de A2A publica una tarjeta en /.well-known/agent-card.json¿Qué es esto ?

jsonCopy{
  "name": "research-agent",
  "description": "Summarizes academic papers and drafts citations.",
  "version": "1.2.0",
  "supportedInterfaces": [
    {
      "url": "https:TOK0
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "capabilities": {"streaming": true, "pushNotifications": true},
  "securitySchemes": {
    "bearer": {"httpAuthSecurityScheme": {"scheme": "Bearer"}}
  },
  "securityRequirements": [{"schemes": {"bearer": {"list": []}}}],
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["text/markdown"],
  "skills": [
    {
      "id": "summarize_paper",
      "name": "Summarize a paper",
      "description": "Read a paper PDF and produce a 3-paragraph summary.",
      "tags": ["research", "summarization"],
      "inputModes": ["text/plain", "application/pdf"],
      "outputModes": ["text/markdown"]
    }
  ]
}

El descubrimiento se basa en URL: trae la tarjeta, elige la primera supportedInterfacesEntrada cuyo protocolBindingel cliente habla, y enumera habilidades. los modos de entrada y salida son tipos de medios.

Carteles de agente firmados

Una tarjeta puede llevar unsignaturesCada entrada es un JWS (RFC 7515) calculado sobre el RFC 8785 canónico JSON de la tarjeta, con el signaturesEl campo de identidad de la tarjeta se deja fuera.

Ciclo de vida de las tareas

textCopyTASK_STATE_SUBMITTED
  -> TASK_STATE_WORKING
  -> TASK_STATE_COMPLETED | TASK_STATE_FAILED | TASK_STATE_CANCELED | TASK_STATE_REJECTED

TASK_STATE_WORKING
  -> TASK_STATE_INPUT_REQUIRED
  -> TASK_STATE_WORKING (the client sends a message with the same taskId)

Los clientes comienzan con SendMessageEl agente llamado pasa por estados; los clientes encuestan conGetTasko fluir por SSE con SendStreamingMessagey SubscribeToTaskUn arroyo llevastatusUpdatey artifactUpdateLos eventos y cierra cuando la tarea alcanza un estado terminal.finalbandera.

Mensajes y partes

Un mensaje tiene unmessageId, una role(El artículoROLE_USERo ROLE_AGENT), y una o más partes. Cada parte contiene exactamente un campo de contenido, y ese nombre de campo es el tipo.kindcampo.

• text: contenido simple.
• raw: bytes de archivo, base64 en JSON, generalmente con filenamey mediaType¿ Qué ?
• url: un enlace al contenido del archivo.
• data: carga útil estructurada JSON (entrada estructurada para el agente llamado).

Ejemplo:

jsonCopy{
  "messageId": "msg-001",
  "role": "ROLE_USER",
  "parts": [
    {"text": "Summarize this paper."},
    {"raw": "...", "filename": "paper.pdf", "mediaType": "application/pdf"},
    {"data": {"targetLength": "3 paragraphs"}, "mediaType": "application/json"}
  ]
}

Artículos

Las salidas son artefactos, no cadenas crudas. Un artefacto es una salida nombrada y tipada:

jsonCopy{
  "artifactId": "art-001",
  "name": "summary",
  "parts": [{"text": "...", "mediaType": "text/markdown"}]
}

Los artefactos pueden ser transmitidos como trozos.artifactUpdateEl evento lleva el artefacto más appendy lastChunk- El que llama se acumula.

Tres vínculos de protocolo

1. JSON-RPC 2.0 over HTTP(El artículoJSONRPCPOST para las solicitudes, SSE para la transmisión.SendMessage¿ Qué ?SendStreamingMessage¿ Qué ?GetTask¿ Qué ?ListTasks¿ Qué ?CancelTask¿ Qué ?SubscribeToTask¿ Qué ?CreateTaskPushNotificationConfig¿ Qué ?GetTaskPushNotificationConfig¿ Qué ?ListTaskPushNotificationConfigs¿ Qué ?DeleteTaskPushNotificationConfig, y GetExtendedAgentCard¿ Qué ?
2. gRPC(El artículoGRPCPara entornos empresariales donde el gRPC es nativo.
3. HTTP+JSON/REST(El artículoHTTP+JSON ). URL de recursos como POST /message:sendy GET /tasks/{id}¿ Qué ?

Las tres obligaciones tienen el mismo modelo de datos.supportedInterfacesNombres de entrada un vinculante y su protocolVersionLos clientes envían el encabezado .A2A-Version: 1.0en cada solicitud, porque un servidor lee una solicitud sin ella como versión 0.3.

httpCopyPOST /a2a HTTP/1.1
Host: research.example.com
Content-Type: application/json
A2A-Version: 1.0

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "SendMessage",
  "params": {
    "message": {
      "messageId": "msg-001",
      "role": "ROLE_USER",
      "parts": [{"text": "Summarize this paper."}]
    }
  }
}

Preservación de la apertura

Un principio clave de diseño: el estado interno del agente llamado es opaco. El llamador ve el estado de tarea y los artefactos. La cadena de pensamiento del agente llamado, sus llamadas de herramienta, su delegación de subagentes son todas invisibles. Esto es diferente de MCP, donde las llamadas de herramientas son transparentes.

Racionalización: A2A permite a los competidores colaborar sin revelar los datos internos. A2A puede ser "llamar a este agente de servicio al cliente" sin que el que llama aprenda cómo ese agente implementa el servicio.

Línea de tiempo

• 2025-04-09.Google anuncia A2A.
• 2025-06-23.Donado a la Fundación Linux.
• 2025-08.Absorbe el ACP de IBM.
• 2025-09.Naves de extensión AP2 (pagos por agentes).
• 2026-04.v1.0 lanzado con más de 150 organizaciones de apoyo.

Relación con la MCP

Utilice MCP cuando desea invocar una herramienta específica. Utilice A2A cuando desea delegar una tarea completa a otro agente. Muchos sistemas de producción utilizan ambos: un agente utiliza MCP para su capa de herramientas y A2A para su capa de colaboración.

Usalo

code/main.pyImplementa un mínimo de A2A: el agente de redacción publica su tarjeta, el agente de investigación la envía a un SendMessageLa solicitud con una parte PDF y una instrucción de texto, y la tarea se mueve a través de TASK_STATE_WORKING¿ Qué es esto ?TASK_STATE_INPUT_REQUIRED¿ Qué es esto ?TASK_STATE_WORKING¿ Qué es esto ?TASK_STATE_COMPLETEDAntes de devolver un artefacto de texto. todo stdlib; utiliza un transporte en memoria para centrarse en las formas de mensaje.

Qué ver:

• Forma de tarjeta de agente JSON.
• Asesoramiento de ID de tarea del lado del servidor y transiciones de estado.
• Partes que se escriben por el cual el campo de contenido está presente.
• TASK_STATE_INPUT_REQUIREDrama en medio de la tarea.
• El artefacto regresa al final.

Envío

Esta lección produceoutputs/skill-a2a-agent-spec.md. Dado que un nuevo agente que debe ser llamado por otros agentes, la habilidad produce el JSON de la tarjeta de agente, esquema de habilidades y plan de punto final.

Los ejercicios

1. - ¿ Qué ?code/main.py.Rastrear todo el ciclo de vida de la tarea, incluida la TASK_STATE_INPUT_REQUIREDPonga una pausa cuando el agente llamado pida una aclaración.

1. Añade una tarjeta de agente firmada.signaturesconalgse fija en HS256, firmar el JSON canónico de la tarjeta sin el signaturesEscriba un verificador y confirma que falla en una tarjeta mutada.

1. Implementar la tarea en streaming con SendStreamingMessage: el agente de redacción emite el task, tres artifactUpdatelos trozos, y un statusUpdateconTASK_STATE_COMPLETED, luego cierra la corriente.

1. Diseñar un agente A2A que envuelva un servidor MCP. Mapa cada herramienta MCP a una habilidad A2A. Observe los compromisos ¿qué opacidad se pierde?

1. Lea el anuncio de A2A v1.0 e identifique la única característica que aún no está implementada por ningún marco a partir de abril de 2026. (Intenta: se refiere a la delegación de tareas multi-hop).

Términos clave

Leer más

• a2a-protocol.org especificación canónica A2A
• a2aproject/A2A — GitHub Implementaciones de referencia y KDD
• A2A v1.0.1 release: el etiquetado docs/specification.mdy la normativa specification/a2a.protoEsta lección sigue
• Linux Foundation — A2A launch press release Transferencia de gobernanza de junio de 2025
• Google Cloud — A2A protocol upgrade hoja de ruta y impulso de los socios
• Google Dev — A2A 1.0 milestone Nota de liberación de la versión 1.0 y orientación retrocompatible

This free lesson is part of the AI Engineering from Scratch curriculum. Read the full explanation, run the lesson code, and verify the result in the interactive reader or from the repository source.

Browse the complete course catalog or open this lesson on GitHub.