Agentide tuvastusfaili ei saa lugeda

Lühike vastus

Fail, mida agendid otsivad kaustast /.well-known/, vastab, kuid seda ei saa lugeda: agent-card.json (A2A agendikaart), mcp.json (MCP serveri kirjeldus), api-catalog (RFC 9727) või poodides ucp. See pole kehtiv JSON või sellel puudub vajalik väli, näiteks agendikaardi name või API kataloogi linkset.

agent.discovery_invalid · Prioriteet: P2

Mida see tähendab

Kaustas /.well-known/ olev fail, mida agendid otsivad (agendikaart, MCP kirjeldus, API kataloog või UCP profiil), vastab, kuid mitte kehtiva JSON-iga või ilma vajalike väljadeta. Agendid, kes selle leiavad, jäävad sinna pidama. Parandage fail või eemaldage see.

Miks see AI-otsingu jaoks oluline on

Need failid ütlevad agentidele, mida sait pakub: agenti, kellega rääkida, MCP serverit, API-t, ostuvõimalust. Agent, kes faili leiab, kuid ei suuda seda parsida, loobub, selle asemel et arvata.

Enamik saite ei vaja ühtegi neist, seega puuduvast failist ei teatata kunagi. Fail, mis on olemas, kuid katki, pärineb tavaliselt testist, mallist või pistikprogrammist, mis seadistati ja unustati.

Kuidas seda parandada

  1. Ava iga tõendites olev fail ja kontrolli seda JSON-validaatoriga.
  2. Paranda süntaks ja lisa kohustuslikud väljad faili enda spetsifikatsiooni järgi.
  3. Serveeri seda päisega Content-Type: application/json (API kataloogi puhul application/linkset+json).
  4. Kui sait ei paku seda, mida fail kirjeldab, kustuta fail. Käivita lehe raportis „Kontrolli uuesti“, et tulemust kinnitada.

Näide

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

Kuidas parandust kinnitada

Pärast muudatust vajuta raportis „Kontrolli uuesti“: see näitab, mis parandati ja kuidas skoor muutus.

Kontrolli minu lehte →

Seotud juhendid

Kõik leiud ja kuidas skoor arvutatakse