Protocolo A2A para agentes
Superficie Agent2Agent (A2A), agent card, registro, certificados por tareas, MCP y webhooks.
Agent Trust implementa Agent2Agent (A2A) v1.0.0. Los agentes se registran con identidad y pueden realizar operaciones PKI de emisión, renovación y revocación de certificados mediante tareas.
Agent card#
Cada despliegue publica una tarjeta legible por máquina:
GET /.well-known/agent-card.jsonAnuncia endpoints A2A, autenticación aceptada (bearerAuth y/o mtlsAuth) y skills disponibles. Los clientes deben leerla al iniciar; es la fuente de verdad del despliegue.
Autenticación#
| Esquema | Método |
|---|---|
| Bearer / JWT | Authorization: Bearer [jwt] validado con signing secret; claim sub define identidad. |
| mTLS | Certificado cliente en listener mTLS; SPIFFE URI, subject key identifier o common name se mapea al Agent. |
| Kerberos | Cuentas de servicio unidas al dominio mediante Authorization: Negotiate. |
Auth mode: off (anónimo, identidad por IP y compatibilidad), jwt u oidc (sesión web o certificado mTLS).
Registrar agente#
POST /a2a/v1/register| Campo | Notas |
|---|---|
| agentId | Identidad única, vinculada al llamador en el primer registro. |
| displayName / agentCardJson | Nombre legible y capacidades. |
| publicKeyPem / certThumbprint | Prueba de identidad cuando la política lo exige; la define el cliente y admin no puede editarla. |
| tags[] | Etiquetas libres para reglas y grupos. |
| webhookUrl | Webhook HTTPS outbound opcional; requiere llamador autenticado. |
agentId queda ligado a quien lo registra; otro llamador no puede apropiárselo. Use un ID por agente; sin agentId, agentes de una misma IP se agrupan.
Chain of Command#
Para swarms con consentimiento, skills delegadas, vouchers firmados e informes, consulte la guía Chain of Command.
Tareas#
Operaciones de certificados son tareas asíncronas y consultables:
| Método y ruta | Uso |
|---|---|
| POST /a2a/v1/tasks/send | Crear tarea con mensaje, por ejemplo un archivo CSR. |
| GET /a2a/v1/tasks/ | Consultar estado y artifacts. |
| POST /a2a/v1/tasks//cancel | Cancelar tarea activa. |
| POST /a2a/v1/tasks//subscribe | Recibir actualizaciones SSE. |
Envíe CSR como file part, consulte hasta completed y obtenga el artifact de cadena emitida. Consulte autorregistro para el flujo completo.
Streams e idempotencia#
- SSE para message:stream y subscribe.
- X-Idempotency-Key evita crear tareas duplicadas al reintentar con la misma clave.
Webhooks#
Agentes pueden registrar webhook HTTPS outbound en host público con llamador autenticado, para recibir notificaciones en vez de consultar. Entregas verificables y fallos visibles en registro/auditoría.
Herramientas MCP de Compliance#
Agentes MCP pueden consultar directamente herramientas de compliance del gateway, por ejemplo revisar prompts antes de enviarlos al modelo y aplicar allow/deny/flag/mask. Consulte el tutorial Claude Code, Cursor y MCP.
Estados de tarea#
| Estado | Significado |
|---|---|
| submitted | Creada, en espera. |
| working | En proceso. |
| input-required | Requiere más datos del agente. |
| completed | Finalizada; artifacts disponibles. |
| canceled | Cancelada por agente o admin. |
| failed / rejected | Fallida o rechazada, por ejemplo identidad bloqueada. |
| auth-required | El agente debe autenticarse para continuar. |