io.enterpriseai.resources.SessionsClient
Source : sdks/java/enterprise-ai-java/src/main/java/io/enterpriseai/resources/SessionsClient.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 SessionsClient
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 SessionsClient
SessionsClient(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. |
SessionsClient.create
JsonNode create(Object body)
Ouvrir une session. Ouvre une session de conversation, détenue par user_id ou par l'appelant. Ouvrir une session pour un autre utilisateur demande tenant_admin ou agent (403 forbidden). Demande tenant_admin, developer ou agent. 404 agent_not_found pour un agent_id inconnu. Audité sous session.create.
Route : /v1/sessions (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Agent, propriétaire, canal, titre, métadonnées et durée de vie de la session. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Ouvrir une session ».
Erreurs levées : les erreurs typées du transport (Erreurs).
SessionsClient.create
JsonNode create(Object body, RequestOptions options)
Ouvrir une session. Ouvre une session de conversation, détenue par user_id ou par l'appelant. Ouvrir une session pour un autre utilisateur demande tenant_admin ou agent (403 forbidden). Demande tenant_admin, developer ou agent. 404 agent_not_found pour un agent_id inconnu. Audité sous session.create.
Route : /v1/sessions (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Agent, propriétaire, canal, titre, métadonnées et durée de vie de la session. | |
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 « Ouvrir une session ».
Erreurs levées : les erreurs typées du transport (Erreurs).
SessionsClient.delete
void delete(String id)
Supprimer une session. Supprime la session et ses messages. Demande tenant_admin, developer ou agent, et l'appelant doit voir la session (son propriétaire, ou tenant_admin, auditor, security_officer, agent) ; sinon 404 session_not_found. Audité sous session.delete.
Route : /v1/sessions/{session_id} (DELETE).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
id | String | oui | Identifiant (UUID) de la session. |
Retour : void.
Erreurs levées : les erreurs typées du transport (Erreurs).
SessionsClient.get
JsonNode get(String id)
Lire une session. Renvoie une session. Visible par son propriétaire, par tenant_admin, auditor, security_officer et par le rôle agent ; sinon 404 session_not_found.
Route : /v1/sessions/{session_id} (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
id | String | oui | Identifiant (UUID) de la session. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Lire une session ».
Erreurs levées : les erreurs typées du transport (Erreurs).
SessionsClient.list
Page<JsonNode> list()
Lister les sessions. Sessions, de la plus récente à la plus ancienne, paginées avec cursor. Un appelant voit ses propres sessions ; tenant_admin, auditor et security_officer voient toutes les sessions du tenant.
Route : /v1/sessions (GET).
Cet élément ne prend aucun paramètre.
Retour : Page<JsonNode>. Réponse JSON décodée de l'opération « Lister les sessions ».
Erreurs levées : les erreurs typées du transport (Erreurs).
SessionsClient.list
Page<JsonNode> list(Map<String, ?> query)
Lister les sessions. Sessions, de la plus récente à la plus ancienne, paginées avec cursor. Un appelant voit ses propres sessions ; tenant_admin, auditor et security_officer voient toutes les sessions du tenant.
Route : /v1/sessions (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
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 « Lister les sessions ».
Erreurs levées : les erreurs typées du transport (Erreurs).
SessionsClient.messages
Page<JsonNode> messages(String id)
Lister les messages d'une session. Messages dans l'ordre, paginés avec cursor. after (identifiant de message ou horodatage) permet à un runtime de ne récupérer que les nouveaux messages ; un identifiant inconnu ou un horodatage mal formé répond 400 invalid_request.
Route : /v1/sessions/{session_id}/messages (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
id | String | oui | Identifiant (UUID) de la session. |
Retour : Page<JsonNode>. Réponse JSON décodée de l'opération « Lister les messages d'une session ».
Erreurs levées : les erreurs typées du transport (Erreurs).
SessionsClient.messages
Page<JsonNode> messages(String id, Map<String, ?> query)
Lister les messages d'une session. Messages dans l'ordre, paginés avec cursor. after (identifiant de message ou horodatage) permet à un runtime de ne récupérer que les nouveaux messages ; un identifiant inconnu ou un horodatage mal formé répond 400 invalid_request.
Route : /v1/sessions/{session_id}/messages (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
id | String | oui | Identifiant (UUID) de la session. | |
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 « Lister les messages d'une session ».
Erreurs levées : les erreurs typées du transport (Erreurs).
SessionsClient.postMessage
JsonNode postMessage(String id, Object body)
Ajouter un message à une session. Ajoute un message avec le numéro de séquence suivant. La session doit être ouverte et non expirée (409 session_closed). Demande tenant_admin, developer ou agent. L'événement d'audit session.message.add ne garde que le rôle et la longueur, jamais le contenu.
Route : /v1/sessions/{session_id}/messages (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
id | String | oui | Identifiant (UUID) de la session. | |
body | Object | oui | Rôle, contenu et métadonnées du message. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Ajouter un message à une session ».
Erreurs levées : les erreurs typées du transport (Erreurs).
SessionsClient.postMessage
JsonNode postMessage(String id, Object body, RequestOptions options)
Ajouter un message à une session. Ajoute un message avec le numéro de séquence suivant. La session doit être ouverte et non expirée (409 session_closed). Demande tenant_admin, developer ou agent. L'événement d'audit session.message.add ne garde que le rôle et la longueur, jamais le contenu.
Route : /v1/sessions/{session_id}/messages (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
id | String | oui | Identifiant (UUID) de la session. | |
body | Object | oui | Rôle, contenu et métadonnées du message. | |
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 « Ajouter un message à une session ».
Erreurs levées : les erreurs typées du transport (Erreurs).