Package lf.a2a.v1

Index

A2AService

Fournit des opérations permettant d'interagir avec les agents à l'aide du protocole A2A.

CancelTask

rpc CancelTask(CancelTaskRequest) returns (Task)

Annule une tâche en cours.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Pour plus d'informations, consultez la Authentication Overview.

CreateTaskPushNotificationConfig

rpc CreateTaskPushNotificationConfig(TaskPushNotificationConfig) returns (TaskPushNotificationConfig)

Crée une configuration de notification push pour une tâche.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Pour plus d'informations, consultez la Authentication Overview.

DeleteTaskPushNotificationConfig

rpc DeleteTaskPushNotificationConfig(DeleteTaskPushNotificationConfigRequest) returns (Empty)

Supprime une configuration de notification push pour une tâche.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Pour plus d'informations, consultez la Authentication Overview.

GetExtendedAgentCard

rpc GetExtendedAgentCard(GetExtendedAgentCardRequest) returns (AgentCard)

Récupère la fiche d'agent étendue pour l'agent authentifié.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Pour plus d'informations, consultez la Authentication Overview.

GetTask

rpc GetTask(GetTaskRequest) returns (Task)

Récupère le dernier état d'une tâche.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Pour plus d'informations, consultez la Authentication Overview.

GetTaskPushNotificationConfig

rpc GetTaskPushNotificationConfig(GetTaskPushNotificationConfigRequest) returns (TaskPushNotificationConfig)

Obtient une configuration de notification push pour une tâche.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Pour plus d'informations, consultez la Authentication Overview.

ListTaskPushNotificationConfigs

rpc ListTaskPushNotificationConfigs(ListTaskPushNotificationConfigsRequest) returns (ListTaskPushNotificationConfigsResponse)

Obtenez la liste des notifications push configurées pour une tâche.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Pour plus d'informations, consultez la Authentication Overview.

ListTasks

rpc ListTasks(ListTasksRequest) returns (ListTasksResponse)

Répertorie les tâches qui correspondent au filtre spécifié.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Pour plus d'informations, consultez la Authentication Overview.

SendMessage

rpc SendMessage(SendMessageRequest) returns (SendMessageResponse)

Envoie un message à un agent.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Pour plus d'informations, consultez la Authentication Overview.

SendStreamingMessage

rpc SendStreamingMessage(SendMessageRequest) returns (StreamResponse)

Envoie un message en flux continu à un agent, ce qui permet une interaction et des mises à jour de l'état en temps réel. Version en streaming de SendMessage

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Pour plus d'informations, consultez la Authentication Overview.

SubscribeToTask

rpc SubscribeToTask(SubscribeToTaskRequest) returns (StreamResponse)

S'abonne aux mises à jour des tâches qui ne sont pas dans un état final. Renvoie UnsupportedOperationError si la tâche est déjà dans un état final (terminée, échouée, annulée, refusée).

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Pour plus d'informations, consultez la Authentication Overview.

APIKeySecurityScheme

Définit un schéma de sécurité à l'aide d'une clé API.

Champs
description

string

Description facultative du schéma de sécurité.

location

string

Obligatoire. Emplacement de la clé API. Les valeurs valides sont "query", "header" ou "cookie".

name

string

Obligatoire. Nom du paramètre d'en-tête, de requête ou de cookie à utiliser.

AgentCapabilities

Définit les fonctionnalités facultatives prises en charge par un agent.

Champs
extensions[]

AgentExtension

Liste des extensions de protocole compatibles avec l'agent.

streaming

bool

Indique si l'agent accepte les réponses en streaming.

push_notifications

bool

Indique si l'agent est compatible avec l'envoi de notifications push pour les mises à jour des tâches asynchrones.

extended_agent_card

bool

Indique si l'agent est compatible avec la fourniture d'une fiche d'agent étendue lorsqu'il est authentifié.

AgentCard

Manifeste auto-descriptif pour un agent. Il fournit des métadonnées essentielles, y compris l'identité, les capacités, les compétences, les méthodes de communication prises en charge et les exigences de sécurité de l'agent. Identifiant suivant : 20

Champs
name

string

Obligatoire. Nom de l'agent lisible par l'humain. Exemple : "Agent de recettes"

description

string

Obligatoire. Description de l'agent lisible par l'humain, qui aide les utilisateurs et les autres agents à comprendre son objectif. Exemple : "Agent qui aide les utilisateurs avec des recettes et la cuisine."

supported_interfaces[]

AgentInterface

Obligatoire. Liste ordonnée des interfaces compatibles. La première entrée est privilégiée.

provider

AgentProvider

Fournisseur de services de l'agent.

version

string

Obligatoire. Version de l'agent. Exemple : "1.0.0"

capabilities

AgentCapabilities

Obligatoire. Ensemble de fonctionnalités A2A compatibles avec l'agent.

security_schemes

map<string, SecurityScheme>

Informations sur le schéma de sécurité utilisé pour l'authentification auprès de cet agent.

security_requirements[]

SecurityRequirement

Exigences de sécurité pour contacter l'agent.

default_input_modes[]

string

Obligatoire. protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Ensemble des modes d'interaction pris en charge par l'agent pour toutes les compétences. Cette valeur peut être remplacée pour chaque skill. Définis comme des types de contenus.

default_output_modes[]

string

Obligatoire. Types de contenus multimédias acceptés en tant que sorties de cet agent.

skills[]

AgentSkill

Obligatoire. Les compétences représentent les capacités d'un agent. Il s'agit en grande partie d'un concept descriptif, mais il représente un ensemble plus ciblé de comportements dans lesquels l'agent est susceptible de réussir.

signatures[]

AgentCardSignature

Signatures Web JSON calculées pour ce AgentCard.

documentation_url

string

URL fournissant de la documentation supplémentaire sur l'agent.

icon_url

string

Facultatif. URL d'une icône pour l'agent.

AgentCardSignature

AgentCardSignature représente une signature JWS d'une AgentCard. Il s'agit du format JSON d'une signature Web JSON (JWS) RFC 7515.

Champs
protected

string

Obligatoire. Obligatoire. En-tête JWS protégé pour la signature. Il s'agit toujours d'un objet JSON encodé en base64url.

signature

string

Obligatoire. Signature calculée, encodée en base64url.

header

Struct

Valeurs d'en-tête JWS non protégées.

AgentExtension

Déclaration d'une extension de protocole prise en charge par un agent.

Champs
uri

string

URI unique identifiant l'extension.

description

string

Description lisible de la façon dont cet agent utilise l'extension.

required

bool

Si la valeur est "true", le client doit comprendre et respecter les exigences de l'extension.

params

Struct

Facultatif. Paramètres de configuration spécifiques à l'extension.

AgentInterface

Déclare une combinaison d'URL cible, de transport et de version de protocole pour interagir avec l'agent. Cela permet aux agents d'exposer la même fonctionnalité sur plusieurs mécanismes de liaison de protocole.

Champs
url

string

Obligatoire. URL où cette interface est disponible. Vous devez saisir une URL HTTPS absolue valide en production. Exemple : "https://api.example.com/a2a/v1", "https://grpc.example.com/a2a"

protocol_binding

string

Obligatoire. L'association de protocole acceptée à cette URL. Il s'agit d'une chaîne de formulaire ouverte, qui peut être facilement étendue à d'autres liaisons de protocole. Les principaux officiellement acceptés sont JSONRPC, GRPC et HTTP+JSON.

tenant

string

Facultatif. Chaîne opaque utilisée pour acheminer les requêtes vers un agent ou un locataire spécifique lorsque plusieurs agents sont diffusés derrière un même point de terminaison A2A. Lorsqu'elle est définie, les clients DOIVENT inclure cette valeur dans le champ tenant de tous les messages de requête envoyés à cette interface. Le serveur est responsable de l'interprétation de la valeur et de l'acheminement des requêtes en conséquence. Le protocole ne définit pas son format ni sa sémantique.

protocol_version

string

Obligatoire. Version du protocole A2A que cette interface expose. Utilisez la dernière version mineure compatible pour chaque version majeure. Exemples : "0.3", "1.0"

AgentProvider

Représente le fournisseur de services d'un agent.

Champs
url

string

Obligatoire. URL du site Web du fournisseur de l'agent ou de la documentation pertinente. Exemple : "https://ai.google.dev"

organization

string

Obligatoire. Nom de l'organisation du fournisseur d'agents. Exemple : "Google"

AgentSkill

Représente une capacité ou une fonction distincte qu'un agent peut effectuer.

Champs
id

string

Obligatoire. Identifiant unique de la compétence de l'agent.

name

string

Obligatoire. Nom lisible de la compétence.

description

string

Obligatoire. Description détaillée de la compétence.

tags[]

string

Obligatoire. Ensemble de mots clés décrivant les capacités de la compétence.

examples[]

string

Exemples de requêtes ou de scénarios que cette compétence peut traiter.

input_modes[]

string

Ensemble de types de supports d'entrée acceptés pour cette compétence, qui remplace les valeurs par défaut de l'agent.

output_modes[]

string

Ensemble de types de supports de sortie acceptés pour cette compétence, qui remplace les valeurs par défaut de l'agent.

security_requirements[]

SecurityRequirement

Schémas de sécurité nécessaires pour cette compétence.

Artefact

Les artefacts représentent les sorties des tâches.

Champs
artifact_id

string

Obligatoire. Identifiant unique (par exemple, UUID) de l'artefact. Il doit être unique dans une tâche.

name

string

Nom lisible de l'artefact.

description

string

Facultatif. Description de l'artefact lisible par l'humain.

parts[]

Part

Obligatoire. Contenu de l'artefact. Doit contenir au moins une partie.

metadata

Struct

Facultatif. Métadonnées incluses avec l'artefact.

extensions[]

string

URI des extensions présentes dans cet artefact ou ayant contribué à sa création.

AuthenticationInfo

Définit les informations d'authentification utilisées pour les notifications push.

Champs
scheme

string

Obligatoire. Schéma d'authentification HTTP du registre IANA. Exemples : Bearer, Basic, Digest. Les noms de Scheme ne sont pas sensibles à la casse, conformément à la section 11.1 de la RFC 9110.

credentials

string

Identifiants de notification push. Le format dépend du schéma (par exemple, jeton pour le porteur).

AuthorizationCodeOAuthFlow

Définit les détails de configuration du flux avec code d'autorisation OAuth 2.0.

Champs
authorization_url

string

Obligatoire. URL d'autorisation à utiliser pour ce flux.

token_url

string

Obligatoire. URL du jeton à utiliser pour ce flux.

refresh_url

string

URL à utiliser pour obtenir des jetons d'actualisation.

scopes

map<string, string>

Obligatoire. Champs d'application disponibles pour le schéma de sécurité OAuth2.

pkce_required

bool

Indique si PKCE (RFC 7636) est requis pour ce flux. PKCE doit toujours être utilisé pour les clients publics et est recommandé pour tous les clients.

CancelTaskRequest

Représente une requête pour la méthode CancelTask.

Champs
tenant

string

Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur tenant de l'AgentInterface sélectionné dans la fiche de l'agent lorsque ce champ est défini.

id

string

Obligatoire. ID de ressource de la tâche à annuler.

metadata

Struct

Mappage clé-valeur flexible permettant de transmettre des paramètres ou un contexte supplémentaires.

ClientCredentialsOAuthFlow

Définit les détails de configuration du flux d'identifiants client OAuth 2.0.

Champs
token_url

string

Obligatoire. URL du jeton à utiliser pour ce flux.

refresh_url

string

URL à utiliser pour obtenir des jetons d'actualisation.

scopes

map<string, string>

Obligatoire. Champs d'application disponibles pour le schéma de sécurité OAuth2.

DeleteTaskPushNotificationConfigRequest

Représente une requête pour la méthode DeleteTaskPushNotificationConfig.

Champs
tenant

string

Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur tenant de l'AgentInterface sélectionné dans la fiche de l'agent lorsque ce champ est défini.

task_id

string

Obligatoire. ID de ressource de la tâche parente.

id

string

Obligatoire. ID de ressource de la configuration à supprimer.

DeviceCodeOAuthFlow

Définit les détails de configuration du flux de code d'appareil OAuth 2.0 (RFC 8628). Ce flux est conçu pour les appareils à saisie limitée, tels que les appareils IoT et les outils CLI, où l'utilisateur s'authentifie sur un autre appareil.

Champs
device_authorization_url

string

Obligatoire. URL du point de terminaison d'autorisation de l'appareil.

token_url

string

Obligatoire. URL du jeton à utiliser pour ce flux.

refresh_url

string

URL à utiliser pour obtenir des jetons d'actualisation.

scopes

map<string, string>

Obligatoire. Champs d'application disponibles pour le schéma de sécurité OAuth2.

GetExtendedAgentCardRequest

Représente une requête pour la méthode GetExtendedAgentCard.

Champs
tenant

string

Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur tenant de l'AgentInterface sélectionné dans la fiche de l'agent lorsque ce champ est défini.

GetTaskPushNotificationConfigRequest

Représente une requête pour la méthode GetTaskPushNotificationConfig.

Champs
tenant

string

Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur tenant de l'AgentInterface sélectionné dans la fiche de l'agent lorsque ce champ est défini.

task_id

string

Obligatoire. ID de ressource de la tâche parente.

id

string

Obligatoire. ID de ressource de la configuration à récupérer.

GetTaskRequest

Représente une requête pour la méthode GetTask.

Champs
tenant

string

Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur tenant de l'AgentInterface sélectionné dans la fiche de l'agent lorsque ce champ est défini.

id

string

Obligatoire. ID de ressource de la tâche à récupérer.

history_length

int32

Nombre maximal de messages les plus récents de l'historique de la tâche à récupérer. Une valeur non définie signifie que le client n'impose aucune limite. Une valeur nulle signifie que vous ne souhaitez inclure aucun message. Le serveur NE DOIT PAS renvoyer plus de messages que la valeur fournie, mais PEUT appliquer une limite inférieure.

HTTPAuthSecurityScheme

Définit un schéma de sécurité à l'aide de l'authentification HTTP.

Champs
description

string

Description facultative du schéma de sécurité.

scheme

string

Obligatoire. Nom du schéma d'authentification HTTP à utiliser dans l'en-tête "Authorization", tel que défini dans la RFC7235 (par exemple, "Bearer"). Cette valeur doit être enregistrée dans le registre des schémas d'authentification de l'IANA.

bearer_format

string

Indication au client pour identifier le format du jeton du porteur (par exemple, "JWT"). Principalement à des fins de documentation.

ImplicitOAuthFlow

Obsolète : utilisez plutôt le code d'autorisation + PKCE.

Champs
authorization_url

string

URL d'autorisation à utiliser pour ce flux. Elle DOIT se présenter sous la forme d'une URL. La norme OAuth2 exige l'utilisation de TLS.

refresh_url

string

URL à utiliser pour obtenir des jetons d'actualisation. Elle DOIT se présenter sous la forme d'une URL. La norme OAuth2 exige l'utilisation de TLS.

scopes

map<string, string>

Champs d'application disponibles pour le schéma de sécurité OAuth2. Mappage entre le nom du champ d'application et une brève description. La carte PEUT être vide.

ListTaskPushNotificationConfigsRequest

Représente une requête pour la méthode ListTaskPushNotificationConfigs.

Champs
tenant

string

Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur tenant de l'AgentInterface sélectionné dans la fiche de l'agent lorsque ce champ est défini.

task_id

string

Obligatoire. ID de ressource de la tâche parente.

page_size

int32

Nombre maximal de configurations à renvoyer.

page_token

string

Jeton de page reçu d'un appel ListTaskPushNotificationConfigsRequest précédent.

ListTaskPushNotificationConfigsResponse

Représente une réponse réussie pour la méthode ListTaskPushNotificationConfigs.

Champs
configs[]

TaskPushNotificationConfig

Liste des configurations de notifications push.

next_page_token

string

Jeton permettant de récupérer la page suivante des résultats. La valeur est nulle si la liste ne contient plus de résultats.

ListTasksRequest

Paramètres permettant de lister les tâches avec des critères de filtrage facultatifs.

Champs
tenant

string

Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur tenant de l'AgentInterface sélectionné dans la fiche de l'agent lorsque ce champ est défini.

context_id

string

Filtrez les tâches par ID de contexte pour obtenir les tâches d'une conversation ou d'une session spécifique.

status

TaskState

Filtrer les tâches en fonction de leur état actuel.

page_token

string

Jeton de page reçu d'un appel ListTasks précédent. ListTasksResponse.next_page_token. Fournissez-le pour récupérer la page suivante.

status_timestamp_after

Timestamp

Filtrez les tâches dont l'état a été mis à jour après le code temporel fourni au format ISO 8601 (par exemple, "2023-10-27T10:00:00Z"). Seules les tâches dont le code temporel de l'état est supérieur ou égal à cette valeur seront renvoyées.

page_size

int32

Nombre maximal de tâches à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 tâches au maximum sont renvoyées. La valeur minimale est 1. La valeur maximale est de 100.

history_length

int32

Nombre maximal de messages à inclure dans l'historique de chaque tâche.

include_artifacts

bool

Indique si les artefacts doivent être inclus dans les tâches renvoyées. La valeur par défaut est "false" pour réduire la taille de la charge utile.

ListTasksResponse

Objet de résultat pour la méthode ListTasks contenant un tableau de tâches et des informations de pagination.

Champs
tasks[]

Task

Obligatoire. Tableau des tâches correspondant aux critères spécifiés.

next_page_token

string

Obligatoire. Jeton permettant de récupérer la page suivante des résultats. La valeur est nulle si la liste ne contient plus de résultats.

page_size

int32

Obligatoire. Taille de la page utilisée pour cette réponse.

total_size

int32

Obligatoire. Nombre total de tâches disponibles (avant la pagination).

Message

Message est une unité de communication entre le client et le serveur. Il peut être associé à un contexte et/ou à une tâche. Pour les messages du serveur, context_id doit être fourni, et task_id uniquement si une tâche a été créée. Pour les messages client, les deux champs sont facultatifs. Toutefois, s'ils sont tous les deux fournis, ils doivent correspondre (le context_id doit être celui défini dans la tâche). Si seul task_id est fourni, le serveur en déduira context_id.

Champs
message_id

string

Obligatoire. Identifiant unique (par exemple, UUID) du message. Il est créé par l'auteur du message.

context_id

string

Facultatif. ID du contexte du message. Si cette option est définie, le message sera associé au contexte donné.

task_id

string

Facultatif. ID de la tâche du message. Si ce champ est défini, le message est associé à la tâche indiquée.

role

Role

Obligatoire. Identifie l'expéditeur du message.

parts[]

Part

Obligatoire. "Parts" est le conteneur du contenu du message.

metadata

Struct

Facultatif. Toutes les métadonnées à fournir avec le message.

extensions[]

string

URI des extensions présentes ou ajoutées à ce message.

reference_task_ids[]

string

Liste des ID de tâches auxquels ce message fait référence pour obtenir plus de contexte.

MutualTlsSecurityScheme

Définit un schéma de sécurité à l'aide de l'authentification mTLS.

Champs
description

string

Description facultative du schéma de sécurité.

OAuth2SecurityScheme

Définit un schéma de sécurité à l'aide d'OAuth 2.0.

Champs
description

string

Description facultative du schéma de sécurité.

flows

OAuthFlows

Obligatoire. Objet contenant des informations de configuration pour les flux OAuth 2.0 compatibles.

oauth2_metadata_url

string

URL des métadonnées du serveur d'autorisation OAuth2 RFC 8414. TLS est obligatoire.

OAuthFlows

Définit la configuration des flux OAuth 2.0 compatibles.

Champs

Champ d'union flow.

flow ne peut être qu'un des éléments suivants :

authorization_code

AuthorizationCodeOAuthFlow

Configuration du flux OAuth avec code d'autorisation.

client_credentials

ClientCredentialsOAuthFlow

Configuration du flux d'identifiants client OAuth.

implicit
(deprecated)

ImplicitOAuthFlow

Obsolète : utilisez plutôt le code d'autorisation + PKCE.

password
(deprecated)

PasswordOAuthFlow

Obsolète : utilisez le code d'autorisation + PKCE ou le code de l'appareil.

device_code

DeviceCodeOAuthFlow

Configuration du flux de code d'appareil OAuth.

OpenIdConnectSecurityScheme

Définit un schéma de sécurité à l'aide d'OpenID Connect.

Champs
description

string

Description facultative du schéma de sécurité.

open_id_connect_url

string

Obligatoire. L'URL de découverte OpenID Connect pour les métadonnées du fournisseur OIDC.

Partie

Part représente un conteneur pour une section de contenu de communication. Les composants peuvent être purement textuels, être un fichier (image, vidéo, etc.) ou un blob de données structurées (c'est-à-dire JSON).

Champs
metadata

Struct

Métadonnées facultatives associées à cette partie.

filename

string

filename facultatif pour le fichier (par exemple, "document.pdf").

media_type

string

Le media_type (type MIME) du contenu de la partie (par exemple, "text/plain", "application/json", "image/png"). Ce champ est disponible pour tous les types de pièces.

Champ d'union content.

content ne peut être qu'un des éléments suivants :

text

string

Contenu de la chaîne de la partie text.

raw

bytes

Contenu en octets raw d'un fichier. Dans la sérialisation JSON, il est encodé sous forme de chaîne base64.

url

string

url pointant vers le contenu du fichier.

data

Value

data structuré arbitraire en tant que valeur JSON (objet, tableau, chaîne, nombre, valeur booléenne ou null).

PasswordOAuthFlow

Obsolète : utilisez le code d'autorisation + PKCE ou le code de l'appareil.

Champs
token_url

string

URL du jeton à utiliser pour ce flux. Elle DOIT se présenter sous la forme d'une URL. La norme OAuth2 exige l'utilisation de TLS.

refresh_url

string

URL à utiliser pour obtenir des jetons d'actualisation. Elle DOIT se présenter sous la forme d'une URL. La norme OAuth2 exige l'utilisation de TLS.

scopes

map<string, string>

Champs d'application disponibles pour le schéma de sécurité OAuth2. Mappage entre le nom du champ d'application et une brève description. La carte PEUT être vide.

Rôle

Définit l'expéditeur d'un message dans la communication du protocole A2A.

Enums
ROLE_UNSPECIFIED Le rôle n'est pas spécifié.
ROLE_USER Le message est envoyé par le client au serveur.
ROLE_AGENT Le message est envoyé par le serveur au client.

SecurityRequirement

Définit les exigences de sécurité pour un agent.

Champs
schemes

map<string, StringList>

Mappage des schémas de sécurité aux habilitations requises.

SecurityScheme

Définit un schéma de sécurité pouvant être utilisé pour sécuriser les points de terminaison d'un agent. Il s'agit d'un type d'union discriminé basé sur l'objet de schéma de sécurité OpenAPI 3.2. Voir : https://spec.openapis.org/oas/v3.2.0.html#security-scheme-object

Champs

Champ d'union scheme.

scheme ne peut être qu'un des éléments suivants :

api_key_security_scheme

APIKeySecurityScheme

Authentification basée sur une clé API.

http_auth_security_scheme

HTTPAuthSecurityScheme

Authentification HTTP (de base, par jeton, etc.).

oauth2_security_scheme

OAuth2SecurityScheme

Authentification OAuth 2.0.

open_id_connect_security_scheme

OpenIdConnectSecurityScheme

Authentification OpenID Connect.

mtls_security_scheme

MutualTlsSecurityScheme

Authentification TLS mutuelle.

SendMessageConfiguration

Configuration d'une requête d'envoi de message.

Champs
accepted_output_modes[]

string

Liste des types de contenus multimédias que le client est prêt à accepter pour les parties de la réponse. Les agents DOIVENT l'utiliser pour adapter leur réponse.

task_push_notification_config

TaskPushNotificationConfig

Configuration permettant à l'agent d'envoyer des notifications push pour les mises à jour des tâches. L'ID de la tâche doit être vide lorsque cette configuration est envoyée dans une requête SendMessage.

return_immediately

bool

Si la valeur est true, l'opération est renvoyée immédiatement après la création de la tâche, même si le traitement est toujours en cours. Si la valeur est false (par défaut), l'opération DOIT attendre que la tâche atteigne un état final (COMPLETED, FAILED, CANCELED, REJECTED) ou interrompu (INPUT_REQUIRED, AUTH_REQUIRED) avant de renvoyer une réponse.

history_length

int32

Nombre maximal de messages les plus récents de l'historique de la tâche à récupérer dans la réponse. Une valeur non définie signifie que le client n'impose aucune limite. Une valeur nulle signifie que vous ne souhaitez inclure aucun message. Le serveur NE DOIT PAS renvoyer plus de messages que la valeur fournie, mais PEUT appliquer une limite inférieure.

SendMessageRequest

Représente une requête pour la méthode SendMessage.

Champs
tenant

string

Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur tenant de l'AgentInterface sélectionné dans la fiche de l'agent lorsque ce champ est défini.

message

Message

Obligatoire. Message à envoyer à l'agent.

configuration

SendMessageConfiguration

Configuration de la requête d'envoi.

metadata

Struct

Mappage clé-valeur flexible permettant de transmettre des paramètres ou un contexte supplémentaires.

SendMessageResponse

Représente la réponse pour la méthode SendMessage.

Champs
Champ d'union payload. Charge utile de la réponse. payload ne peut être qu'un des éléments suivants :
task

Task

Tâche créée ou modifiée par le message.

message

Message

Message de l'agent.

StreamResponse

Objet wrapper utilisé dans les opérations de streaming pour encapsuler différents types de données de réponse.

Champs
Champ d'union payload. Charge utile de la réponse du flux. payload ne peut être qu'un des éléments suivants :
task

Task

Objet Task contenant l'état actuel de la tâche.

message

Message

Objet Message contenant un message de l'agent.

status_update

TaskStatusUpdateEvent

Événement indiquant une mise à jour de l'état d'une tâche.

artifact_update

TaskArtifactUpdateEvent

Événement indiquant une mise à jour d'un artefact de tâche.

StringList

protolint:disable REPEATED_FIELD_NAMES_PLURALIZED A list of strings.

Champs
list[]

string

Valeurs de chaîne individuelles.

SubscribeToTaskRequest

Représente une requête pour la méthode SubscribeToTask.

Champs
tenant

string

Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur tenant de l'AgentInterface sélectionné dans la fiche de l'agent lorsque ce champ est défini.

id

string

Obligatoire. ID de ressource de la tâche à laquelle s'abonner.

Tâche

Task est l'unité d'action principale pour A2A. Il possède un état actuel et, lorsque des résultats sont créés pour la tâche, ils sont stockés dans l'artefact. S'il y a plusieurs tours pour une tâche, ils sont stockés dans l'historique.

Champs
id

string

Obligatoire. Identifiant unique (par exemple, UUID) de la tâche, généré par le serveur pour une nouvelle tâche.

context_id

string

Identifiant unique (par exemple, UUID) pour la collection contextuelle d'interactions (tâches et messages).

status

TaskStatus

Obligatoire. État actuel d'un Task, y compris state et message.

artifacts[]

Artifact

Ensemble d'artefacts de sortie pour un Task.

history[]

Message

protolint:disable REPEATED_FIELD_NAMES_PLURALIZED L'historique des interactions d'un Task.

metadata

Struct

protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Un objet clé/valeur permettant de stocker des métadonnées personnalisées sur une tâche.

TaskArtifactUpdateEvent

Delta de tâche dans lequel un artefact a été généré.

Champs
task_id

string

Obligatoire. ID de la tâche pour cet artefact.

context_id

string

Obligatoire. ID du contexte auquel appartient cette tâche.

artifact

Artifact

Obligatoire. Artefact généré ou mis à jour.

append

bool

Si la valeur est "true", le contenu de cet artefact doit être ajouté à un artefact envoyé précédemment avec le même ID.

last_chunk

bool

Si la valeur est "true", il s'agit du dernier bloc de l'artefact.

metadata

Struct

Facultatif. Métadonnées associées à la mise à jour de l'artefact.

TaskPushNotificationConfig

Conteneur associant une configuration de notification push à une tâche spécifique.

Champs
tenant

string

Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur tenant de l'AgentInterface sélectionné dans la fiche de l'agent lorsque ce champ est défini.

id

string

Détails de la configuration des notifications push. Identifiant unique (par exemple, UUID) pour cette configuration de notification push.

task_id

string

ID de la tâche à laquelle cette configuration est associée.

url

string

Obligatoire. URL à laquelle la notification doit être envoyée.

token

string

Jeton unique pour cette tâche ou session.

authentication

AuthenticationInfo

Informations d'authentification requises pour envoyer la notification.

TaskState

Définit les états de cycle de vie possibles d'un Task.

Enums
TASK_STATE_UNSPECIFIED L'état de la tâche est inconnu ou indéterminé.
TASK_STATE_SUBMITTED Indique qu'une tâche a bien été envoyée et confirmée.
TASK_STATE_WORKING Indique qu'une tâche est en cours de traitement par l'agent.
TASK_STATE_COMPLETED Indique qu'une tâche a été effectuée avec succès. Il s'agit d'un état final.
TASK_STATE_FAILED Indique qu'une tâche s'est terminée avec une erreur. Il s'agit d'un état final.
TASK_STATE_CANCELED Indique qu'une tâche a été annulée avant d'être terminée. Il s'agit d'un état final.
TASK_STATE_INPUT_REQUIRED Indique que l'agent a besoin d'une entrée utilisateur supplémentaire pour continuer. Il s'agit d'un état interrompu.
TASK_STATE_REJECTED Indique que l'agent a décidé de ne pas effectuer la tâche. Cela peut être fait lors de la création initiale de la tâche ou plus tard, une fois qu'un agent a déterminé qu'il ne pouvait pas ou ne voulait pas continuer. Il s'agit d'un état final.
TASK_STATE_AUTH_REQUIRED Indique qu'une authentification est requise pour continuer. Il s'agit d'un état interrompu.

TaskStatus

Conteneur pour l'état d'une tâche

Champs
state

TaskState

Obligatoire. État actuel de la tâche.

message

Message

Message associé à l'état.

timestamp

Timestamp

Code temporel ISO 8601 de l'enregistrement de l'état. Exemple : "2023-10-27T10:00:00Z"

TaskStatusUpdateEvent

Événement envoyé par l'agent pour informer le client d'un changement d'état d'une tâche.

Champs
task_id

string

Obligatoire. ID de la tâche qui a été modifiée.

context_id

string

Obligatoire. ID du contexte auquel appartient la tâche.

status

TaskStatus

Obligatoire. Nouvel état de la tâche.

metadata

Struct

Facultatif. Métadonnées associées à la mise à jour de la tâche.