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

Die Pokee Enterprise API ist eine REST-Schnittstelle, die einen langlebigen KI-Agenten in einer dedizierten, persistenten Sandbox pro Kunde 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 Demo-Anfrage bei Pokee, nicht per Self-Service-Registrierung.

Testen Sie Apidog noch heute

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

Was ist die Pokee Enterprise API?

Die Pokee Enterprise API (Pokee selbst nennt sie Enterprise Responses API) führt agentengesteuerte Workflows aus, die Minuten statt Sekunden dauern. Jeder Tenant erhält einen privaten Arbeitsbereich, ein stabiles Bearer-Token und eine 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, sodass der Agent über viele Turns hinweg recherchieren, Dateien schreiben und Tools aufrufen kann. Wenn Sie unseren Leitfaden zu Claude Managed Agents gelesen haben, kommt Ihnen die Form bekannt vor: Der Anbieter hostet die Agentenschleife und die Sandbox, und Sie steuern beides über HTTP.

Das Angebot richtet sich an Teams, die einen gehosteten Agenten mit Tenant-Isolierung und Unternehmensnetzwerk-Kontrollen wollen (IP-Allowlists, mTLS, AWS PrivateLink, Region-Pinning) — alles Kontrollen, die Pokee als auf Anfrage verfügbar listet.

Kernkonzepte: Sitzungen, Dateien, Skills und Gedächtnis

Die API hat vier Bausteine:

Konzept	Endpunkt	Was es Ihnen bietet
Sitzungen	POST /v1/sessions	Ein Agentenprozess pro Sitzung, mit eigener Historie, Dateibereich und Modell
Dateien	/v1/sessions/{id}/files/{path}	Arbeitsbereichsdateien hochladen, herunterladen, auflisten und löschen (ca. 100 MB pro Upload)
Skills	POST /v1/skills/{name}	Ein Zip-Bundle mit einer SKILL.md im Stammverzeichnis installieren; gilt für neue Sitzungen
Gedächtnis	.pokee/*.md, .memory/MEMORY.md	Tenant-Anweisungen, die dem System-Prompt hinzugefügt werden, plus sitzungsübergreifendes Gedächtnis

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 den Wert auf true, um die Sitzung zu behalten, bis ihr ttl abläuft (Standard: 14.400 Sekunden, also 4 Stunden) oder Sie sie löschen.
• Modellsperre. Das beim Erstellen übergebene model 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 antwortet außerhalb dieses Bereichs mit 403.
• Ein Turn zur Zeit. Eine zweite Nachricht während eines laufenden Turns liefert 409 Conflict.

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>. Der erste Aufruf umfasst dann 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, danach text.delta-Chunks (plus thinking.*- und tool_use.*-Events), und der Stream endet mit message.completed, message.cancelled oder message.error. Wenn SSE für Sie neu 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 Wege, Ihre Funktionen aufzurufen — beide nutzen OpenAI-artige Funktionsdefinitionen.

	Zustandslos /v1/responses	Sitzungs-Tools
Agentenschleife	Keine, ein Inferenz-Roundtrip	Vollständige Agentensitzung mit Skills und Dateien
Zustand	Sie senden bei jedem Aufruf die vollständige Historie	Der Server hält die Konversation
Wie ein Aufruf erscheint	Ein function_call-Element in output[]	Ein tool_call.requested-SSE-Event mitten im Stream
Wie Sie fortfahren	Neuer Aufruf mit einem function_call_output-Element	POST /v1/sessions/{id}/tool_results

Die zustandslose Route ist die richtige Wahl, wenn Sie Pokee hinter Code hängen, der für die OpenAI Responses API geschrieben wurde — die Übertragungsform stimmt überein. Sie akzeptiert bis zu 128 Tools pro Anfrage, Tool-Namen bis 64 Zeichen und Beschreibungen bis 16 KiB. Dazu kommt reasoning.effort (minimal, der Standard, hält erweitertes Denken ausgeschaltet; low, medium und high schalten es ein). Die Ausgabe liegt standardmäßig bei 4.096 Token, begrenzt auf 32.000.

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

Fortsetzen, Abbrechen und Idempotenzschlüssel

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

• Fortsetzen. Bricht Ihr Client mitten im Stream ab, läuft der Agent weiter. Verbinden Sie sich erneut mit GET /v1/sessions/{id}/responses/{rid}/events und einem Last-Event-ID-Header; der Server spielt ab dem nächsten Event erneut ab. Geschlossene Turns bleiben 120 Sekunden 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 eines abgebrochenen Turns wird nicht berechnet. Sitzung und Dateien bleiben bestehen.
• Idempotenzschlüssel. Senden Sie Idempotency-Key: <uuid> beim Message-POST. Ein Wiederholungsversuch mit demselben Schlüssel und Body liefert die ursprüngliche Response-ID zurück, statt einen zweiten Turn zu starten. Schlüssel leben 24 Stunden; derselbe Schlüssel mit anderem Body ergibt 422.

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.

Modell	Input	Output	Cache-Lesen
pokee-isaac-high-reasoning	$3	$15	$0.30
pokee-isaac	$0.30	$5	$0.10

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

Dazu gibt es die Direct Isaac API, hinzugefügt am 7. August 2026: eine OpenAI-kompatible POST /v1/chat/completions-Route ohne Agentenschleife und ohne 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 [REDACTED] 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, jeden davon auf Anfrage erhöhen zu können.

Limit	Standard
Gleichzeitige Sitzungen	10
Turn-Timeout	90 Minuten
Sitzungs-TTL	4 Stunden
Turns pro Stunde / pro Tag	300 / 5.000
Token pro Stunde / pro Tag	20 Mio. / 200 Mio.
Max. Upload	Ca. 100 MB pro Aufruf
Max. Arbeitsbereich	100 GB

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 festzulegen: 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.

Einmalige Einrichtung:

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

Dann geben Sie Ihrem Agenten einen [REDACTED 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 , 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 legt dann die Testfälle an und führt sie aus:

bash
apidog import --project --format openapi --file ./pokee-openapi.json
apidog environment create pokee-tenant --project --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 --file create-session.json
apidog run --test-case --project -e --env-var "POKEE_KEY=$POKEE_KEY" -r cli,junit

Übergeben Sie den Schlüssel mit `--env-var`, bleibt er aus jeder Datei heraus, die der Agent schreibt. Diese Testfälle decken die JSON-Endpunkte ab; den SSE-Stream selbst beobachten Sie einfacher in der Apidog-App, die gestreamte Events rendert (siehe [SSE-Tests in Apidog](https://apidog.com/de/blog/sse-testing-apidog?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation)). Derselbe `apidog run`-Befehl mit `-r junit` lässt sich in CI integrieren, wie unser [Apidog CLI CI/CD-Leitfaden](https://apidog.com/de/blog/apidog-cli-ci-cd-pipeline?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) zeigt. Neu bei der CLI in einem Agenten? Beginnen Sie mit [Apidog CLI in Claude Code](https://apidog.com/de/blog/apidog-cli-in-claude-code?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation). 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](https://sharkly.ai) ist ein Task-Board, auf dem KI-Agenten und Menschen die Arbeit teilen: Sie weisen einem Agenten oder einem Teammitglied eine Aufgabe zu, verfolgen den Status und prüfen die Ausgabe, bevor sie ausgeliefert wird. Der Einstieg ist kostenlos — setzen Sie also einen langen Agentenjob auf das Board und sehen Sie, 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, die Standard-Sitzungs-TTL 4 Stunden. Beide lassen sich auf Anfrage erhöhen.

**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](https://apidog.com/de/blog/openai-agents-api?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation); unser [Vergleich der Agentenoptionen von OpenAI](https://apidog.com/de/blog/openai-agents-api-vs-responses-api-vs-agents-sdk?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) ist eine gute nächste Lektüre, und [was CubeSandbox für KI-Agenten tut](https://apidog.com/de/blog/what-is-cubesandbox-for-ai-agents?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) behandelt die Sandbox-Seite.