Un archivo de descubrimiento para agentes no se puede leer
Un archivo que los agentes buscan en /.well-known/ responde, pero no se puede leer: agent-card.json (una tarjeta de agente A2A), mcp.json (un descriptor de servidor MCP), api-catalog (RFC 9727) o, en tiendas, ucp. No es JSON válido o le falta un campo obligatorio, como el name de la tarjeta de agente o el linkset del catálogo de API.
Qué significa
Un archivo en /.well-known/ que buscan los agentes (la tarjeta de agente, el descriptor MCP, el catálogo de API o el perfil UCP) responde, pero no con JSON válido o sin los campos que necesita. Los agentes que lo encuentran se detienen ahí. Corrija el archivo o elimínelo.
Por qué importa para la búsqueda con IA
Estos archivos dicen a los agentes qué ofrece un sitio: un agente con el que hablar, un servidor MCP, una API, una forma de comprar. Un agente que encuentra uno y no puede interpretarlo se rinde en lugar de adivinar.
La mayoría de los sitios no necesitan ninguno, así que nunca se informa de un archivo que falta. Un archivo que existe pero está roto suele venir de una prueba, una plantilla o un plugin que se configuró y se olvidó.
Cómo corregirlo
- Abra cada archivo de la evidencia y páselo por un validador de JSON.
- Corrija la sintaxis y añada los campos obligatorios según la especificación del propio archivo.
- Sírvalo con
Content-Type: application/json(application/linkset+jsonpara el catálogo de API). - Si el sitio no ofrece lo que describe el archivo, elimine el archivo. Pulse «Volver a comprobar» en el informe de la página para confirmar el resultado.
Ejemplo
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Cómo confirmar la corrección
Después del cambio, pulse «Volver a comprobar» en el informe: muestra qué se corrigió y cómo cambió la puntuación.