No es pot llegir un fitxer de descobriment d'agents
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.
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
- Obre cada fitxer de les proves i passa'l per un validador de JSON.
- Corregeix la sintaxi i afegeix els camps obligatoris, segons l'especificació del fitxer.
- Serveix-lo amb
Content-Type: application/json(application/linkset+jsonper al catàleg d'API). - 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ó.