Come funziona agent-card.json
Il file agent-card.json è un manifest che identifica un'organizzazione agli agenti AI conversazionali (Claude, Cursor, Vercel AI SDK, Anthropic Computer Use). Si posiziona nella cartella standard /.well-known/ del dominio (es. www.esempio.com/.well-known/agent-card.json) seguendo la stessa convenzione di OAuth, OpenID Connect e altri protocolli web.
Il file dichiara: identità dell'organizzazione (nome, descrizione, logo), capabilities supportate (MCP server, A2A protocol, UCP commerce), risorse di conoscenza disponibili (URL di llms.txt, sitemap, ai-knowledge.json), preferred actions per gli agent (intent supportati, endpoint preferiti per ogni azione), profili esterni verificati. È pensato per agenti AI autonomi che devono interagire con il sito senza supervisione umana.
Importante: agent-card.json va dichiarato solo se l'organizzazione effettivamente supporta protocolli agent. Dichiarare capability inesistenti (es. un MCP server fittizio) genera errori di connessione e riduce la fiducia degli agent. Il file complementa llms.txt: il primo è per crawler che leggono contenuti, il secondo per agent che eseguono azioni.
Esempio pratico
Il file agent-card.json di Immagina Group dichiara: identità completa con VAT IT17146551001 e Wikidata ID, 7 risorse di conoscenza linkate (llms.txt, llms-full.txt, entities.txt, citations.txt, brand.txt, ai-knowledge.json, sitemap.xml), 6 preferred_actions_for_ai_agents (find_service_information, find_local_service, request_consultation, ecc.), capabilities trasparenti (no MCP server, no UCP commerce, supporta human handoff).
Implementa il tuo agent-card.json
Immagina Group struttura manifest /.well-known/ completi per la massima compatibilità con agent AI moderni. Scopri il servizio AIO o richiedi un audit.
Termini correlati
Vuoi approfondire agent-card.json?
Immagina Group offre consulenza specializzata. Richiedi un'analisi gratuita.
Scopri il servizio →