Index
A2AService(interface)APIKeySecurityScheme(message)AgentCapabilities(message)AgentCard(message)AgentCardSignature(message)AgentExtension(message)AgentInterface(message)AgentProvider(message)AgentSkill(message)Artifact(message)AuthenticationInfo(message)AuthorizationCodeOAuthFlow(message)CancelTaskRequest(message)ClientCredentialsOAuthFlow(message)DeleteTaskPushNotificationConfigRequest(message)DeviceCodeOAuthFlow(message)GetExtendedAgentCardRequest(message)GetTaskPushNotificationConfigRequest(message)GetTaskRequest(message)HTTPAuthSecurityScheme(message)ImplicitOAuthFlow(message)ListTaskPushNotificationConfigsRequest(message)ListTaskPushNotificationConfigsResponse(message)ListTasksRequest(message)ListTasksResponse(message)Message(message)MutualTlsSecurityScheme(message)OAuth2SecurityScheme(message)OAuthFlows(message)OpenIdConnectSecurityScheme(message)Part(message)PasswordOAuthFlow(message)Role(enum)SecurityRequirement(message)SecurityScheme(message)SendMessageConfiguration(message)SendMessageRequest(message)SendMessageResponse(message)StreamResponse(message)StringList(message)SubscribeToTaskRequest(message)Task(message)TaskArtifactUpdateEvent(message)TaskPushNotificationConfig(message)TaskState(enum)TaskStatus(message)TaskStatusUpdateEvent(message)
A2AService
Fournit des opérations permettant d'interagir avec les agents à l'aide du protocole A2A.
| CancelTask |
|---|
|
Annule une tâche en cours.
|
| CreateTaskPushNotificationConfig |
|---|
|
Crée une configuration de notification push pour une tâche.
|
| DeleteTaskPushNotificationConfig |
|---|
|
Supprime une configuration de notification push pour une tâche.
|
| GetExtendedAgentCard |
|---|
|
Récupère la fiche d'agent étendue pour l'agent authentifié.
|
| GetTask |
|---|
|
Récupère le dernier état d'une tâche.
|
| GetTaskPushNotificationConfig |
|---|
|
Obtient une configuration de notification push pour une tâche.
|
| ListTaskPushNotificationConfigs |
|---|
|
Obtenez la liste des notifications push configurées pour une tâche.
|
| ListTasks |
|---|
|
Répertorie les tâches qui correspondent au filtre spécifié.
|
| SendMessage |
|---|
|
Envoie un message à un agent.
|
| SendStreamingMessage |
|---|
|
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
|
| SubscribeToTask |
|---|
|
S'abonne aux mises à jour des tâches qui ne sont pas dans un état final. Renvoie
|
APIKeySecurityScheme
Définit un schéma de sécurité à l'aide d'une clé API.
| Champs | |
|---|---|
description |
Description facultative du schéma de sécurité. |
location |
Obligatoire. Emplacement de la clé API. Les valeurs valides sont "query", "header" ou "cookie". |
name |
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[] |
Liste des extensions de protocole compatibles avec l'agent. |
streaming |
Indique si l'agent accepte les réponses en streaming. |
push_notifications |
Indique si l'agent est compatible avec l'envoi de notifications push pour les mises à jour des tâches asynchrones. |
extended_agent_card |
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 |
Obligatoire. Nom de l'agent lisible par l'humain. Exemple : "Agent de recettes" |
description |
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[] |
Obligatoire. Liste ordonnée des interfaces compatibles. La première entrée est privilégiée. |
provider |
Fournisseur de services de l'agent. |
version |
Obligatoire. Version de l'agent. Exemple : "1.0.0" |
capabilities |
Obligatoire. Ensemble de fonctionnalités A2A compatibles avec l'agent. |
security_schemes |
Informations sur le schéma de sécurité utilisé pour l'authentification auprès de cet agent. |
security_requirements[] |
Exigences de sécurité pour contacter l'agent. |
default_input_modes[] |
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[] |
Obligatoire. Types de contenus multimédias acceptés en tant que sorties de cet agent. |
skills[] |
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[] |
Signatures Web JSON calculées pour ce |
documentation_url |
URL fournissant de la documentation supplémentaire sur l'agent. |
icon_url |
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 |
Obligatoire. Obligatoire. En-tête JWS protégé pour la signature. Il s'agit toujours d'un objet JSON encodé en base64url. |
signature |
Obligatoire. Signature calculée, encodée en base64url. |
header |
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 |
URI unique identifiant l'extension. |
description |
Description lisible de la façon dont cet agent utilise l'extension. |
required |
Si la valeur est "true", le client doit comprendre et respecter les exigences de l'extension. |
params |
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 |
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 |
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 |
tenant |
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 |
protocol_version |
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 |
Obligatoire. URL du site Web du fournisseur de l'agent ou de la documentation pertinente. Exemple : "https://ai.google.dev" |
organization |
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 |
Obligatoire. Identifiant unique de la compétence de l'agent. |
name |
Obligatoire. Nom lisible de la compétence. |
description |
Obligatoire. Description détaillée de la compétence. |
tags[] |
Obligatoire. Ensemble de mots clés décrivant les capacités de la compétence. |
examples[] |
Exemples de requêtes ou de scénarios que cette compétence peut traiter. |
input_modes[] |
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[] |
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[] |
Schémas de sécurité nécessaires pour cette compétence. |
Artefact
Les artefacts représentent les sorties des tâches.
| Champs | |
|---|---|
artifact_id |
Obligatoire. Identifiant unique (par exemple, UUID) de l'artefact. Il doit être unique dans une tâche. |
name |
Nom lisible de l'artefact. |
description |
Facultatif. Description de l'artefact lisible par l'humain. |
parts[] |
Obligatoire. Contenu de l'artefact. Doit contenir au moins une partie. |
metadata |
Facultatif. Métadonnées incluses avec l'artefact. |
extensions[] |
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 |
Obligatoire. Schéma d'authentification HTTP du registre IANA. Exemples : |
credentials |
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 |
Obligatoire. URL d'autorisation à utiliser pour ce flux. |
token_url |
Obligatoire. URL du jeton à utiliser pour ce flux. |
refresh_url |
URL à utiliser pour obtenir des jetons d'actualisation. |
scopes |
Obligatoire. Champs d'application disponibles pour le schéma de sécurité OAuth2. |
pkce_required |
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 |
Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur |
id |
Obligatoire. ID de ressource de la tâche à annuler. |
metadata |
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 |
Obligatoire. URL du jeton à utiliser pour ce flux. |
refresh_url |
URL à utiliser pour obtenir des jetons d'actualisation. |
scopes |
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 |
Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur |
task_id |
Obligatoire. ID de ressource de la tâche parente. |
id |
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 |
Obligatoire. URL du point de terminaison d'autorisation de l'appareil. |
token_url |
Obligatoire. URL du jeton à utiliser pour ce flux. |
refresh_url |
URL à utiliser pour obtenir des jetons d'actualisation. |
scopes |
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 |
Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur |
GetTaskPushNotificationConfigRequest
Représente une requête pour la méthode GetTaskPushNotificationConfig.
| Champs | |
|---|---|
tenant |
Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur |
task_id |
Obligatoire. ID de ressource de la tâche parente. |
id |
Obligatoire. ID de ressource de la configuration à récupérer. |
GetTaskRequest
Représente une requête pour la méthode GetTask.
| Champs | |
|---|---|
tenant |
Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur |
id |
Obligatoire. ID de ressource de la tâche à récupérer. |
history_length |
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 |
Description facultative du schéma de sécurité. |
scheme |
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 |
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 |
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 |
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 |
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 |
Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur |
task_id |
Obligatoire. ID de ressource de la tâche parente. |
page_size |
Nombre maximal de configurations à renvoyer. |
page_token |
Jeton de page reçu d'un appel |
ListTaskPushNotificationConfigsResponse
Représente une réponse réussie pour la méthode ListTaskPushNotificationConfigs.
| Champs | |
|---|---|
configs[] |
Liste des configurations de notifications push. |
next_page_token |
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 |
Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur |
context_id |
Filtrez les tâches par ID de contexte pour obtenir les tâches d'une conversation ou d'une session spécifique. |
status |
Filtrer les tâches en fonction de leur état actuel. |
page_token |
Jeton de page reçu d'un appel |
status_timestamp_after |
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 |
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 |
Nombre maximal de messages à inclure dans l'historique de chaque tâche. |
include_artifacts |
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[] |
Obligatoire. Tableau des tâches correspondant aux critères spécifiés. |
next_page_token |
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 |
Obligatoire. Taille de la page utilisée pour cette réponse. |
total_size |
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 |
Obligatoire. Identifiant unique (par exemple, UUID) du message. Il est créé par l'auteur du message. |
context_id |
Facultatif. ID du contexte du message. Si cette option est définie, le message sera associé au contexte donné. |
task_id |
Facultatif. ID de la tâche du message. Si ce champ est défini, le message est associé à la tâche indiquée. |
role |
Obligatoire. Identifie l'expéditeur du message. |
parts[] |
Obligatoire. "Parts" est le conteneur du contenu du message. |
metadata |
Facultatif. Toutes les métadonnées à fournir avec le message. |
extensions[] |
URI des extensions présentes ou ajoutées à ce message. |
reference_task_ids[] |
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 |
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 |
Description facultative du schéma de sécurité. |
flows |
Obligatoire. Objet contenant des informations de configuration pour les flux OAuth 2.0 compatibles. |
oauth2_metadata_url |
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
|
|
authorization_code |
Configuration du flux OAuth avec code d'autorisation. |
client_credentials |
Configuration du flux d'identifiants client OAuth. |
implicit |
Obsolète : utilisez plutôt le code d'autorisation + PKCE. |
password |
Obsolète : utilisez le code d'autorisation + PKCE ou le code de l'appareil. |
device_code |
Configuration du flux de code d'appareil OAuth. |
OpenIdConnectSecurityScheme
Définit un schéma de sécurité à l'aide d'OpenID Connect.
| Champs | |
|---|---|
description |
Description facultative du schéma de sécurité. |
open_id_connect_url |
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 |
Métadonnées facultatives associées à cette partie. |
filename |
|
media_type |
Le |
Champ d'union
|
|
text |
Contenu de la chaîne de la partie |
raw |
Contenu en octets |
url |
|
data |
|
PasswordOAuthFlow
Obsolète : utilisez le code d'autorisation + PKCE ou le code de l'appareil.
| Champs | |
|---|---|
token_url |
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 |
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 |
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 |
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
|
|
api_key_security_scheme |
Authentification basée sur une clé API. |
http_auth_security_scheme |
Authentification HTTP (de base, par jeton, etc.). |
oauth2_security_scheme |
Authentification OAuth 2.0. |
open_id_connect_security_scheme |
Authentification OpenID Connect. |
mtls_security_scheme |
Authentification TLS mutuelle. |
SendMessageConfiguration
Configuration d'une requête d'envoi de message.
| Champs | |
|---|---|
accepted_output_modes[] |
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 |
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 |
return_immediately |
Si la valeur est |
history_length |
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 |
Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur |
message |
Obligatoire. Message à envoyer à l'agent. |
configuration |
Configuration de la requête d'envoi. |
metadata |
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 |
Tâche créée ou modifiée par le 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 |
Objet Task contenant l'état actuel de la tâche. |
message |
Objet Message contenant un message de l'agent. |
status_update |
Événement indiquant une mise à jour de l'état d'une tâche. |
artifact_update |
É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[] |
Valeurs de chaîne individuelles. |
SubscribeToTaskRequest
Représente une requête pour la méthode SubscribeToTask.
| Champs | |
|---|---|
tenant |
Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur |
id |
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 |
Obligatoire. Identifiant unique (par exemple, UUID) de la tâche, généré par le serveur pour une nouvelle tâche. |
context_id |
Identifiant unique (par exemple, UUID) pour la collection contextuelle d'interactions (tâches et messages). |
status |
Obligatoire. État actuel d'un |
artifacts[] |
Ensemble d'artefacts de sortie pour un |
history[] |
protolint:disable REPEATED_FIELD_NAMES_PLURALIZED L'historique des interactions d'un |
metadata |
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 |
Obligatoire. ID de la tâche pour cet artefact. |
context_id |
Obligatoire. ID du contexte auquel appartient cette tâche. |
artifact |
Obligatoire. Artefact généré ou mis à jour. |
append |
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 |
Si la valeur est "true", il s'agit du dernier bloc de l'artefact. |
metadata |
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 |
Facultatif. Identifiant de routage opaque. Doit correspondre à la valeur |
id |
Détails de la configuration des notifications push. Identifiant unique (par exemple, UUID) pour cette configuration de notification push. |
task_id |
ID de la tâche à laquelle cette configuration est associée. |
url |
Obligatoire. URL à laquelle la notification doit être envoyée. |
token |
Jeton unique pour cette tâche ou session. |
authentication |
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 |
Obligatoire. État actuel de la tâche. |
message |
Message associé à l'état. |
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 |
Obligatoire. ID de la tâche qui a été modifiée. |
context_id |
Obligatoire. ID du contexte auquel appartient la tâche. |
status |
Obligatoire. Nouvel état de la tâche. |
metadata |
Facultatif. Métadonnées associées à la mise à jour de la tâche. |