Agentams skirto aptikimo failo neįmanoma perskaityti
Failas, kurio agentai ieško kataloge /.well-known/, atsako, bet jo neįmanoma perskaityti: agent-card.json (A2A agento kortelė), mcp.json (MCP serverio aprašas), api-catalog (RFC 9727) arba parduotuvėse ucp. Tai negaliojantis JSON arba jam trūksta reikiamo lauko, pvz., agento kortelės name ar API katalogo linkset.
Ką tai reiškia
Failas kataloge /.well-known/, kurio ieško agentai (agento kortelė, MCP aprašas, API katalogas ar UCP profilis), atsako, bet ne galiojančiu JSON arba be reikiamų laukų. Jį radę agentai tuo ir sustoja. Ištaisykite failą arba jį pašalinkite.
Kodėl tai svarbu DI paieškai
Šie failai agentams nurodo, ką svetainė siūlo: agentą pokalbiui, MCP serverį, API, pirkimo būdą. Agentas, radęs tokį failą ir negalintis jo išanalizuoti, pasiduoda, o ne spėlioja.
Daugumai svetainių nė vieno iš jų nereikia, todėl apie trūkstamą failą niekada nepranešama. Esantis, bet sugadintas failas dažniausiai lieka po bandymo, šablono ar įskiepio, kuris buvo nustatytas ir pamirštas.
Kaip tai ištaisyti
- Atidarykite kiekvieną failą iš įrodymų ir patikrinkite jį JSON validatoriumi.
- Ištaisykite sintaksę ir pridėkite privalomus laukus pagal failo specifikaciją.
- Pateikite jį su
Content-Type: application/json(API kataloguiapplication/linkset+json). - Jei svetainė nesiūlo to, ką aprašo failas, ištrinkite failą. Puslapio ataskaitoje paspauskite „Patikrinti dar kartą“, kad patvirtintumėte rezultatą.
Pavyzdys
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Kaip įsitikinti, kad pataisymas suveikė
Atlikę pakeitimą, ataskaitoje paspauskite „Patikrinti dar kartą“: matysite, kas ištaisyta ir kaip pasikeitė balas.