Agenttien löydettävyystiedostoa ei voi lukea
Tiedosto, jota agentit etsivät hakemistosta /.well-known/, vastaa, mutta sitä ei voi lukea: agent-card.json (A2A-agent card), mcp.json (MCP-palvelimen kuvaus), api-catalog (RFC 9727) tai verkkokaupoissa ucp. Se ei ole kelvollista JSONia, tai siitä puuttuu pakollinen kenttä, kuten agent cardin name tai API-luettelon linkset.
Mitä se tarkoittaa
Hakemistossa /.well-known/ oleva tiedosto, jota agentit etsivät (agent card, MCP-kuvaus, API-luettelo tai UCP-profiili), vastaa, mutta ei kelvollisena JSONina tai ilman tarvittavia kenttiä. Sen löytävät agentit pysähtyvät siihen. Korjaa tiedosto tai poista se.
Miksi tämä on tärkeää tekoälyhaussa
Nämä tiedostot kertovat agenteille, mitä sivusto tarjoaa: agentin, jonka kanssa keskustella, MCP-palvelimen, API:n tai tavan ostaa. Agentti, joka löytää tiedoston eikä pysty jäsentämään sitä, luovuttaa arvaamisen sijaan.
Useimmat sivustot eivät tarvitse yhtäkään näistä, joten puuttuvasta tiedostosta ei koskaan ilmoiteta. Olemassa oleva mutta rikkinäinen tiedosto on yleensä peräisin testistä, mallipohjasta tai lisäosasta, joka otettiin käyttöön ja unohdettiin.
Näin korjaat
- Avaa jokainen todisteissa mainittu tiedosto ja tarkista se JSON-validaattorilla.
- Korjaa syntaksi ja lisää pakolliset kentät tiedoston oman määrittelyn mukaan.
- Tarjoa se otsakkeella
Content-Type: application/json(API-luettelolleapplication/linkset+json). - Jos sivusto ei tarjoa sitä, mitä tiedosto kuvaa, poista tiedosto. Vahvista tulos painamalla sivuraportissa ”Tarkista uudelleen”.
Esimerkki
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Miten korjauksen voi varmistaa
Paina muutoksen jälkeen raportissa "Tarkista uudelleen": se näyttää, mitä korjattiin ja miten pistemäärä muuttui.