Një skedar zbulimi për agjentët nuk mund të lexohet
Një skedar që agjentët e kërkojnë nën /.well-known/ përgjigjet, por nuk mund të lexohet: agent-card.json (një agent card A2A), mcp.json (një përshkrues serveri MCP), api-catalog (RFC 9727) ose, te dyqanet, ucp. Nuk është JSON i vlefshëm, ose i mungon një fushë që i duhet, si name i agent card ose linkset i katalogut API.
Çfarë do të thotë
Një skedar nën /.well-known/ që e kërkojnë agjentët (agent card, përshkruesi MCP, katalogu API ose profili UCP) përgjigjet, por jo me JSON të vlefshëm ose pa fushat që i duhen. Agjentët që e gjejnë ndalen aty. Rregulloni skedarin ose hiqeni.
Pse ka rëndësi për kërkimin me AI
Këta skedarë u tregojnë agjentëve çfarë ofron një sajt: një agjent për të biseduar, një server MCP, një API, një mënyrë për të blerë. Një agjent që gjen një të tillë dhe nuk e analizon dot heq dorë në vend që të hamendësojë.
Shumica e sajteve nuk kanë nevojë për asnjë prej tyre, ndaj një skedar që mungon nuk raportohet kurrë. Një skedar që ekziston, por është i prishur, vjen zakonisht nga një test, një shabllon ose një shtojcë që u konfigurua dhe u harrua.
Si ta rregulloni
- Hapni çdo skedar nga provat dhe kalojeni nëpër një validues JSON.
- Rregulloni sintaksën dhe shtoni fushat e detyrueshme, sipas specifikimit të vetë skedarit.
- Shërbejeni me
Content-Type: application/json(application/linkset+jsonpër katalogun API). - Nëse sajti nuk ofron atë që përshkruan skedari, fshijeni skedarin. Klikoni "Kontrollo sërish" në raportin e faqes për ta konfirmuar rezultatin.
Shembull
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Si ta konfirmoni rregullimin
Pas ndryshimit, shtypni "Kontrollo sërish" në raport: ai rendit çfarë u rregullua dhe si ndryshoi rezultati.