Një skedar zbulimi për agjentët nuk mund të lexohet

Përgjigje e shkurtër

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.

agent.discovery_invalid · Prioriteti: P2

Ç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

  1. Hapni çdo skedar nga provat dhe kalojeni nëpër një validues JSON.
  2. Rregulloni sintaksën dhe shtoni fushat e detyrueshme, sipas specifikimit të vetë skedarit.
  3. Shërbejeni me Content-Type: application/json (application/linkset+json për katalogun API).
  4. 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.

Kontrollo faqen time →

Udhëzues të ngjashëm

Të gjitha gjetjet dhe si funksionon rezultati