Agenttien löydettävyystiedostoa ei voi lukea

Lyhyt vastaus

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.

agent.discovery_invalid · Prioriteetti: P2

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

  1. Avaa jokainen todisteissa mainittu tiedosto ja tarkista se JSON-validaattorilla.
  2. Korjaa syntaksi ja lisää pakolliset kentät tiedoston oman määrittelyn mukaan.
  3. Tarjoa se otsakkeella Content-Type: application/json (API-luettelolle application/linkset+json).
  4. 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.

Tarkista sivuni →

Aiheeseen liittyvät oppaat

Kaikki havainnot ja miten pistemäärä lasketaan