Aģentu atklāšanas failu nevar nolasīt

Īsa atbilde

Fails, ko aģenti meklē mapē /.well-known/, atbild, bet to nevar nolasīt: agent-card.json (A2A aģenta karte), mcp.json (MCP servera apraksts), api-catalog (RFC 9727) vai veikaliem ucp. Tas nav derīgs JSON vai tam trūkst vajadzīga lauka, piemēram, aģenta kartes name vai API kataloga linkset.

agent.discovery_invalid · Prioritāte: P2

Ko tas nozīmē

Fails mapē /.well-known/, ko meklē aģenti (aģenta karte, MCP apraksts, API katalogs vai UCP profils), atbild, bet ne ar derīgu JSON vai bez vajadzīgajiem laukiem. Aģenti, kas to atrod, ar to arī apstājas. Izlabojiet failu vai noņemiet to.

Kāpēc tas ir svarīgi MI meklēšanai

Šie faili aģentiem pasaka, ko vietne piedāvā: aģentu, ar ko runāt, MCP serveri, API, iepirkšanās veidu. Aģents, kas atrod kādu no tiem un nevar to parsēt, padodas, nevis min.

Lielākajai daļai vietņu neviens no tiem nav vajadzīgs, tāpēc par trūkstošu failu nekad netiek ziņots. Fails, kas ir, bet ir bojāts, parasti paliek no testa, veidnes vai spraudņa, kas tika iestatīts un aizmirsts.

Kā to labot

  1. Atveriet katru failu no pierādījumiem un pārbaudiet to ar JSON validatoru.
  2. Izlabojiet sintaksi un pievienojiet obligātos laukus atbilstoši faila specifikācijai.
  3. Pasniedziet to ar Content-Type: application/json (API katalogam application/linkset+json).
  4. Ja vietne nepiedāvā to, ko fails apraksta, izdzēsiet failu. Palaidiet “Pārbaudīt vēlreiz” lapas pārskatā, lai apstiprinātu rezultātu.

Piemērs

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

Kā pārliecināties, ka labojums darbojas

Pēc izmaiņām pārskatā nospiediet “Pārbaudīt vēlreiz”: tas parāda, kas novērsts un kā mainījās vērtējums.

Pārbaudīt manu lapu →

Saistītie ceļveži

Visi konstatējumi un kā darbojas vērtējums