Un file di discovery per agenti non è leggibile

Risposta breve

Un file che gli agenti cercano sotto /.well-known/ risponde, ma non è leggibile: agent-card.json (una agent card A2A), mcp.json (un descrittore di server MCP), api-catalog (RFC 9727) o, nei negozi, ucp. Non è JSON valido, oppure manca un campo obbligatorio, come il name dell'agent card o il linkset del catalogo API.

agent.discovery_invalid · Priorità: P2

Cosa significa

Un file sotto /.well-known/ che gli agenti cercano (l'agent card, il descrittore MCP, il catalogo API o il profilo UCP) risponde, ma non con JSON valido o senza i campi necessari. Gli agenti che lo trovano si fermano lì. Correggi il file o rimuovilo.

Perché conta per la ricerca AI

Questi file dicono agli agenti cosa offre un sito: un agente con cui parlare, un server MCP, un'API, un modo per comprare. Un agente che ne trova uno e non riesce a interpretarlo rinuncia invece di tirare a indovinare.

Alla maggior parte dei siti non ne serve nessuno, quindi un file mancante non viene mai segnalato. Un file presente ma rotto di solito viene da un test, da un template o da un plugin configurato e poi dimenticato.

Come risolvere

  1. Apri ogni file indicato nelle prove e passalo in un validatore JSON.
  2. Correggi la sintassi e aggiungi i campi obbligatori, seguendo la specifica propria del file.
  3. Servilo con Content-Type: application/json (application/linkset+json per il catalogo API).
  4. Se il sito non offre ciò che il file descrive, elimina il file. Esegui «Ricontrolla» sul report della pagina per confermare il risultato.

Esempio

{
  "name": "Example support agent",
  "description": "Answers questions about orders",
  "url": "https://example.com/a2a",
  "version": "1.0.0",
  "skills": []
}

Come confermare la correzione

Dopo la modifica, premi «Ricontrolla» nel report: mostra cosa è stato risolto e come è cambiato il punteggio.

Controlla la mia pagina →

Guide correlate

Tutti i riscontri e come funziona il punteggio