Файл виявлення для агентів не читається
Файл у /.well-known/, який шукають агенти, відповідає, але не читається: agent-card.json (картка агента A2A), mcp.json (дескриптор сервера MCP), api-catalog (RFC 9727) або, у магазинів, ucp. Це невалідний JSON, або в ньому немає обов'язкового поля, наприклад name у картці агента чи linkset у каталозі API.
Що це означає
Файл у /.well-known/, який шукають агенти (картка агента, дескриптор MCP, каталог API або профіль UCP), відповідає, але не валідним JSON або без потрібних полів. Агенти, які його знаходять, на цьому зупиняються. Виправте файл або видаліть його.
Чому це важливо для ШІ-пошуку
Ці файли повідомляють агентам, що пропонує сайт: агента для спілкування, сервер 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": []
} Як перевірити виправлення
Після зміни натисніть «Перевірити ще раз» у звіті: він покаже, що виправлено і як змінилася оцінка.