No es pot llegir un fitxer de descobriment d'agents

Resposta breu

Un fitxer que els agents busquen a /.well-known/ respon, però no es pot llegir: agent-card.json (una targeta d'agent A2A), mcp.json (un descriptor de servidor MCP), api-catalog (RFC 9727) o, a les botigues, ucp. No és JSON vàlid, o li falta un camp necessari, com el name de la targeta d'agent o el linkset del catàleg d'API.

agent.discovery_invalid · Prioritat: P2

Què vol dir

Un fitxer de /.well-known/ que busquen els agents (la targeta d'agent, el descriptor MCP, el catàleg d'API o el perfil UCP) respon, però no amb JSON vàlid, o sense els camps que necessita. Els agents que el troben s'aturen aquí. Corregiu el fitxer o elimineu-lo.

Per què és important per a la cerca amb IA

Aquests fitxers diuen als agents què ofereix un lloc: un agent amb qui parlar, un servidor MCP, una API, una manera de comprar. Un agent que en troba un i no el pot analitzar es rendeix en lloc d'endevinar.

La majoria de llocs no en necessiten cap, així que un fitxer absent no es notifica mai. Un fitxer que hi és però està trencat sol venir d'una prova, una plantilla o un connector que es va configurar i es va oblidar.

Com corregir-ho

  1. Obre cada fitxer de les proves i passa'l per un validador de JSON.
  2. Corregeix la sintaxi i afegeix els camps obligatoris, segons l'especificació del fitxer.
  3. Serveix-lo amb Content-Type: application/json (application/linkset+json per al catàleg d'API).
  4. Si el lloc no ofereix el que descriu el fitxer, elimina el fitxer. Fes "Torna a comprovar" a l'informe de la pàgina per confirmar el resultat.

Exemple

{
  "name": "Example support agent",
  "description": "Answers questions about orders",
  "url": "https://example.com/a2a",
  "version": "1.0.0",
  "skills": []
}

Com confirmar la correcció

Després del canvi, prem «Torna a comprovar» a l'informe: mostra què s'ha corregit i com ha canviat la puntuació.

Comprova la meva pàgina →

Guies relacionades

Totes les troballes i com funciona la puntuació