L'API Pokee Enterprise est une API REST qui exécute un agent IA de longue durée dans un bac à sable dédié et persistant pour chaque client. Vous créez une session, envoyez un message et lisez la réponse de l'agent sous forme de flux Server-Sent Events (SSE). Les sessions peuvent contenir des fichiers, des compétences personnalisées, vos propres outils et une mémoire qui persiste d'une session à l'autre. L'accès se fait via une demande de démo Pokee, et non par une inscription en libre-service.
Ci-dessous : le fonctionnement des sessions et des flux, votre premier appel, la tarification de Pokee Isaac, les limites, et comment faire tester les points de terminaison par un agent de codage avec Apidog CLI. Tous les chiffres proviennent de la documentation Pokee, consultée le 28 octobre 2026.
Qu'est-ce que l'API Pokee Enterprise ?
L'API Pokee Enterprise (Pokee l'appelle l'Enterprise Responses API) vous permet d'exécuter des workflows pilotés par agent qui prennent des minutes, et non des secondes. Chaque tenant obtient un espace de travail privé, un jeton bearer stable et son propre sous-domaine, https://your-tenant.enterprise.pokee.ai. Dans cet espace de travail, chaque session est un processus d'agent dans son propre bac à sable.
Un appel de chat répond à une invite puis oublie. Une session Pokee conserve sa conversation, ses fichiers et son état d'occupation, de sorte que l'agent peut effectuer des recherches, écrire des fichiers et appeler des outils sur de nombreux tours. Si vous avez lu notre guide sur Claude Managed Agents, la forme vous semblera familière : le fournisseur héberge la boucle d'agent et le bac à sable, et vous le pilotez en HTTP.
Il est conçu pour les équipes qui veulent un agent hébergé avec isolation par tenant et contrôles réseau d'entreprise (listes d'IP autorisées, mTLS, AWS PrivateLink, épinglage de région), que Pokee indique comme disponibles sur demande.
Concepts clés : sessions, fichiers, compétences et mémoire
L'API comporte quatre blocs de construction.
| Concept | Point de terminaison | Ce qu'il vous apporte |
|---|---|---|
| Sessions | POST /v1/sessions |
Un processus d'agent par session, avec son propre historique, sa portée de fichiers et son modèle |
| Fichiers | /v1/sessions/{id}/files/{path} |
Téléverser, télécharger, lister et supprimer des fichiers de l'espace de travail (environ 100 Mo par téléversement) |
| Compétences | POST /v1/skills/{name} |
Installer un paquet zip contenant un SKILL.md à sa racine ; s'applique aux nouvelles sessions |
| Mémoire | .pokee/*.md, .memory/MEMORY.md |
Instructions de tenant ajoutées à l'invite système, plus la mémoire d'une session à l'autre |
Quelques détails de session importent dès le départ :
- Persistance. Par défaut,
persistentvautfalse, et la session se détruit 5 minutes après sa dernière réponse. Passez-le àtruepour conserver la session jusqu'à expiration de sonttl(14 400 secondes par défaut, soit 4 heures) ou jusqu'à ce que vous la supprimiez. - Verrouillage du modèle. Le
modelque vous transmettez à la création s'applique à chaque tour de cette session. - Portée des fichiers. Transmettez
file_accessavec des listes de cheminsreadetwritepour restreindre ce que l'agent voit ; l'API HTTP de fichiers renvoie403en dehors de cette portée. - Un tour à la fois. Envoyer un second message pendant qu'un tour s'exécute renvoie
409 Conflict.
Comment effectuer votre premier appel à l'API Pokee
Pokee vous transmet deux valeurs par un autre canal : l'URL de votre tenant et une clé de la forme pk_<tenant>_<token>. Ensuite, le premier appel se fait en trois étapes.
- Vérifiez que la passerelle est opérationnelle (aucune authentification requise).
- Créez une session et conservez son
id. - Publiez un message et lisez le flux SSE.
export POKEE_API="https://your-tenant.enterprise.pokee.ai"
export POKEE_KEY="pk_<tenant>_<token>"
curl "$POKEE_API/health"
SID=$(curl -s -X POST "$POKEE_API/v1/sessions" \
-H "Authorization: Bearer $POKEE_KEY" \
-H "Content-Type: application/json" \
-d '{"persistent": true}' | jq -r '.id')
curl -N -i -X POST "$POKEE_API/v1/sessions/$SID/messages" \
-H "Authorization: Bearer $POKEE_KEY" \
-H "Content-Type: application/json" \
-d '{"message": "Summarize the files in my workspace in three bullets."}'
L'option -i affiche les en-têtes. Conservez X-Response-Id (msg_ suivi de 24 caractères hexadécimaux) : vous en avez besoin pour reprendre ou annuler le tour.
Chaque événement comporte trois lignes, id:, event: et data:. Vous verrez message.created, puis des morceaux text.delta (ainsi que des événements thinking.* ou tool_use.*), et le flux se termine par message.completed, message.cancelled ou message.error. Si les SSE sont nouveaux pour vous, le guide de MDN sur les Server-Sent Events explique le format, et notre article sur le test des API LLM qui diffusent en SSE montre comment lire les morceaux.
Appel d'outils : deux surfaces
Pokee offre à l'agent deux façons d'appeler vos fonctions, toutes deux utilisant des définitions de fonctions de style OpenAI.
/v1/responses sans état |
Outils de session | |
|---|---|---|
| Boucle d'agent | Aucune, un seul aller-retour d'inférence | Session d'agent complète avec compétences et fichiers |
| État | Vous envoyez tout l'historique à chaque appel | Le serveur conserve la conversation |
| Comment apparaît un appel | Un élément function_call dans output[] |
Un événement SSE tool_call.requested en milieu de flux |
| Comment vous poursuivez | Nouvel appel avec un élément function_call_output |
POST /v1/sessions/{id}/tool_results |
La route sans état est celle à choisir lorsque vous remplacez Pokee derrière du code écrit pour l'API OpenAI Responses, car la forme des échanges correspond. Elle accepte jusqu'à 128 outils par requête, des noms d'outils de 64 caractères maximum et des descriptions de 16 Kio maximum. Elle accepte aussi reasoning.effort (minimal, la valeur par défaut, désactive la réflexion étendue ; low, medium et high l'activent). La sortie est de 4 096 jetons par défaut, plafonnée à 32 000.
Les outils de session conviennent lorsque l'agent doit raisonner, exécuter des compétences et parfois appeler vos systèmes dans le même tour. Vous les enregistrez à la création de la session.
Reprise, annulation et clés d'idempotence
Les tours longs se rompent d'une manière que les appels courts ne connaissent pas. Pokee a ajouté trois correctifs le 4 mai 2026, selon son journal des modifications.
- Reprise. Si votre client se déconnecte en plein flux, l'agent continue de tourner. Reconnectez-vous à
GET /v1/sessions/{id}/responses/{rid}/eventsavec un en-têteLast-Event-IDet le serveur rejoue à partir de l'événement suivant. Les tours clos restent disponibles pendant 120 secondes, et la reprise ne refacture pas de jetons. - Annulation.
POST /v1/sessions/{id}/responses/{rid}/cancelrenvoie202et le flux se termine parmessage.cancelled. L'usage partiel d'un tour annulé n'est pas facturé. La session et ses fichiers restent actifs. - Clés d'idempotence. Envoyez
Idempotency-Key: <uuid>dans le POST du message. Une nouvelle tentative avec la même clé et le même corps renvoie l'ID de réponse d'origine au lieu de démarrer un second tour. Les clés vivent 24 heures, et la même clé avec un corps différent renvoie422.
La route sans état /v1/responses prend en charge les trois lorsque stream vaut true.
Modèles et tarification Pokee Isaac
Pokee publie deux niveaux Isaac sur sa page des modèles et de la tarification. Les prix sont par million de jetons.
| Modèle | Entrée | Sortie | Lecture du cache |
|---|---|---|---|
pokee-isaac-high-reasoning |
3 $ | 15 $ | 0,30 $ |
pokee-isaac |
0,30 $ | 5 $ | 0,10 $ |
Les nouveaux tenants utilisent pokee-isaac-high-reasoning par défaut lorsque vous omettez model. Les backends Kimi, GPT-5.5 et Gemini sont disponibles par tenant sur contrat. La documentation ne mentionne ni niveau gratuit ni contrat minimum ; demandez ces conditions à Pokee.
Il existe aussi une Direct Isaac API, ajoutée le 7 août 2026 : une route POST /v1/chat/completions compatible OpenAI, sans boucle d'agent ni outils. Elle est activée par tenant, n'accepte que pokee-isaac, et achemine automatiquement les requêtes longues (200 000 et 2 000 000 de jetons et plus) vers des pools de contexte plus grands. GET /v1/usage affiche votre solde de crédits.
Une note de sécurité issue de la documentation : le bearer de tenant est une clé API directe. Gardez-la sur votre serveur ou derrière votre propre proxy, jamais dans du code de navigateur, mobile ou bureau.
Limites et codes d'erreur
Voici les valeurs par défaut de la page des limites et des erreurs. Pokee indique pouvoir relever n'importe laquelle sur demande.
| Limite | Valeur par défaut |
|---|---|
| Sessions simultanées | 10 |
| Délai d'expiration d'un tour | 90 minutes |
| TTL de session | 4 heures |
| Tours par heure / par jour | 300 / 5 000 |
| Jetons par heure / par jour | 20 M / 200 M |
| Téléversement maximal | Environ 100 Mo par appel |
| Espace de travail maximal | 100 Go |
Les codes d'erreur que vous gérerez le plus souvent : 401 (clé incorrecte ou manquante), 402 (crédits épuisés, mode crédit strict uniquement), 403 (chemin hors de la portée de la session), 409 (session occupée), 422 (clé d'idempotence réutilisée avec un corps différent), 429 (limite d'usage) et 500 (réessayez avec un backoff). Les erreurs sont renvoyées sous la forme {"error": "<name>", "message": "<detail>"}.
Faites tester l'API Pokee par votre agent de codage avec Apidog CLI
Une API de session a beaucoup de contrat à figer : 201 à la création, un ID sess_, 409 pendant l'occupation, 204 à la suppression, 202 à l'annulation. Votre agent de codage peut écrire et exécuter ces vérifications pendant que vous continuez à travailler. Apidog CLI fournit à Claude Code, Codex ou Cursor les commandes pour le faire.
Configurez-le une fois :
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_APIDOG_TOKEN>
apidog skill install
Donnez ensuite une seule invite à votre agent :
Write an OpenAPI file for the Pokee Enterprise API endpoints /health,
POST/GET/DELETE /v1/sessions, /v1/sessions/{id}/responses/{rid}/cancel and
/v1/usage, import it into Apidog project <projectId>, create an environment
for my tenant URL, then add test cases that assert 201 and an id starting
with "sess_" on create, 204 on delete and a credit balance on /v1/usage.
Run them and summarize failures. Read POKEE_KEY from my shell, never a file.
L'agent importe la spécification, vérifie chaque charge utile par rapport au schéma de la CLI, puis crée et exécute les cas :
apidog import --project <projectId> --format openapi --file ./pokee-openapi.json
apidog environment create pokee-tenant --project <projectId> --base-url https://your-tenant.enterprise.pokee.ai
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file create-session.json
apidog test-case create --project <projectId> --file create-session.json
apidog run --test-case <caseId> --project <projectId> -e <envId> --env-var "POKEE_KEY=$POKEE_KEY" -r cli,junit
Transmettre la clé via --env-var évite qu'elle ne se retrouve dans un fichier écrit par l'agent. Ces cas couvrent les points de terminaison JSON ; le flux SSE lui-même est plus facile à observer dans l'application Apidog, qui affiche les événements diffusés (voir le test SSE dans Apidog). La même commande apidog run avec -r junit s'intègre à la CI, comme le montre notre guide d'Apidog CLI pour les pipelines CI/CD. Nouveau sur la CLI dans un agent ? Commencez par Apidog CLI dans Claude Code. Le plan gratuit d'Apidog couvre jusqu'à 4 utilisateurs.
Où se situe Sharkly
Une fois que les agents Pokee, ou n'importe quels agents de codage, exécutent des tâches qui prennent 90 minutes, quelqu'un doit décider qui fait quoi et vérifier les résultats. Un ID de session dans un fichier de log n'est pas une file de travail. Sharkly est un tableau de tâches où les agents IA et les humains partagent le travail : vous assignez une tâche à un agent ou à un collègue, suivez son statut et examinez le résultat avant sa livraison. C'est gratuit pour commencer, vous pouvez donc mettre une longue tâche d'agent sur le tableau et voir comment la revue s'intègre à votre équipe avant de passer à l'échelle.
FAQ
Existe-t-il un niveau gratuit pour l'API Pokee Enterprise ? La documentation n'en décrit aucun. L'accès commence par une demande de démo, et Pokee provisionne l'URL de votre tenant et votre clé par un autre canal. La tarification est à l'usage par jeton sur les niveaux Isaac ci-dessus.
L'API Pokee est-elle compatible avec OpenAI ? En partie. La route sans état /v1/responses correspond à la forme des échanges Responses d'OpenAI pour l'appel de fonctions, et la route Direct Isaac accepte la forme des requêtes Chat Completions. Les points de terminaison de session sont propres à Pokee.
Combien de temps peut durer un tour d'agent Pokee ? Le délai d'expiration par défaut d'un tour est de 90 minutes et le TTL de session par défaut est de 4 heures. Les deux peuvent être relevés sur demande.
Que se passe-t-il si mon client se déconnecte en plein flux ? L'agent continue de travailler. Reconnectez-vous au point de terminaison de reprise avec Last-Event-ID dans les 120 secondes suivant la clôture du tour et vous recevez le reste des événements sans refacturation.
Comment se compare-t-elle aux autres API d'agents hébergés ? Elle se situe près des offres d'agents hébergés comme l'API OpenAI Agents ; notre comparaison des options d'agents d'OpenAI est une bonne lecture ensuite, et ce que CubeSandbox apporte aux agents IA couvre le volet bac à sable.