io.enterpriseai.resources.CheckpointsClient
Source : sdks/java/enterprise-ai-java/src/main/java/io/enterpriseai/resources/CheckpointsClient.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 CheckpointsClient
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 CheckpointsClient
CheckpointsClient(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. |
CheckpointsClient.create
JsonNode create(String runId, Object body)
Enregistrer un point de reprise. Enregistre un état du run avec le numéro de séquence suivant et la séquence d'étape courante, pour que le run puisse reprendre à partir de là. Demande tenant_admin, developer ou agent. Refusé avec 409 run_finished sur un run succeeded ou cancelled. Émet checkpoint.created ; audité sous run.checkpoint.
Route : /v1/runs/{run_id}/checkpoints (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
runId | String | oui | Identifiant (UUID) du run. | |
body | Object | oui | État à enregistrer et libellé facultatif. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Enregistrer un point de reprise ».
Erreurs levées : les erreurs typées du transport (Erreurs).
CheckpointsClient.create
JsonNode create(String runId, Object body, RequestOptions options)
Enregistrer un point de reprise. Enregistre un état du run avec le numéro de séquence suivant et la séquence d'étape courante, pour que le run puisse reprendre à partir de là. Demande tenant_admin, developer ou agent. Refusé avec 409 run_finished sur un run succeeded ou cancelled. Émet checkpoint.created ; audité sous run.checkpoint.
Route : /v1/runs/{run_id}/checkpoints (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
runId | String | oui | Identifiant (UUID) du run. | |
body | Object | oui | État à enregistrer et libellé 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 « Enregistrer un point de reprise ».
Erreurs levées : les erreurs typées du transport (Erreurs).
CheckpointsClient.get
JsonNode get(String id)
Lire un point de reprise. Renvoie un point de reprise : run, numéro de séquence, séquence d'étape au moment de l'enregistrement, libellé et état enregistré. 404 checkpoint_not_found.
Route : /v1/checkpoints/{checkpoint_id} (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
id | String | oui | Identifiant (UUID) du point de reprise. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Lire un point de reprise ».
Erreurs levées : les erreurs typées du transport (Erreurs).
CheckpointsClient.list
JsonNode list(String runId)
Lister les points de reprise d'un run. Points de reprise du run dans l'ordre de séquence. Une seule page. 404 run_not_found.
Route : /v1/runs/{run_id}/checkpoints (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
runId | String | oui | Identifiant (UUID) du run. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les points de reprise d'un run ».
Erreurs levées : les erreurs typées du transport (Erreurs).