Pokee Enterprise API：永続サンドボックス型エージェント、料金、初回API呼び出し

Pokee Enterprise APIは、各顧客専用の永続的なサンドボックス内で長文対応のAIエージェントを実行するREST APIです。セッションを作成し、メッセージを送信し、エージェントの回答をServer-Sent Events（SSE）ストリームとして読み取ります。セッションはファイル、カスタムスキル、独自のツール、そしてセッションをまたいで引き継がれるメモリを保持できます。アクセスはPokeeのデモリクエストを通じて行い、セルフサービスでのサインアップはできません。

以下では、セッションとストリームの仕組み、最初の呼び出し、Pokee Isaacの料金、制限事項、そしてコーディングエージェントにApidog CLIでエンドポイントをテストさせる方法を説明します。すべての数値は2026年10月28日時点で読んだPokeeドキュメントによるものです。

Pokee Enterprise APIとは？

Pokee Enterprise API（PokeeはこれをEnterprise Responses APIと呼んでいます）を使うと、秒単位ではなく分単位でかかるエージェント駆動のワークフローを実行できます。各テナントにはプライベートワークスペース、安定したベアラートークン、そして独自のサブドメインhttps://your-tenant.enterprise.pokee.aiが割り当てられます。そのワークスペース内では、各セッションが独自のサンドボックス内の1つのエージェントプロセスとなります。

チャット呼び出しは1つのプロンプトに答えて忘れてしまいます。Pokeeのセッションは会話、ファイル、ビジー状態を保持するため、エージェントは多くのターンにわたって調査し、ファイルを書き、ツールを呼び出すことができます。Claude Managed Agentsのガイドを読んだことがあるなら、その形は馴染み深いものでしょう。プロバイダーがエージェントループとサンドボックスをホストし、あなたはHTTP経由でそれを操作します。

これはテナント分離とエンタープライズネットワーク制御（IP許可リスト、mTLS、AWS PrivateLink、リージョンピン留め）を備えたホスト型エージェントを求めるチーム向けに作られており、Pokeeはこれらをリクエストに応じて利用可能としています。

中核となる概念：セッション、ファイル、スキル、メモリ

このAPIには4つの構成要素があります。

概念	エンドポイント	得られるもの
Sessions	`POST /v1/sessions`	セッションごとに1つのエージェントプロセス。独自の履歴、ファイルスコープ、モデルを持つ
Files	`/v1/sessions/{id}/files/{path}`	ワークスペースファイルのアップロード、ダウンロード、一覧表示、削除（1回のアップロードあたり約100 MB）
Skills	`POST /v1/skills/{name}`	ルートに`SKILL.md`を持つzipバンドルをインストール。新しいセッションに適用される
Memory	`.pokee/*.md`、`.memory/MEMORY.md`	システムプロンプトに追加されるテナント指示、およびセッションをまたぐメモリ

いくつかのセッションの詳細は早い段階で重要になります。

永続性。 デフォルトではpersistentはfalseで、セッションは最後の応答から5分後に自己破棄されます。trueに設定すると、ttlが切れるまで（デフォルト14,400秒、つまり4時間）、あるいは削除するまでセッションが保持されます。
モデルロック。 作成時に渡したmodelは、そのセッションのすべてのターンに適用されます。
ファイルスコープ。 readとwriteのパスリストを指定したfile_accessを渡すと、エージェントが見える範囲を制限できます。そのスコープ外ではHTTPファイルAPIは403を返します。
同時に1ターンのみ。 ターンが実行中に2つ目のメッセージを送信すると409 Conflictが返ります。

最初のPokee API呼び出しの方法

Pokeeは2つの値を別経路で渡します。テナントURLと、pk_<tenant>_<token>の形式のキーです。その後、最初の呼び出しは3つのステップで行います。

ゲートウェイが稼働していることを確認する（認証不要）。
セッションを作成し、そのidを保持する。
メッセージを送信し、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."}'

-iフラグはヘッダーを出力します。X-Response-Id（msg_と24桁の16進数文字）を保存してください。ターンを再開またはキャンセルするために必要です。

各イベントはid:、event:、data:の3行です。message.createdが表示され、次にtext.deltaのチャンク（およびthinking.*やtool_use.*のイベント）が続き、ストリームはmessage.completed、message.cancelled、またはmessage.errorで終わります。SSEが初めての方は、MDNのServer-Sent Eventsガイドがフォーマットを説明しており、SSEでストリーミングするLLM APIのテストに関する記事でチャンクの読み取り方を紹介しています。

Pokee Enterprise APIのセッションフロー：セッションを作成し、メッセージを送信し、SSEストリームを読み取る。再開とキャンセルの分岐付き

ツール呼び出し：2つのサーフェス

Pokeeはエージェントがあなたの関数を呼び出す2つの方法を提供しており、どちらもOpenAI形式の関数定義を使用します。

	ステートレス`/v1/responses`	セッションツール
エージェントループ	なし。1回の推論ラウンドトリップ	スキルとファイルを備えた完全なエージェントセッション
状態	呼び出しごとに完全な履歴を送信する	サーバーが会話を保持する
呼び出しの現れ方	`output[]`内の`function_call`項目	ストリーム途中の`tool_call.requested` SSEイベント
継続方法	`function_call_output`項目を含む新しい呼び出し	`POST /v1/sessions/{id}/tool_results`

ステートレスルートは、OpenAI Responses API向けに書かれたコードの背後にPokeeを差し替える場合に選ぶべきものです。ワイヤー形式が一致するからです。リクエストあたり最大128個のツール、ツール名は最大64文字、説明は最大16 KiBを受け付けます。またreasoning.effortも受け取ります（minimalがデフォルトで拡張思考をオフに保ち、low、medium、highでオンになります）。出力はデフォルトで4,096トークン、上限は32,000です。

セッションツールは、エージェントが同じターン内で推論し、スキルを実行し、時にはあなたのシステムを呼び出すべき場合に適しています。これらはセッション作成時に登録します。

Pokeeのツール呼び出しの比較：ステートレスな/v1/responses対SSE経由のセッションモードツール

再開、キャンセル、冪等性キー

長いターンは短い呼び出しとは違う形で壊れます。Pokeeは変更履歴によると、2026年5月4日に3つの修正を追加しました。

再開。 クライアントがストリーム途中で切断しても、エージェントは実行を続けます。Last-Event-IDヘッダーを付けてGET /v1/sessions/{id}/responses/{rid}/eventsに再接続すると、サーバーは次のイベントから再生します。閉じたターンは120秒間利用可能で、再開してもトークンは再課金されません。
キャンセル。 POST /v1/sessions/{id}/responses/{rid}/cancelは202を返し、ストリームはmessage.cancelledで終わります。キャンセルされたターンの部分的な使用量は課金されません。セッションとそのファイルは生き続けます。
冪等性キー。 メッセージPOSTにIdempotency-Key: <uuid>を送信します。同じキーとボディでの再試行は、2つ目のターンを開始する代わりに元のレスポンスIDを返します。キーは24時間有効で、同じキーで異なるボディを送ると422が返ります。

ステートレスな/v1/responsesルートは、streamがtrueの場合にこの3つすべてをサポートします。

Pokee Isaacのモデルと料金

Pokeeはモデルと料金ページで2つのIsaacティアを公開しています。価格は100万トークンあたりです。

モデル	入力	出力	キャッシュ読み取り
`pokee-isaac-high-reasoning`	$3	$15	$0.30
`pokee-isaac`	$0.30	$5	$0.10

新規テナントでは、modelを省略するとpokee-isaac-high-reasoningがデフォルトになります。Kimi、GPT-5.5、Geminiのバックエンドは契約に応じてテナントごとに利用可能です。ドキュメントには無料枠や最低契約額の記載はありません。それらの条件はPokeeに問い合わせてください。

また、2026年8月7日に追加されたDirect Isaac APIもあります。エージェントループやツールを持たない、OpenAI互換のPOST /v1/chat/completionsルートです。テナントごとに有効化され、pokee-isaacのみを受け付け、長いリクエスト（200,000および2,000,000トークン以上）を自動的に大きなコンテキストプールにルーティングします。GET /v1/usageでクレジット残高を確認できます。

ドキュメントからのセキュリティに関する注意点が1つあります。テナントベアラーは直接のAPIキーです。サーバー上または独自のプロキシの背後に保管し、ブラウザ、モバイル、デスクトップのコードには絶対に置かないでください。

制限とエラーコード

これらは制限とエラーページによるデフォルト値です。Pokeeはリクエストに応じていずれも引き上げ可能としています。

制限	デフォルト
同時セッション数	10
ターンタイムアウト	90分
セッションTTL	4時間
1時間あたり／1日あたりのターン数	300 / 5,000
1時間あたり／1日あたりのトークン数	20M / 200M
最大アップロード	1回の呼び出しあたり約100 MB
最大ワークスペース	100 GB

最もよく扱うエラーコードは、401（キーが不正または欠落）、402（クレジット不足、ハードクレジットモードのみ）、403（セッションのスコープ外のパス）、409（セッションがビジー）、422（冪等性キーが異なるボディで再利用された）、429（使用量制限）、500（バックオフして再試行）です。エラーは{"error": "<name>", "message": "<detail>"}として返ります。

コーディングエージェントにApidog CLIでPokee APIをテストさせる

セッションAPIには確定すべき契約がたくさんあります。作成時の201、sess_で始まるID、ビジー時の409、削除時の204、キャンセル時の202などです。あなたが作業を続ける間に、コーディングエージェントがこれらのチェックを書いて実行できます。Apidog CLIは、Claude Code、Codex、Cursorにそのためのコマンドを提供します。

一度セットアップします。

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

次にエージェントに1つのプロンプトを与えます。

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.

エージェントはスペックをインポートし、各ペイロードをCLIのスキーマに対してチェックしてから、ケースを作成して実行します。

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

--env-varでキーを渡すことで、エージェントが書き出すどのファイルにもキーが含まれないようにできます。これらのケースはJSONエンドポイントをカバーしますが、SSEストリーム自体はストリーミングイベントをレンダリングするApidogアプリで監視する方が簡単です（ApidogでのSSEテストを参照）。同じapidog runコマンドに-r junitを付けるとCIに組み込めます。Apidog CLI CI/CDガイドで示しているとおりです。エージェントでCLIを使うのが初めての場合は、Claude CodeでのApidog CLIから始めてください。Apidogの無料プランは最大4ユーザーまで対応します。

Sharklyが適する場面

Pokeeエージェント、あるいは任意のコーディングエージェントが90分かかるタスクを実行するようになると、誰が何をするかを決め、結果を確認する必要が出てきます。ログファイル内のセッションIDはワークキューではありません。Sharklyは、AIエージェントと人間が作業を共有するタスクボードです。タスクをエージェントまたはチームメイトに割り当て、そのステータスを追跡し、出荷前に出力をレビューします。無料で始められるので、1つの長いエージェントジョブをボードに載せ、スケールアップする前にレビューがチームにどう合うかを確認できます。

FAQ

Pokee Enterprise APIに無料枠はありますか？ ドキュメントには記載がありません。アクセスはデモリクエストから始まり、PokeeがテナントURLとキーを別経路でプロビジョニングします。料金は上記のIsaacティアのトークン単位です。

Pokee APIはOpenAIと互換性がありますか？ 部分的にあります。ステートレスな/v1/responsesルートは関数呼び出しについてOpenAIのResponsesのワイヤー形式に一致し、Direct IsaacルートはChat Completionsのリクエスト形式を受け付けます。セッションエンドポイントはPokee独自のものです。

Pokeeエージェントのターンはどのくらい実行できますか？ デフォルトのターンタイムアウトは90分、デフォルトのセッションTTLは4時間です。どちらもリクエストに応じて引き上げ可能です。

クライアントがストリーム途中で切断したらどうなりますか？ エージェントは作業を続けます。ターンが閉じてから120秒以内にLast-Event-IDを付けて再開エンドポイントに再接続すると、再課金なしで残りのイベントを取得できます。

他のホスト型エージェントAPIと比べてどうですか？ OpenAI Agents APIのようなホスト型エージェント製品に近い位置づけです。OpenAIのエージェントオプションの比較が次の読み物として適しており、CubeSandboxがAIエージェントに対して何をするかではサンドボックス側を扱っています。