M365Con 2027 – conferenza online gratuita · 11–22 Jan 2027 · 120 sessions m365con.net

Agent card

Concetto

Nel protocollo A2A, un agent card è un documento leggibile dalle macchine, pubblicato in un URL well-known, che descrive il nome di un agente, le sue capacità, le skill, l'endpoint, i requisiti di autenticazione e i formati di input/output, così che altri agenti possano scoprirlo.

✦ CONCETTOAgent cardM365.FM
Immagine del titolo: Agent card (Concetto)

Trattati anche

Gli episodi su Agent card parlano anche di Microsoft Purview Information Barriers, Context window, Front matter, Agent kill switch, AI red teaming e AI Center of Excellence.

Descrizione

Un agent card è un documento leggibile dalle macchine, utilizzato nel protocollo Agent2Agent (A2A) per descrivere un agente. Viene pubblicato a un URL well-known e contiene metadati come il nome dell'agente, la descrizione, la versione, le funzionalità, le competenze, l'endpoint, i requisiti di autenticazione e i formati di input e output supportati. Il suo scopo principale è la scoperta: un client o un altro agente può leggere la card per capire cosa offre un agente prima di inviargli una qualsiasi richiesta.

Il protocollo A2A affronta l'interoperabilità tra agenti puntando su un linguaggio standardizzato, che elimina la necessità di codice personalizzato in ogni interazione tra agenti. L'agent card è la parte di questo approccio che permette a un agente di pubblicizzare la propria identità e le proprie capacità. Invece di presupporre in modo rigido informazioni su un agente remoto, un agente chiamante legge la card pubblicata e determina come raggiungere l'agente e quali tipi di dati può scambiare.

La pagina di Microsoft Learn dedicata all'hosting A2A in Microsoft Agent Framework mostra come questo funzioni nella pratica. Nell'esempio di hosting con ASP.NET Core, la card è servita a un percorso well-known che termina con agent-card.json. Il metodo di mappatura che espone la card proviene dal pacchetto A2A SDK e non dai pacchetti di hosting di Agent Framework. La card di esempio imposta un nome, una descrizione e una versione, le modalità predefinite di input e output e un'interfaccia supportata che include un URL, un protocol binding e una versione del protocollo. La pagina consiglia di compilare completamente la card per l'uso in produzione, in modo che i client ricevano informazioni complete sull'agente che stanno per chiamare.

Un limite pratico descritto nella documentazione riguarda l'hosting. Un singolo host può pubblicare una sola agent card nel percorso well-known, il che significa che in quel punto è individuabile un solo agente. Gli altri agenti ospitati insieme restano raggiungibili tramite i propri URL, ma i client devono già conoscere questi endpoint, poiché la posizione well-known condivisa non li elenca. Nella pianificazione di una distribuzione con più agenti, questo aspetto incide su come viene progettata la scoperta e su come le informazioni sugli endpoint vengono condivise con i consumatori. La pagina della documentazione non tratta competenze, dettagli di autenticazione o firme della card, quindi questi aspetti sono qui descritti solo a livello della definizione generale.

L'episodio "Agent-to-Agent (A2A) Communication - Simply Explained" affronta il concetto nell'ambito di una discussione più ampia sull'interoperabilità. Presenta l'agent card come il meccanismo attraverso cui gli agenti pubblicizzano la propria identità e le proprie capacità, rendendo più semplici la scoperta e l'interazione. Lo stesso episodio collega questo tema alla comunicazione strutturata, in cui gli agenti scambiano diversi tipi di dati, il che favorisce la collaborazione e il monitoraggio dello stato delle attività. Sottolinea inoltre che privacy e sicurezza sono al centro della comunicazione tra agenti e che chiunque lavori con questi sistemi deve essere consapevole dei rischi legati alla gestione dei dati. Poiché un agent card pubblica informazioni su un agente e su come raggiungerlo, decidere cosa includere e come controllare l'accesso fa parte di questa più ampia considerazione di sicurezza.

In sintesi, l'agent card funziona come descrizione pubblica di un agente A2A. Viene letta dai client prima dell'invio di qualsiasi attività, è servita da una posizione prevedibile e, in produzione, deve essere completa e accurata. Il vincolo di una sola card per percorso well-known, nell'esempio di hosting con ASP.NET Core, è un aspetto progettuale da considerare ogni volta che più di un agente viene esposto dallo stesso host.

Panoramica compilata con l'AI dagli episodi di M365.FM e dai dati di questa pagina. Puoi migliorarla con il pulsante di modifica qui sotto.

TipoConcetto
TipoFormat

Domande frequenti

Le domande contrassegnate con AI sono state scritte con l'AI a partire dai fatti riportati in questa pagina.

Che cos'è un agent card nel protocollo A2A? (AI)

È un documento leggibile dalle macchine, pubblicato a un URL well-known, che descrive nome, funzionalità, competenze, endpoint, requisiti di autenticazione e formati di input/output di un agente, così che altri agenti possano scoprirlo.

Dove viene servito l'agent card nell'esempio di Microsoft Agent Framework? (AI)

Nell'esempio di hosting con ASP.NET Core è servita a un percorso well-known che termina con agent-card.json, usando un metodo di mappatura del pacchetto A2A SDK e non dei pacchetti di hosting di Agent Framework.

Un host può pubblicare più agent card? (AI)

Secondo la pagina di Microsoft Learn, un singolo host può pubblicare una sola agent card nel percorso well-known, quindi in quel punto è individuabile un solo agente; gli altri restano raggiungibili tramite i propri URL, che i client devono già conoscere.

Glossario

Community wiki

Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.

Esperti e aziende per questo argomento

Nessuno ha ancora indicato questo argomento. Aggiungilo al tuo profilo.

Mantenuto da Mirko Peters (Microsoft MVP) · Ultimo aggiornamento: