Datoteka za otkrivanje agenata ne može se pročitati
Datoteka koju agenti traže u /.well-known/ odgovara, ali se ne može pročitati: agent-card.json (A2A kartica agenta), mcp.json (deskriptor MCP poslužitelja), api-catalog (RFC 9727) ili, kod trgovina, ucp. Nije valjan JSON ili joj nedostaje obavezno polje, poput name kartice agenta ili linkset API kataloga.
Što to znači
Datoteka u /.well-known/ koju agenti traže (kartica agenta, MCP deskriptor, API katalog ili UCP profil) odgovara, ali ne valjanim JSON-om ili bez polja koja su joj potrebna. Agenti koji je pronađu tu stanu. Popravite datoteku ili je uklonite.
Zašto je to važno za AI pretraživanje
Te datoteke agentima govore što web-stranica nudi: agenta za razgovor, MCP poslužitelj, API, način kupnje. Agent koji pronađe takvu datoteku i ne može je raščlaniti odustaje umjesto da nagađa.
Većini web-stranica ne treba nijedna od njih, pa se datoteka koja nedostaje nikad ne prijavljuje. Datoteka koja postoji, ali je neispravna, obično potječe iz testa, predloška ili dodatka koji je netko postavio i zaboravio.
Kako to ispraviti
- Otvorite svaku datoteku iz dokaza i provjerite je JSON validatorom.
- Ispravite sintaksu i dodajte obavezna polja prema specifikaciji te datoteke.
- Poslužujte je s
Content-Type: application/json(application/linkset+jsonza API katalog). - Ako web-stranica ne nudi ono što datoteka opisuje, izbrišite datoteku. Pokrenite „Provjeri ponovno“ u izvješću o stranici da potvrdite rezultat.
Primjer
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Kako potvrditi ispravak
Nakon promjene u izvještaju pritisnite „Provjeri ponovno”: navest će što je ispravljeno i kako se ocjena promijenila.