Súbor na objavovanie pre agentov sa nedá prečítať

Krátka odpoveď

Súbor, ktorý agenti hľadajú v /.well-known/, odpovedá, ale nedá sa prečítať: agent-card.json (karta agenta A2A), mcp.json (deskriptor servera MCP), api-catalog (RFC 9727) alebo pri e-shopoch ucp. Nie je to platný JSON alebo mu chýba povinné pole, napríklad name karty agenta alebo linkset katalógu API.

agent.discovery_invalid · Priorita: P2

Čo to znamená

Súbor v /.well-known/, ktorý agenti hľadajú (karta agenta, deskriptor MCP, katalóg API alebo profil UCP), odpovedá, ale nie platným JSON alebo bez polí, ktoré potrebuje. Agenti, ktorí ho nájdu, tam skončia. Súbor opravte alebo odstráňte.

Prečo je to dôležité pre AI vyhľadávanie

Tieto súbory hovoria agentom, čo web ponúka: agenta, s ktorým sa dá hovoriť, server MCP, API, spôsob nákupu. Agent, ktorý taký súbor nájde a nedokáže ho spracovať, to vzdá namiesto hádania.

Väčšina webov nepotrebuje ani jeden z nich, takže chýbajúci súbor sa nikdy nehlási. Súbor, ktorý existuje, ale je pokazený, zvyčajne pochádza z testu, šablóny alebo pluginu, ktorý niekto nastavil a zabudol naň.

Ako to opraviť

  1. Otvorte každý súbor z dôkazov a prejdite ho validátorom JSON.
  2. Opravte syntax a doplňte povinné polia podľa špecifikácie daného súboru.
  3. Servírujte ho s Content-Type: application/json (pri katalógu API application/linkset+json).
  4. Ak web neponúka to, čo súbor opisuje, súbor zmažte. V správe o stránke spustite „Skontrolovať znova“ a overte výsledok.

Príklad

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

Ako overiť opravu

Po zmene stlačte v správe „Skontrolovať znova“: uvedie, čo sa opravilo a ako sa zmenilo skóre.

Skontrolovať moju stránku →

Súvisiace návody

Všetky zistenia a ako funguje skóre