A2A Python SDK

Alcance y compatibilidad

El SDK Python oficial de A2A permite integrar aplicaciones mediante Agent2Agent Protocol. El proyecto lo incluye en su catálogo de SDKs oficiales. Esta nota se basa en documentación consultada el 2026-11-09 y conserva la explicación del protocolo en agent2agent-protocol.

El repositorio Python declara implementación de A2A 1.0 y un modo de compatibilidad con 0.3, con una matriz para cliente, servidor y transports. No se debe interpretar esa tabla como equivalencia completa de funciones entre ambas revisiones. La migración del paquete y la compatibilidad de mensajes requieren comprobarse por separado.

El paquete se distribuye como a2a-sdk y contempla integraciones opcionales para servidores, transports, telemetría y almacenamiento. Seleccionar esos extras es una decisión de aplicación; una dependencia opcional disponible no es un backend ya configurado ni una garantía de persistencia. Esta nota no instala ninguno de ellos.

Frontera entre protocolo y lógica del agente

El tutorial de Agent Executor presenta a2a.server.agent_execution.AgentExecutor, con métodos asíncronos de ejecución y cancelación. Un contexto de request aporta la entrada y una cola permite emitir eventos hacia el cliente. El executor conecta el contrato de comunicación con la lógica propia del servicio.

Eso permite que el comportamiento interno conserve su framework o implementación. Un servidor A2A puede envolver una capacidad sin entregar al cliente sus herramientas internas, prompts o memoria. multi-agent-coordination sigue siendo una decisión de composición: el SDK no elige automáticamente qué trabajo conviene delegar ni quién debe aceptarlo.

Una integración de desarrollo podría solicitar análisis a un servicio especializado y recibir observaciones como resultado. A2A organiza la interacción; evaluar si esas observaciones son correctas y útiles requiere evidencia del dominio y del código revisado.

Descubrimiento, tarea y resultado

El tutorial de interacción muestra cómo un cliente obtiene información del servidor y realiza solicitudes. Antes de copiar sus llamadas, comprobar el tutorial contra la revisión y el SDK elegidos: un ejemplo ligado a otra línea puede conservar nombres o formas de mensajes diferentes.

Como esquema ilustrativo del Atlas:

cliente identifica servidor y capacidades anunciadas
→ comprueba endpoint, autenticación y compatibilidad
→ envía un encargo delimitado con contexto autorizado
→ observa respuestas, estado y artefactos disponibles
→ evalúa el resultado y decide el siguiente paso

Una Agent Card ayuda a describir la capacidad remota; su contenido anunciado necesita una relación de confianza con el endpoint utilizado. Descubrir una skill A2A tampoco equivale a cargar un archivo SKILL.md: agent-skills documenta el artefacto de procedimiento reutilizable, con otra función y ciclo de activación.

Seguridad y recuperación

La aplicación debe autenticar y autorizar cada interacción pertinente, separar datos entre usuarios y limitar el contexto transferido. Un identificador de tarea sirve para correlación; no debe tratarse por sí solo como credencial para recuperar resultados de otros usuarios. trust-boundaries y least-privilege-for-agents permiten revisar el recorrido.

Implementar cancelación exige decidir qué acciones pueden detenerse y cómo comunicar lo que ya ocurrió. Un mensaje cancelado no revierte necesariamente una modificación externa. Ante pérdida de conexión, distinguir una tarea todavía ejecutándose de un fallo confirmado y evitar reenviar trabajo con efectos sin una estrategia de idempotency.

Los artefactos y mensajes recibidos permanecen como información externa. prompt-injection y data-leakage siguen siendo relevantes aunque la biblioteca haya interpretado correctamente los tipos protocolarios.

Prueba de integración propuesta

Usar un servidor de laboratorio con datos sintéticos y un resultado conocido. Observar consulta de capacidades, envío, evolución de estado, resultado y cancelación. Probar también acceso no autorizado a otra tarea, revisión no admitida y una desconexión después del envío. Verificar los efectos observados, además del último mensaje recibido.

Después, evaluar calidad de la capacidad remota con agent-evaluation. Una integración transporta trabajo; no demuestra fiabilidad del sistema completo. Esta nota no ejecuta el SDK ni presenta un benchmark. ai-technology-catalog reúne las implementaciones y sus límites de cobertura.