Pokee Enterprise API: Persistente Sandbox-Agents, Preise und Ihr erster Aufruf

Die Pokee Enterprise API ist eine REST-API, die einen lang andauernden KI-Agenten in einer dedizierten, persistenten Sandbox für jeden Kunden ausführt. Sie erstellen eine Sitzung, senden eine Nachricht und lesen die Antwort des Agenten als Server-Sent-Events-(SSE-)Stream. Sitzungen können Dateien, benutzerdefinierte Skills, eigene Tools und ein Gedächtnis enthalten, das über Sitzungen hinweg erhalten bleibt. Der Zugang erfolgt über eine Pokee-Demo-Anfrage, nicht über eine Self-Service-Registrierung.

Im Folgenden: wie Sitzungen und Streams funktionieren, Ihr erster Aufruf, die Pokee-Isaac-Preisgestaltung, die Limits und wie Sie einen Coding-Agenten die Endpunkte mit der Apidog CLI testen lassen. Jede Zahl stammt aus den Pokee-Dokumentation, gelesen am 28. Oktober 2026.

Was ist die Pokee Enterprise API?

Die Pokee Enterprise API (Pokee nennt sie Enterprise Responses API) ermöglicht es Ihnen, agentengesteuerte Workflows auszuführen, die Minuten statt Sekunden dauern. Jeder Tenant erhält einen privaten Arbeitsbereich, ein stabiles Bearer-Token und seine eigene Subdomain, https://your-tenant.enterprise.pokee.ai. Innerhalb dieses Arbeitsbereichs ist jede Sitzung ein Agentenprozess in einer eigenen Sandbox.

Ein Chat-Aufruf beantwortet einen Prompt und vergisst ihn. Eine Pokee-Sitzung behält ihre Konversation, Dateien und ihren Beschäftigungsstatus bei, sodass der Agent über viele Turns hinweg recherchieren, Dateien schreiben und Tools aufrufen kann. Wenn Sie unseren Leitfaden zu Claude Managed Agents gelesen haben, wird Ihnen die Form bekannt vorkommen: Der Anbieter hostet die Agentenschleife und die Sandbox, und Sie steuern sie über HTTP.

Es ist für Teams konzipiert, die einen gehosteten Agenten mit Tenant-Isolierung und Unternehmensnetzwerk-Kontrollen (IP-Allowlists, mTLS, AWS PrivateLink, Region-Pinning) wünschen, die Pokee als auf Anfrage verfügbar auflistet.

Kernkonzepte: Sitzungen, Dateien, Skills und Gedächtnis

Die API hat vier Bausteine.

Einige Sitzungsdetails sind von Anfang an wichtig:

• Persistenz. Standardmäßig ist persistent false, und die Sitzung zerstört sich 5 Minuten nach ihrer letzten Antwort selbst. Setzen Sie es auf true, um die Sitzung zu behalten, bis ihr ttl abläuft (Standard: 14.400 Sekunden bzw. 4 Stunden) oder Sie sie löschen.
• Modellsperre. Das model, das Sie beim Erstellen übergeben, gilt für jeden Turn in dieser Sitzung.
• Dateibereich. Übergeben Sie file_access mit read- und write-Pfadlisten, um einzuschränken, was der Agent sieht; die HTTP-Datei-API gibt außerhalb dieses Bereichs 403 zurück.
• Ein Turn zur Zeit. Das Senden einer zweiten Nachricht während eines laufenden Turns gibt 409 Conflict zurück.

So tätigen Sie Ihren ersten Pokee-API-Aufruf

Pokee übergibt Ihnen zwei Werte außerhalb des Bandes: Ihre Tenant-URL und einen Schlüssel der Form pk_<tenant>_<token>. Dann umfasst der erste Aufruf drei Schritte.

1. Prüfen Sie, ob das Gateway erreichbar ist (keine Authentifizierung erforderlich).
2. Erstellen Sie eine Sitzung und behalten Sie deren id.
3. Senden Sie eine Nachricht und lesen Sie den SSE-Stream.

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."}'

Das -i-Flag gibt Header aus. Speichern Sie X-Response-Id (msg_ plus 24 Hex-Zeichen): Sie benötigen sie, um den Turn fortzusetzen oder abzubrechen.

Jedes Event besteht aus drei Zeilen, id:, event: und data:. Sie sehen message.created, dann text.delta-Chunks (plus thinking.*- oder tool_use.*-Events), und der Stream endet mit message.completed, message.cancelled oder message.error. Wenn SSE neu für Sie ist, erklärt MDNs Server-Sent-Events-Leitfaden das Format, und unser Beitrag zum Testen von LLM-APIs, die über SSE streamen zeigt, wie man die Chunks liest.

Tool-Aufrufe: zwei Oberflächen

Pokee bietet dem Agenten zwei Möglichkeiten, Ihre Funktionen aufzurufen, beide verwenden OpenAI-artige Funktionsdefinitionen.

Die zustandslose Route ist diejenige, die Sie wählen sollten, wenn Sie Pokee hinter Code austauschen, der für die OpenAI Responses API geschrieben wurde, da die Übertragungsform übereinstimmt. Sie akzeptiert bis zu 128 Tools pro Anfrage, Tool-Namen bis zu 64 Zeichen und Beschreibungen bis zu 16 KiB. Sie akzeptiert außerdem reasoning.effort (minimal, der Standard, hält erweitertes Denken ausgeschaltet; low, medium und high schalten es ein). Die Ausgabe beträgt standardmäßig 4.096 Token, begrenzt auf 32.000.

Sitzungs-Tools passen, wenn der Agent im selben Turn nachdenken, Skills ausführen und manchmal Ihre Systeme aufrufen soll. Sie registrieren sie beim Erstellen der Sitzung.

Fortsetzen, Abbrechen und Idempotenzschlüssel

Lange Turns brechen auf Arten ab, wie es kurze Aufrufe nicht tun. Pokee hat am 4. Mai 2026 laut seinem Changelog drei Korrekturen hinzugefügt.

• Fortsetzen. Wenn Ihr Client mitten im Stream abbricht, läuft der Agent weiter. Verbinden Sie sich erneut mit GET /v1/sessions/{id}/responses/{rid}/events mit einem Last-Event-ID-Header, und der Server spielt ab dem nächsten Event erneut ab. Geschlossene Turns bleiben 120 Sekunden lang verfügbar, und das Fortsetzen berechnet keine Tokens erneut.
• Abbrechen. POST /v1/sessions/{id}/responses/{rid}/cancel gibt 202 zurück und der Stream endet mit message.cancelled. Teilweise Nutzung bei einem abgebrochenen Turn wird nicht berechnet. Die Sitzung und ihre Dateien bleiben bestehen.
• Idempotenzschlüssel. Senden Sie Idempotency-Key: <uuid> beim Message-POST. Ein erneuter Versuch mit demselben Schlüssel und Body gibt die ursprüngliche Response-ID zurück, anstatt einen zweiten Turn zu starten. Schlüssel leben 24 Stunden, und derselbe Schlüssel mit einem anderen Body gibt 422 zurück.

Die zustandslose /v1/responses-Route unterstützt alle drei, wenn stream true ist.

Pokee-Isaac-Modelle und Preisgestaltung

Pokee veröffentlicht zwei Isaac-Stufen auf seiner Modelle-und-Preise-Seite. Die Preise gelten pro Million Token.

Neue Tenants verwenden standardmäßig pokee-isaac-high-reasoning, wenn Sie model weglassen. Kimi-, GPT-5.5- und Gemini-Backends sind pro Tenant vertraglich verfügbar. Die Dokumentation listet keine kostenlose Stufe oder einen Mindestvertrag auf; fragen Sie Pokee nach diesen Bedingungen.

Es gibt außerdem eine Direct Isaac API, hinzugefügt am 7. August 2026: eine OpenAI-kompatible POST /v1/chat/completions-Route ohne Agentenschleife oder Tools. Sie wird pro Tenant aktiviert, akzeptiert nur pokee-isaac und leitet lange Anfragen (200.000 und 2.000.000 Token und mehr) automatisch an größere Kontext-Pools weiter. GET /v1/usage zeigt Ihr Guthaben an.

Ein Sicherheitshinweis aus der Dokumentation: Der Tenant-Bearer ist ein direkter API-Schlüssel. Bewahren Sie ihn auf Ihrem Server oder hinter Ihrem eigenen Proxy auf, niemals in Browser-, Mobil- oder Desktop-Code.

Limits und Fehlercodes

Dies sind die Standardwerte von der Limits-und-Fehler-Seite. Pokee gibt an, dass es jeden davon auf Anfrage erhöhen kann.

Die Fehlercodes, die Sie am häufigsten behandeln werden: 401 (ungültiger oder fehlender Schlüssel), 402 (keine Credits mehr, nur im Hard-Credit-Modus), 403 (Pfad außerhalb des Sitzungsbereichs), 409 (Sitzung beschäftigt), 422 (Idempotenzschlüssel mit anderem Body wiederverwendet), 429 (Nutzungslimit) und 500 (mit Backoff erneut versuchen). Fehler kommen als {"error": "<name>", "message": "<detail>"} zurück.

Lassen Sie Ihren Coding-Agenten die Pokee API mit der Apidog CLI testen

Eine Sitzungs-API hat viel Vertrag, der festgelegt werden muss: 201 beim Erstellen, eine sess_-ID, 409 während beschäftigt, 204 beim Löschen, 202 beim Abbrechen. Ihr Coding-Agent kann diese Prüfungen schreiben und ausführen, während Sie weiterarbeiten. Die Apidog CLI gibt Claude Code, Codex oder Cursor die Befehle dafür.

Richten Sie es einmal ein:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_APIDOG_TOKEN>
apidog skill install

Dann geben Sie Ihrem Agenten einen Prompt:

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.

Der Agent importiert die Spezifikation, prüft jede Payload gegen das Schema der CLI und erstellt und führt dann die Testfälle aus:

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

Wenn Sie den Schlüssel mit --env-var übergeben, bleibt er aus jeder Datei heraus, die der Agent schreibt. Diese Testfälle decken die JSON-Endpunkte ab; den SSE-Stream selbst kann man in der Apidog-App leichter beobachten, die gestreamte Events rendert (siehe SSE-Tests in Apidog). Derselbe apidog run-Befehl mit -r junit lässt sich in CI integrieren, wie unser Apidog CLI CI/CD-Leitfaden zeigt. Neu bei der CLI in einem Agenten? Beginnen Sie mit Apidog CLI in Claude Code. Der kostenlose Plan von Apidog deckt bis zu 4 Benutzer ab.

Wo Sharkly passt

Sobald Pokee-Agenten oder beliebige Coding-Agenten Aufgaben ausführen, die 90 Minuten dauern, muss jemand entscheiden, wer was tut, und die Ergebnisse prüfen. Eine Sitzungs-ID in einer Protokolldatei ist keine Arbeitswarteschlange. Sharkly ist ein Task-Board, auf dem KI-Agenten und Menschen die Arbeit teilen: Sie weisen einem Agenten oder einem Teammitglied eine Aufgabe zu, verfolgen ihren Status und prüfen die Ausgabe, bevor sie ausgeliefert wird. Der Einstieg ist kostenlos, sodass Sie einen langen Agentenjob auf das Board setzen und sehen können, wie die Überprüfung in Ihr Team passt, bevor Sie skalieren.

FAQ

Gibt es eine kostenlose Stufe für die Pokee Enterprise API? Die Dokumentation beschreibt keine. Der Zugang beginnt mit einer Demo-Anfrage, und Pokee stellt Ihre Tenant-URL und Ihren Schlüssel außerhalb des Bandes bereit. Die Preisgestaltung erfolgt pro Token auf den oben genannten Isaac-Stufen.

Ist die Pokee API mit OpenAI kompatibel? Teilweise. Die zustandslose /v1/responses-Route entspricht der Responses-Übertragungsform von OpenAI für Funktionsaufrufe, und die Direct Isaac-Route akzeptiert die Chat-Completions-Anfrageform. Die Sitzungsendpunkte sind Pokees eigene.

Wie lange kann ein Pokee-Agenten-Turn laufen? Der Standard-Turn-Timeout beträgt 90 Minuten und die Standard-Sitzungs-TTL 4 Stunden. Beide können auf Anfrage erhöht werden.

Was passiert, wenn mein Client mitten im Stream die Verbindung trennt? Der Agent arbeitet weiter. Verbinden Sie sich innerhalb von 120 Sekunden nach dem Schließen des Turns erneut mit dem Resume-Endpunkt und Last-Event-ID, und Sie erhalten die restlichen Events ohne erneute Abrechnung.

Wie schneidet es im Vergleich zu anderen gehosteten Agenten-APIs ab? Es liegt nahe bei gehosteten Agenten-Angeboten wie der OpenAI Agents API; unser Vergleich der Agentenoptionen von OpenAI ist eine gute nächste Lektüre, und was CubeSandbox für KI-Agenten tut behandelt die Sandbox-Seite.