Файл за откриване от агенти не може да се прочете
Файл в /.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": []
} Как да потвърдите корекцията
След промяната натиснете „Проверете отново“ в отчета: той показва какво е поправено и как се е променила оценката.