Datoteke za odkrivanje agentov ni mogoče prebrati
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.
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
- Odprite vsako datoteko iz dokazov in jo preverite z validatorjem JSON.
- Popravite sintakso in dodajte obvezna polja v skladu s specifikacijo te datoteke.
- Strezite jo s
Content-Type: application/json(application/linkset+jsonza katalog API). - Č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.