Файл за откриване от агенти не може да се прочете

Кратък отговор

Файл в /.well-known/, който агентите търсят, отговаря, но не може да се прочете: agent-card.json (карта на A2A агент), mcp.json (дескриптор на MCP сървър), api-catalog (RFC 9727) или, при магазините, ucp. Той не е валиден JSON или му липсва задължително поле, например name в картата на агента или linkset в каталога на API.

agent.discovery_invalid · Приоритет: P2

Какво означава

Файл в /.well-known/, който агентите търсят (картата на агента, дескрипторът на MCP, каталогът на API или профилът на UCP), отговаря, но не с валиден JSON или без нужните полета. Агентите, които го намерят, спират дотам. Поправете файла или го премахнете.

Защо това е важно за AI търсенето

Тези файлове казват на агентите какво предлага сайтът: агент за разговор, MCP сървър, API, начин за покупка. Агент, който намери такъв файл и не може да го разчете, се отказва, вместо да гадае.

Повечето сайтове нямат нужда от нито един от тях, затова липсващ файл никога не се отчита. Файл, който съществува, но е счупен, обикновено идва от тест, шаблон или плъгин, който е настроен и забравен.

Как да го поправите

  1. Отворете всеки файл от доказателствата и го проверете с JSON валидатор.
  2. Поправете синтаксиса и добавете задължителните полета според спецификацията на файла.
  3. Обслужвайте го с Content-Type: application/json (application/linkset+json за каталога на API).
  4. Ако сайтът не предлага това, което файлът описва, изтрийте файла. Натиснете „Проверете отново“ в отчета за страницата, за да потвърдите резултата.

Пример

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

Как да потвърдите корекцията

След промяната натиснете „Проверете отново“ в отчета: той показва какво е поправено и как се е променила оценката.

Проверете страницата ми →

Свързани ръководства

Всички находки и как работи оценката