AgentCard

AgentCard trasmette informazioni chiave su un agente remoto. Si tratta di una versione ridotta di AgentCard definita nel protocollo A2A https://a2a-protocol.org/dev/specification/#441-agentcard

Rappresentazione JSON 
{
  "name": string,
  "description": string,
  "supportedInterfaces": [
    {
      object (AgentInterface)
    }
  ],
  "version": string,
  "skills": [
    {
      object (AgentSkill)
    }
  ]
}
Campi
name

string

Obbligatorio. Un nome leggibile per l'agente.
description

string

Obbligatorio. Una descrizione del dominio di azione/spazio di soluzioni dell'agente.
supportedInterfaces[]

object (AgentInterface)

Obbligatorio. Elenco ordinato delle interfacce supportate. Viene preferita la prima voce.
version

string

Obbligatorio. La versione dell'agente.
skills[]

object (AgentSkill)

Obbligatorio. Le skill rappresentano un'unità di capacità che un agente può eseguire. Potrebbe sembrare un po' astratto, ma rappresenta un insieme più mirato di azioni che l'agente ha molte probabilità di portare a termine.

AgentInterface

Dichiara una combinazione di un URL di destinazione, un trasporto e una versione del protocollo per interagire con l'agente. Ciò consente agli agenti di esporre la stessa funzionalità su più meccanismi di associazione del protocollo.

Rappresentazione JSON 
{
  "url": string,
  "protocolBinding": string,
  "tenant": string,
  "protocolVersion": string
}
Campi
url

string

Obbligatorio. L'URL in cui è disponibile questa interfaccia. Deve essere un URL HTTPS assoluto valido in produzione. Esempio: "https://api.example.com/a2a/v1", "https://grpc.example.com/a2a"
protocolBinding

string

Obbligatorio. L'associazione del protocollo supportata in questo URL. Si tratta di una stringa di formato aperto, facilmente estendibile per altri binding di protocollo. Quelli principali supportati ufficialmente sono JSONRPC, GRPC e HTTP+JSON.
tenant

string

ID tenant da utilizzare nella richiesta quando chiami l'agente.
protocolVersion

string

Obbligatorio. La versione del protocollo A2A esposta da questa interfaccia. Utilizza l'ultima versione secondaria supportata per ogni versione principale. Esempi: "0.3", "1.0"

AgentSkill

Rappresenta una funzionalità o una funzione distinta che un agente può eseguire.

Rappresentazione JSON 
{
  "id": string,
  "name": string,
  "description": string,
  "tags": [
    string
  ],
  "examples": [
    string
  ],
  "inputModes": [
    string
  ],
  "outputModes": [
    string
  ]
}
Campi
id

string

Obbligatorio. Un identificatore univoco per la competenza dell'agente.
name

string

Obbligatorio. Un nome leggibile per la competenza.
description

string

Obbligatorio. Una descrizione dettagliata della skill.
tags[]

string

Obbligatorio. Un insieme di parole chiave che descrivono le funzionalità della skill.
examples[]

string

Esempi di prompt o scenari che questa skill può gestire.
inputModes[]

string

L'insieme dei tipi di media di input supportati per questa skill, che sostituiscono i valori predefiniti dell'agente.
outputModes[]

string

Il set di tipi di media di output supportati per questa skill, che sostituisce i valori predefiniti dell'agente.