El Validador de Agent Card comprueba JSON pegado, archivos de Agent Card subidos, y URL públicas de agentes contra los requisitos de descubrimiento de A2A v1.0.
Pegue JSON, una URL de agente público, o arrastre un archivo JSON al editor.
Cobertura del Validador de Agent Card
El Validador de Agent Card está diseñado para desarrolladores que publican agentes A2A, equipos de plataforma internos que revisan metadatos de agentes, y operadores de marketplace que comprueban si una Agent Card enviada contiene suficiente información para una invocación fiable.
Pega un documento JSON local durante el desarrollo, sube una Agent Card desde tu repositorio, o usa validación de URL en vivo contra un dominio desplegado para verificar rutas de descubrimiento públicas.
Comprueba los campos requeridos contra la especificación v1.0: name, description, version, supportedInterfaces con protocolBinding y protocolVersion por interfaz, capabilities, modos de contenido, y al menos una skill con las etiquetas requeridas.
Detecta estructuras anteriores a v1.0 — url de nivel superior, preferredTransport, protocolVersion, provider.name, stateTransitionHistory — y te dice exactamente dónde se movió cada campo en v1.0.
Verifica que securitySchemes y los requisitos de seguridad estén declarados para endpoints no públicos, marca las URL que no son HTTPS, y escanea valores que parezcan claves de API, JWT, o tokens bearer incrustados.
Obtiene /.well-known/agent-card.json y el legado /.well-known/agent.json desde un dominio en vivo y confirma que ambos devuelven JSON de Agent Card analizable.
Dónde encaja la validación
Una Agent Card que pasó la revisión el mes pasado aún puede romper el descubrimiento hoy — un endpoint se mueve, una skill cambia, un redespliegue elimina la ruta well-known. Los equipos de plataforma y los revisores de marketplace tratan la validación como una puerta repetible, no una comprobación única.
La protección de CI más simple no necesita nada más que curl: confirma que la ruta well-known responde con JSON analizable antes de que el tráfico cambie a un nuevo despliegue.
# deploy pipeline: fail if the published card breaks
curl -fsS https://your-domain/.well-known/agent-card.json \
| python3 -c '
import json, sys
card = json.load(sys.stdin)
assert card.get("name"), "name is required"
assert card.get("supportedInterfaces"), "supportedInterfaces missing"
assert card.get("skills"), "skills missing"
print("agent card OK:", card["name"])'Guía de correcciones
Usa el informe del Validador de Agent Card para abordar primero los campos requeridos, luego mejora los detalles de descubrimiento, confianza, y migración.
Reemplaza las URL de endpoint de marcador de posición con la URL del servicio A2A HTTPS desplegado.
Mueve el url y preferredTransport de nivel superior a un array supportedInterfaces ordenado — la primera entrada es la interfaz preferida.
Añade el campo version de nivel superior requerido que describe al propio agente, y añade etiquetas a cada skill.
Renombra provider.name a provider.organization y amplía las descripciones cortas para que los clientes sepan cuándo invocar al agente.
Declara metadatos de seguridad siempre que el endpoint del agente no sea completamente público — y nunca incrustes la credencial misma.
Publica el mismo Agent Card válido en /.well-known/agent-card.json (y en la ruta legada agent.json mientras los clientes sigan comprobando ambas).
Preguntas frecuentes
Ten los elementos esenciales correctos antes de que tu agente llegue a un cliente A2A.
Comparar ejemplos válidosLas comprobaciones siguen la estructura de Agent Card de A2A v1.0 — supportedInterfaces, versiones de protocolo por interfaz, etiquetas de skill requeridas, provider.organization. Las Agent Cards anteriores a v1.0 no se rechazan directamente: los campos heredados aparecen como avisos con el reemplazo exacto de v1.0.
La especificación v1.0 registra /.well-known/agent-card.json, pero las implementaciones A2A anteriores usaban /.well-known/agent.json. Comprobar ambas detecta brechas de descubrimiento antes de que los clientes fallen.
Los avisos no bloquean como errores de JSON, pero normalmente señalan metadatos que hacen que el agente sea más fácil de descubrir, confiar, y llamar — o campos anteriores a v1.0 que los clientes más nuevos dejarán de leer.
Tres momentos: mientras editas una Agent Card durante el desarrollo, como puerta de CI antes del despliegue, y después de publicar — pega la URL del servicio en vivo para confirmar lo que los clientes realmente reciben de ambas rutas de descubrimiento.
Listo para validar
Pega JSON, suelta un archivo de Agent Card, o comprueba una URL pública desde el espacio de trabajo unificado del validador.