Súbor na objavovanie pre agentov sa nedá prečítať
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.
Č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ť
- Otvorte každý súbor z dôkazov a prejdite ho validátorom JSON.
- Opravte syntax a doplňte povinné polia podľa špecifikácie daného súboru.
- Servírujte ho s
Content-Type: application/json(pri katalógu APIapplication/linkset+json). - 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.