Aģentu atklāšanas failu nevar nolasīt
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.
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
- Atveriet katru failu no pierādījumiem un pārbaudiet to ar JSON validatoru.
- Izlabojiet sintaksi un pievienojiet obligātos laukus atbilstoši faila specifikācijai.
- Pasniedziet to ar
Content-Type: application/json(API katalogamapplication/linkset+json). - 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.