io.enterpriseai.resources.A2aClient
Source : sdks/java/enterprise-ai-java/src/main/java/io/enterpriseai/resources/A2aClient.java. Retour à l'index de la référence du SDK Java.
Cette page est générée par tools/docs/gen_sdk_reference.py depuis les sources du SDK et les dossiers de textes OpenAPI. Ne la modifiez pas à la main : changez la source et régénérez.
Classe A2aClient
Agents. Registre des agents du tenant et exécution côté serveur de leurs runs : étapes, budgets, points de reprise, heartbeats, sous-agents, messages d'agent à agent (A2A), sessions de conversation, planifications cron, déclencheurs sur événement et exécutions en sandbox.
Constructeur A2aClient
A2aClient(Transport transport)
Crée le client sur le transport partagé ; EnterpriseAIClient le construit, on y accède par l'accesseur du même nom.
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
transport | Transport | oui | Transport partagé par les sous-clients d'un même client. |
A2aClient.inbox
Page<JsonNode> inbox(String recipient)
Lire une boîte de réception A2A. Renvoie les messages A2A adressés à recipient, du plus ancien au plus récent, chacun avec verified (la signature HMAC-SHA256 de l'enveloppe correspond à la clé du tenant). La lecture marque les messages renvoyés comme lus. Une seule page (next_cursor vaut toujours null).
Route : /v1/a2a/inbox (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
recipient | String | oui | Partie dont la boîte est lue : agent:<nom> ou run:<id> (au moins 3 caractères). |
Retour : Page<JsonNode>. Réponse JSON décodée de l'opération « Lire une boîte de réception A2A ».
Erreurs levées : les erreurs typées du transport (Erreurs).
A2aClient.inbox
Page<JsonNode> inbox(String recipient, Map<String, ?> query)
Lire une boîte de réception A2A. Renvoie les messages A2A adressés à recipient, du plus ancien au plus récent, chacun avec verified (la signature HMAC-SHA256 de l'enveloppe correspond à la clé du tenant). La lecture marque les messages renvoyés comme lus. Une seule page (next_cursor vaut toujours null).
Route : /v1/a2a/inbox (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
recipient | String | oui | Partie dont la boîte est lue : agent:<nom> ou run:<id> (au moins 3 caractères). | |
query | Map<String, ?> | oui | Paramètres de la chaîne de requête de la route. |
Retour : Page<JsonNode>. Réponse JSON décodée de l'opération « Lire une boîte de réception A2A ».
Erreurs levées : les erreurs typées du transport (Erreurs).
A2aClient.send
JsonNode send(Object body)
Envoyer un message A2A. Envoie un message signé d'agent à agent (enveloppe a2a.v1, signature HMAC-SHA256 propre au tenant). Demande tenant_admin, developer ou agent. Étapes : 1. to et from sont résolus : agent:<nom> ou run:<id> (400 invalid_request sinon). Sans from, l'expéditeur est le principal appelant. 2. Un expéditeur run: doit être un run créé par l'appelant (ou l'appelant est tenant_admin, sinon 403 forbidden) et non terminé (409 run_finished). 3. La politique agent.a2a.send est évaluée et la charge utile est filtrée comme contenu non fiable ; une injection de prompt est refusée avec prompt_injection_blocked après enregistrement de l'événement de sécurité. 4. L'enveloppe est déposée dans la boîte du destinataire et auditée sous a2a.send.
Route : /v1/a2a/messages (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Destinataire, type de message, charge utile et fil de conversation facultatif. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Envoyer un message A2A ».
Erreurs levées : les erreurs typées du transport (Erreurs).
A2aClient.send
JsonNode send(Object body, RequestOptions options)
Envoyer un message A2A. Envoie un message signé d'agent à agent (enveloppe a2a.v1, signature HMAC-SHA256 propre au tenant). Demande tenant_admin, developer ou agent. Étapes : 1. to et from sont résolus : agent:<nom> ou run:<id> (400 invalid_request sinon). Sans from, l'expéditeur est le principal appelant. 2. Un expéditeur run: doit être un run créé par l'appelant (ou l'appelant est tenant_admin, sinon 403 forbidden) et non terminé (409 run_finished). 3. La politique agent.a2a.send est évaluée et la charge utile est filtrée comme contenu non fiable ; une injection de prompt est refusée avec prompt_injection_blocked après enregistrement de l'événement de sécurité. 4. L'enveloppe est déposée dans la boîte du destinataire et auditée sous a2a.send.
Route : /v1/a2a/messages (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Destinataire, type de message, charge utile et fil de conversation facultatif. | |
options | RequestOptions | oui | Options de l'appel (clé d'idempotence, traceparent, en-têtes, signal d'annulation). |
Retour : JsonNode. Réponse JSON décodée de l'opération « Envoyer un message A2A ».
Erreurs levées : les erreurs typées du transport (Erreurs).