Файл обнаружения для агентов не читается
Файл в /.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": []
} Как проверить исправление
После изменения нажмите «Проверить ещё раз» в отчёте: он покажет, что исправлено и как изменилась оценка.