Датотека за откривање агенти не може да се прочита
Датотека во /.well-known/ што ја бараат агентите одговара, но не може да се прочита: agent-card.json (A2A картичка на агент), mcp.json (дескриптор на MCP сервер), api-catalog (RFC 9727) или, кај продавниците, ucp. Не е валиден JSON или ѝ недостасува потребно поле, како name во картичката на агентот или linkset во каталогот на API.
Што значи
Датотека во /.well-known/ што ја бараат агентите (картичката на агентот, MCP дескрипторот, каталогот на API или UCP профилот) одговара, но не со валиден JSON или без полињата што ѝ се потребни. Агентите што ќе ја најдат застануваат таму. Поправете ја датотеката или отстранете ја.
Зошто е важно за AI пребарувањето
Овие датотеки им кажуваат на агентите што нуди сајтот: агент за разговор, MCP сервер, API, начин за купување. Агент што ќе најде таква датотека и не може да ја разбере се откажува наместо да погодува.
На повеќето сајтови не им треба ниту една од нив, па датотека што недостасува никогаш не се пријавува. Датотека што постои, но е скршена, обично доаѓа од тест, шаблон или приклучок што е поставен и заборавен.
Како да се поправи
- Отворете ја секоја датотека од доказите и проверете ја со JSON валидатор.
- Поправете ја синтаксата и додајте ги задолжителните полиња според спецификацијата на датотеката.
- Сервирајте ја со
Content-Type: application/json(application/linkset+jsonза каталогот на API). - Ако сајтот не го нуди она што го опишува датотеката, избришете ја датотеката. Кликнете „Провери повторно“ во извештајот за страницата за да го потврдите резултатот.
Пример
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Како да се потврди поправката
По промената притиснете „Провери повторно“ во извештајот: ќе видите што е поправено и како се променила оцената.