Un fișier de descoperire pentru agenți nu poate fi citit
Un fișier pe care agenții îl caută în /.well-known/ răspunde, dar nu poate fi citit: agent-card.json (un card de agent A2A), mcp.json (un descriptor de server MCP), api-catalog (RFC 9727) sau, la magazine, ucp. Nu este JSON valid sau îi lipsește un câmp necesar, cum ar fi name din cardul agentului sau linkset din catalogul API.
Ce înseamnă
Un fișier din /.well-known/ pe care îl caută agenții (cardul agentului, descriptorul MCP, catalogul API sau profilul UCP) răspunde, dar nu cu JSON valid sau fără câmpurile necesare. Agenții care îl găsesc se opresc acolo. Corectați fișierul sau eliminați-l.
De ce contează pentru căutarea AI
Aceste fișiere le spun agenților ce oferă un site: un agent cu care pot vorbi, un server MCP, un API, o modalitate de a cumpăra. Un agent care găsește unul și nu îl poate interpreta renunță în loc să ghicească.
Majoritatea site-urilor nu au nevoie de niciunul, așa că un fișier lipsă nu este raportat niciodată. Un fișier care există, dar e stricat, rămâne de obicei de la un test, un șablon sau un plugin configurat și apoi uitat.
Cum se remediază
- Deschide fiecare fișier din dovezi și trece-l printr-un validator JSON.
- Corectează sintaxa și adaugă câmpurile obligatorii, după specificația fișierului.
- Servește-l cu
Content-Type: application/json(application/linkset+jsonpentru catalogul API). - Dacă site-ul nu oferă ceea ce descrie fișierul, șterge fișierul. Rulează „Verifică din nou” în raportul paginii ca să confirmi rezultatul.
Exemplu
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} Cum confirmi remediul
După modificare, apasă „Verifică din nou” în raport: vezi ce s-a remediat și cum s-a schimbat scorul.