Un archivo de descubrimiento para agentes no se puede leer

Respuesta breve

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.

agent.discovery_invalid · Prioridad: P2

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

  1. Abra cada archivo de la evidencia y páselo por un validador de JSON.
  2. Corrija la sintaxis y añada los campos obligatorios según la especificación del propio archivo.
  3. Sírvalo con Content-Type: application/json (application/linkset+json para el catálogo de API).
  4. 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.

Comprobar mi página →

Guías relacionadas

Todos los hallazgos y cómo funciona la puntuación