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

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

Фајл у /.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": []
}

Како потврдити исправку

После измене притисните „Провери поново” у извештају: видећете шта је исправљено и како се оцена променила.

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

Сродни водичи

Сви налази и како функционише оцена