Haz que tu agente sea descubrible
Un Agent Card claro da a los clientes A2A un punto de partida fiable: a quién pertenece el agente, dónde vive, y qué bindings de protocolo y versiones habla.
Qué crea un generador de Agent Card para tu agente de IA
Un Agent Card es la descripción de interfaz pública de un agente A2A. Antes de que otro agente pueda decidir si llamar a tu servicio, necesita más que una URL: necesita una descripción fiable del propósito del agente, su contrato técnico, sus skills y sus requisitos de acceso.
Este generador de Agent Card convierte esos detalles de implementación en JSON legible con la forma de A2A v1.0, manteniendo la toma de decisiones cerca del formulario. Úsalo después de haber construido la lógica central del agente y antes de desplegarlo o publicarlo — el punto donde un archivo JSON escrito a mano suele fallar.
Describe una interfaz utilizable
Captura la interfaz preferida, los modos de contenido, el comportamiento de streaming y el soporte de notificaciones push que otro agente necesita antes de hacer una llamada.
Establece expectativas de acceso
Documenta si el servicio es público, usa una clave de API, o requiere OAuth 2.0, para que las integraciones puedan elegir el flujo de autenticación correcto — sin poner nunca una credencial en la Agent Card.
Convierte skills en contratos claros
Nombra el trabajo que tu agente puede realizar, añade las etiquetas que requiere v1.0 más ejemplos útiles, y haz que sus límites sean comprensibles para personas, marketplaces y clientes de IA.
Cómo funciona el Generador de Agent Card
De los detalles del servicio a un Agent Card publicable
El Generador de Agent Card convierte los detalles del servicio en un documento JSON claro y publicable. Sigue este breve flujo de trabajo antes de enviar el Agent Card a producción.
- 1
Comienza con el servicio real
Añade el endpoint A2A público, el binding de protocolo, los detalles del proveedor, la versión del agente, y los tipos de contenido que tu servidor acepta y devuelve.
- 2
Define los límites de capacidades y skills
Selecciona solo las capacidades que tu implementación soporta, luego describe una skill representativa en lenguaje sencillo y específico.
- 3
Revisa el JSON generado
Usa la vista previa en vivo para detectar campos faltantes, URL de marcador de posición, o descripciones que no reflejan con precisión el servicio desplegado.
- 4
Valida y publica
Pasa la Agent Card por el validador, luego coloca el documento revisado en /.well-known/agent-card.json en el dominio de tu servicio.
Quién usa el Generador de Agent Card
Diseñado para todos los que crean, publican o revisan Agent Cards
El Generador de Agent Card ayuda a constructores, equipos de plataforma y revisores a crear metadatos de agente A2A consistentes sin partir de un archivo JSON en blanco.
Desarrolladores de IA e independientes
Reemplaza un agent-card.json escrito a mano con un punto de partida completo y con la forma de la especificación al lanzar un agente compatible con A2A.
Ingenieros de prompts y product managers
Redacta un documento de descubrimiento creíble a partir de una descripción del servicio sin tocar la sintaxis JSON, luego entrégalo a ingeniería para su revisión.
Equipos de plataforma y DevOps
Estandariza cómo los agentes internos describen endpoints, autenticación y skills antes de que entren en un catálogo de agentes de la empresa o en un pipeline de CI.
Publicadores de marketplace
Prepara metadatos de proveedor, etiquetas de skills, y declaraciones de seguridad que los revisores y los sistemas de ranking puedan realmente analizar.
Preguntas frecuentes
Preguntas sobre el generador de Agent Card
Ten los elementos esenciales correctos antes de que un cliente A2A encuentre tu endpoint.
¿Qué es un A2A Agent Card?
Un A2A Agent Card es un documento de descubrimiento JSON para un agente de IA. Comunica identidad, información del proveedor, interfaces soportadas, capacidades, skills, modos de contenido aceptados, y requisitos de seguridad a posibles clientes — el equivalente agente a agente de un README más una visión general de la API.
¿Por qué usar un generador de Agent Card en lugar de escribir JSON a mano?
Las Agent Cards escritas a mano suelen tener campos requeridos faltantes, nombres de campos anteriores a v1.0, o errores de sintaxis. El generador produce la forma actual de A2A v1.0 — supportedInterfaces, provider.organization, etiquetas de skill requeridas — y valida mientras escribes, por lo que los errores estructurales nunca llegan a producción.
¿A qué versión de A2A apunta la Agent Card generada?
El generador emite la estructura A2A v1.0: un array ordenado de supportedInterfaces con protocolBinding y protocolVersion por interfaz, una versión de agente de nivel superior, y capabilities incluyendo extendedAgentCard. Las Agent Cards con campos url o preferredTransport de nivel superior son anteriores a v1.0.
¿El JSON generado necesita revisión antes de producción?
Sí. El generador crea un documento de partida práctico, no un sustituto de tu contrato desplegado. Confirma que los endpoints, bindings de protocolo, skills y autenticación coinciden con el servicio al que los usuarios realmente accederán.
¿Dónde publico un Agent Card?
Publica el JSON revisado en el mismo dominio que tu servicio A2A en https://tu-dominio/.well-known/agent-card.json, la ruta well-known registrada por la especificación A2A. Muchas integraciones más antiguas también comprueban /.well-known/agent.json, así que servir ambas es una estrategia de transición segura.
Listo para publicar
Vuelve al Generador de Agent Card antes de publicar.
Termina los detalles, revisa el JSON generado, y usa la validación en vivo antes de publicar tu Agent Card.