Soubor pro objevování agenty nelze přečíst
Soubor, který agenti hledají v /.well-known/, odpovídá, ale nelze ho přečíst: agent-card.json (karta agenta A2A), mcp.json (deskriptor serveru MCP), api-catalog (RFC 9727) nebo u e-shopů ucp. Není to platný JSON, nebo mu chybí povinné pole, například name karty agenta nebo linkset katalogu API.
Co to znamená
Soubor v /.well-known/, který agenti hledají (karta agenta, deskriptor MCP, katalog API nebo profil UCP), odpovídá, ale ne platným JSON, nebo bez polí, která potřebuje. Agenti, kteří ho najdou, tím skončí. Soubor opravte, nebo odstraňte.
Proč na tom záleží pro AI vyhledávání
Tyto soubory agentům říkají, co web nabízí: agenta, se kterým lze mluvit, server MCP, API, způsob nákupu. Agent, který takový soubor najde a nedokáže ho zpracovat, to vzdá, místo aby hádal.
Většina webů nepotřebuje žádný z nich, takže chybějící soubor se nikdy nehlásí. Soubor, který existuje, ale je rozbitý, obvykle pochází z testu, šablony nebo pluginu, který někdo nastavil a zapomněl na něj.
Jak to opravit
- Otevřete každý soubor z důkazů a projděte ho validátorem JSON.
- Opravte syntaxi a doplňte povinná pole podle specifikace daného souboru.
- Podávejte ho s
Content-Type: application/json(u katalogu APIapplication/linkset+json). - Pokud web nenabízí to, co soubor popisuje, soubor smažte. Na reportu stránky spusťte „Zkontrolovat znovu“ a ověřte výsledek.
Příklad
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Jak ověřit opravu
Po změně klikněte ve zprávě na „Zkontrolovat znovu“: uvidíte, co bylo opraveno a jak se změnilo skóre.