Datoteke za odkrivanje agentov ni mogoče prebrati

Kratek odgovor

Datoteka, ki jo agenti iščejo v /.well-known/, se odzove, vendar je ni mogoče prebrati: agent-card.json (kartica agenta A2A), mcp.json (opisnik strežnika MCP), api-catalog (RFC 9727) ali, pri trgovinah, ucp. Ni veljaven JSON ali pa ji manjka obvezno polje, kot je name kartice agenta ali linkset kataloga API.

agent.discovery_invalid · Prioriteta: P2

Kaj pomeni

Datoteka v /.well-known/, ki jo iščejo agenti (kartica agenta, opisnik MCP, katalog API ali profil UCP), se odzove, vendar ne z veljavnim JSON ali brez polj, ki jih potrebuje. Agenti, ki jo najdejo, se tam ustavijo. Popravite datoteko ali jo odstranite.

Zakaj je to pomembno za iskanje z UI

Te datoteke agentom povedo, kaj spletno mesto ponuja: agenta za pogovor, strežnik MCP, API, način nakupa. Agent, ki tako datoteko najde in je ne zna razčleniti, obupa, namesto da bi ugibal.

Večina spletnih mest ne potrebuje nobene od njih, zato manjkajoča datoteka nikoli ni prijavljena. Datoteka, ki obstaja, a je pokvarjena, običajno izvira iz preizkusa, predloge ali vtičnika, ki ga je nekdo nastavil in nanj pozabil.

Kako to popraviti

  1. Odprite vsako datoteko iz dokazov in jo preverite z validatorjem JSON.
  2. Popravite sintakso in dodajte obvezna polja v skladu s specifikacijo te datoteke.
  3. Strezite jo s Content-Type: application/json (application/linkset+json za katalog API).
  4. Če spletno mesto ne ponuja tega, kar datoteka opisuje, jo izbrišite. V poročilu strani zaženite „Preveri znova“, da potrdite rezultat.

Primer

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

Kako potrditi popravek

Po spremembi v poročilu pritisnite »Preveri znova«: pokaže, kaj je odpravljeno in kako se je spremenila ocena.

Preveri mojo stran →

Sorodni vodniki

Vse ugotovitve in kako deluje ocena