要約(TL;DR): Pokee AIエージェントは、Pokee Enterprise APIを介して動作します。各テナントには専用の永続サンドボックスが提供され、エージェントはスコープ制限されたファイルアクセス、アップロードしたスキル、.pokee/ペルソナファイル、セッションをまたいで保持されるメモリを活用しながら、1ターンあたり最大90分間作業できます。APIはエージェントを実行する役割を果たしますが、チームには作業の割り当て、進捗の監視、そして本番導入前の成果物レビューを一元管理する場が依然として不可欠です。
Pokeeは、チャットウィンドウには収まらないタスクのために構築されています。たとえば、10ページに及ぶ市場レポートの作成や、1時間近くかかるリサーチなどが該当します。90分間の実行をずっと画面の前で見守る人はいません。だからこそ、誰かが責任を持ってタスクを管理し、内容を確認し、完了したかどうかを判断する必要があります。すでにコーディングエージェントを1つのボードで管理しているなら、Sharklyがその作業の集約先となります(詳細は後述します)。
Pokee AIとは?
Pokeeはエージェントプラットフォームであり、そのEnterprise APIは「専用の永続サンドボックス内で、長時間の自律型エージェントワークフローを実行するためのREST API」と定義されています。各テナントにはプライベートワークスペース、Bearerトークン、そしてhttps://your-tenant.enterprise.pokee.aiのようなアドレスでセッション、ファイル、スキル、ストリーミングメッセージ用のエンドポイントが提供されます。利用はエンタープライズ向けに限定されており、Pokeeの公式ドキュメントでは新規顧客向けに「デモのリクエスト(Request demo)」が案内されており、セルフサーブ型や無料プランについての記載はありません。
モデルと価格のページには、2つのモデル層(ティア)が掲載されています。
| モデル | 入力($/100万トークン) | 出力($/100万トークン) | キャッシュ読み取り($/100万トークン) |
|---|---|---|---|
pokee-isaac-high-reasoning |
$3 | $15 | $0.30 |
pokee-isaac |
$0.30 | $5 | $0.10 |
新規テナントのデフォルトは高推論(high-reasoning)ティアです。モデルはセッション作成時に固定されるため、そのセッション内のすべてのターンは同じティアで実行されます。
Pokeeのエージェントモデル:セッション、サンドボックス、ファイル、スキル、メモリ
Pokeeのエージェントモデルには設定可能な5つの要素があり、それぞれがチームとしての運用方針の決定に直結しています。
- セッション(Sessions): セッションとは、専用ポッド内の独立したサンドボックスで動作する1つのエージェントプロセスであり、固有の履歴、ファイルスコープ、ビジー状態を持ちます。
- 永続モード(Persistent mode): デフォルトのセッションは、最後の応答から5分後に自動消滅します。
persistent: trueに設定すると、TTL(デフォルトで4時間)に達するか、手動で削除するまで維持されます。 - ファイルアクセスのスコープ制限(Scoped file access): 作成時に
read(読み取り)とwrite(書き込み)のパスを指定します。スコープ外のパスはエージェントのファイルシステム上には存在しないものとして扱われます。 - スキル(Skills): ルートに
SKILL.mdを含むZIPファイルをアップロードします。テナント内のすべての新規セッションからそのスキルが利用可能になります。 - ペルソナファイルとメモリ(Persona files and memory):
.pokee/ディレクトリ内のMarkdownファイルがシステムプロンプトの先頭に追加され、.memory/MEMORY.mdによってセッションをまたいで情報が引き継がれます。
Pokeeはどのようにファイルアクセスのスコープを制限しているのか?
スコープの制限は2段階で適用されます。エージェント内部では、セッションごとに作成されるbubblewrapマウント名前空間によって許可されたパス以外のすべてが隠蔽され、読み取ろうとしてもENOENTが返されます。一方、HTTPファイルAPI経由での同様のリクエストには403 Forbiddenが返されます。
ファイルアクセス制限のクックブックには、特定クライアントのフォルダと共有テンプレートフォルダを読み取り可能にし、書き込みはそのクライアントの出力フォルダのみに制限するセッションの例が示されています。
curl -X POST "$POKEE_API/v1/sessions" \
-H "Authorization: Bearer $POKEE_KEY" \
-H "Content-Type: application/json" \
-d '{
"persistent": true,
"ttl": 14400,
"metadata": {"board_task": "COIN-412", "client": "acme-corp"},
"file_access": {
"read": ["projects/acme-corp", "shared/templates"],
"write": ["projects/acme-corp/output"]
}
}'
スコープはセッションの存続期間中、変更できません。アクセス範囲を広げるには、セッションを破棄して新規作成する必要があります。これはコンプライアンス面で有利に働く一方、チームに明確な運用判断を求めます。つまり、タスクの進行中に行き当たりばったりで変更するのではなく、タスク割り当ての段階で適切なスコープをあらかじめ決めておく必要があります。
.pokee/ペルソナファイルとメモリの役割とは?
workspace/.pokee/*.md内のファイルはアルファベット順にシステムプロンプトへ読み込まれ、それぞれ## <filename>の見出しの下に配置されます。ペルソナクックブックでは、トーン&マナー(口調)に00_soul.md、ドメイン用語集に10_glossary.md、フォーマット規約に20_style_guide.mdを使用しています。ディレクトリ全体の容量上限は1MBです。
変更は次のセッションから適用され、実行中のセッションのプロンプトは維持されます。また、エージェントは各セッションで.memory/MEMORY.mdの読み取りと更新を行いますが、このファイルはファイルAPIを通じて直接編集することも、エージェントコンテキストページに記載されているようにPokee側に無効化をリクエストすることも可能です。
長時間実行型AIエージェントがチームにもたらす変化
長時間実行されるAIエージェントは、チームの日々の業務における3つの側面を大きく変えます。「誰が作業を開始するのか」「進行状況をどう把握するのか」、そして「誰が最終承認(サインオフ)するのか」です。Pokeeのデフォルトの制限事項を見ると、これらの課題が具体的に浮かび上がってきます。
| 制限項目 | デフォルト値 |
|---|---|
| 同時実行セッション数 | 10 |
| ターンタイムアウト | 90分 |
| セッションTTL | 4時間 |
| 1時間あたり / 1日あたりのターン数 | 300 / 5,000 |
| 1時間あたり / 1日あたりのトークン数 | 20M / 200M |
| 最大ワークスペースサイズ | 100 GB |
Pokeeによると、これらはすべてリクエストに応じて引き上げが可能です。
90分に及ぶエージェントタスクを誰が割り当てるのか?
同時実行セッションが10個と聞くと十分なように思えますが、月曜日の朝に5人のメンバーがそれぞれ2件ずつレポート生成を開始すれば、あっという間に上限に達します。また、ビジー状態のセッションに2つ目のメッセージを送ると409エラーで拒否されます。そのため、誰かがタスク、モデルティア、ファイルスコープ、セッションを選択し、担当者を定めてタスクに明記する必要があります。そうすることで、2人のメンバーが同じ90分のビルド作業を重複して実行してしまう事態を防げます。
長時間の実行中にエージェントが何をしているかをどう把握するのか?
クライアントが接続を切断した後も、エージェントはバックグラウンドで動作し続けます。長時間実行タスクのクックブックでは、15秒ごとにGET /v1/sessions/{id}をポーリングしてbusyフラグを確認し、ワークフローがmetadataに書き込んだ進捗キーを読み取って、最終的な出力ファイルをダウンロードする手順が紹介されています。
while True:
s = c.get(f"/v1/sessions/{sid}").json()
if not s["busy"]:
break
print(f"metadata: {s['metadata']}")
time.sleep(15)
ストリーム自体はServer-Sent Eventsを利用しており、message.created、message.completed、message.error、message.cancelledなどのイベントが発行されます。再開(resume)エンドポイントを使えば、切断されたストリームをLast-Event-IDから再接続でき、トークンの再課金も発生しません。ただし、これによりスクリプトが把握できるのは「ターンが終了したかどうか」だけであり、生成されたレポートの品質が良いかどうかまではわかりません。
成果物を提出・公開する前に誰がレビューするのか?
Pokeeはワークスペースにファイルを出力します。しかし、レビューはAPIの外で行われる人間の仕事です。誰かがreport.mdを開き、指示内容(ブリーフ)と照合して、承認するか差し戻すかを判断します。エージェントによる並行作業が増えるほど、このステップがボトルネックになりがちです。この問題については「人間のレビューがボトルネックになる:並行処理に向けたレビュー設計」でも論じられています。

具体例:タスク割り当てからレビューまでのクライアントレポート作成フロー
3人のチームメンバーが1つのPokeeテナントを共有しているとします。成果物は「Acme Corp」向けの四半期市場レポートです。
- 割り当て(Assign): Danaが「Acme向け第3四半期市場レポート」というタスクを作成し、担当者をDana、レビュアーをSam、期日を木曜日に設定します。
- スコープ設定(Scope): タスク内で使用するPokeeモデル(
pokee-isaac-high-reasoning)、読み取りパス(projects/acme-corp、shared/templates)、および書き込みパス(projects/acme-corp/output)を指定します。 - 開始(Start): Danaは
metadataにタスクIDを含めて永続セッションを作成し、output/report.mdにレポートを出力するよう指示するメッセージを1通送信します。 - 追跡(Track): セッションIDがタスクのコメントに記録されます。
GET /v1/sessions/{id}をポーリングすると、ターンが完了するまでbusy: trueが返されます。 - 回収(Collect):
busyがfalseに切り替わったら、Danaはファイルをダウンロードしてタスクに添付します。 - レビュー(Review): Samが指示内容と照合して内容を確認します。不備があればコメントを付けて差し戻し、新たなターンを実行します。問題がなければタスクを次のステージへ進めます。
- クリーンアップ(Clean up): Danaがセッションを手動で削除するか、夜間に定期実行される
DELETE /v1/sessions?status=idle&older_than=1hによって一括クリーンアップされます。
ステップ1、4、6はAPI呼び出しではありません。これらはチーム内の「調整(コーディネーション)」です。エージェントが数秒で応答するときには省略されがちですが、処理に1時間かかるようになると、省略したことを後悔することになる重要なステップです。
Pokeeのエージェント運用においてSharklyが果たす役割
Sharklyはエージェント作業管理プラットフォームです。1つのボード上で人とエージェントの双方にタスクを割り当て、実行状況を追跡し、成果物を人間のレビュー待ちとして管理できます。Sharkly自体がPokeeのセッションを実行するわけではなく、専用のPokeeコネクタがあるわけでもありません。タスク、担当者、ステータス、そして成果物のレビュープロセスを一元的に取り持つ役割を果たします。
実際の運用では以下のようになります。
- タスクの割り当て(Assignment): Pokee関連のタスクは担当者とステータスが付与され、他の通常業務と並んでボード上で管理されます。責任の所在を明確にすべき理由については、「エージェント型チーム(agentic teams)」をご覧ください。
- APIを駆動するエージェント(An Agent that drives the API): Sharklyエージェントは、Claude Codeなどのランタイムを介して利用者のローカル環境(Computer)上で実行されます。前述のcurl呼び出しをラップしたスキルをエージェントに持たせることで、セッションの作成、ポーリング、タスクへのセッションIDや実行結果の書き戻しを自動化できます。
- Pokeeに合わせた実行制限(Run limits that match Pokee’s): 各エージェントには「実行設定(Run settings)」があり、割り当てタスクの最大同時実行数、タスクあたりの最大実行時間、キューのタイムアウトを設定できます。下の画像のエージェントはタスク1件・40分に制限されています。Pokeeのタスクを扱う場合は、同時実行数を契約上限の10セッション以下に抑え、90分のターンに対応できる実行時間を設定するか、エージェントにターンを開始させて後から進捗を確認させる運用にします。

- メッセージではなく「状態」としてのレビュー(Review as a state, not a message): エージェントはタスクを「人間のレビュー待ち」状態にすることができ、そのタスクはレビュアーの受信トレイ(Inbox)に届きます。どの段階で処理を止めて人間を介在させるべきかについては、「Human-in-the-loop型コーディングエージェント」および「コーディングエージェントの承認ゲート:どこで止めるべきか」で解説しています。
- 外部からのトリガー(Triggers from outside): SharklyのオートメーションはWebhookトリガーに対応しています。外部サービスから専用の秘密URLへPOSTリクエストを送信することで実行を開始できるため、Pokeeのターンが完了したタイミングで独自のスクリプトから呼び出すことが可能です。
Sharklyは無料で利用を開始でき、モデルの利用料金はすでにお支払い中の各アカウント側で処理されます。長時間実行におけるレビューパターンの詳細については、「100万トークン規模のエージェント実行にはレビューキューが必要だ」をご覧ください。
Pokeeが適しているケース・適していないケース
コードの変更ではなく文書やデータセットの作成が目的で、実行に数分から1時間程度を要し、永続的なサンドボックスが必要なタスクにはPokeeが適しています。特に「エージェントにクライアントBのデータを参照させてはならない」といった契約条項がある場合、ファイルシステムレベルでスコープ制限が徹底されるため極めて有効です。また、Pokeeのオフラインモードを利用すれば、外部への通信経路をモデルAPIのみに限定したテナントを構築できます。
一方で、営業担当者との商談を経ずに今すぐ利用を開始したい場合には、他の選択肢を検討すべきでしょう。また、自社のリポジトリ内で直接コードを書く作業であれば、ローカル環境(Computer)上で動作するClaude CodeやCodexの方がより適しています。多くのチームではその両方を併用することになるため、それらを統括する単一の管理ボードが不可欠となります。
まとめ
Pokee AIエージェントは、真の意味で隔離された環境で長時間の作業をチームにもたらします。APIが教えてくれるのは「ターンが完了したか否か」だけです。「誰が開始したのか」「どのリソースにアクセスしたのか」「出力された成果物が正しいか」を判断するのは、依然としてチームの役割です。
最初のセッションを開始する前に、これら3つの答えをタスクに明記しておきましょう。Pokeeの実行とコーディングエージェントを一元管理できるボードをお探しの場合は、Sharklyワークスペースを開設し、今週さっそく最初のエージェントに長時間実行タスクを割り当ててみてください。
よくある質問(FAQ)
Pokee Enterprise APIとは何ですか?
Pokee Enterprise APIは、テナントごとの専用かつ永続的なサンドボックス内で長時間の自律型エージェントワークフローを実行するためのREST APIです。Bearerトークンによる認証を行い、セッション、ファイル、スキル、ストリーミングメッセージ、利用状況に関するエンドポイントを利用できます。
Pokeeエージェントはどのくらいの時間実行できますか?
デフォルトでは、1ターンあたり最大90分、セッションは最大4時間実行可能です。どちらもリクエストに応じて上限を引き上げることができます。
Pokee AIは無料ですか?
公式ドキュメントに無料プランの記載はありません。利用開始にはデモのリクエストが必要であり、利用料金はトークン制で課金されます。pokee-isaac-high-reasoningでは100万トークンあたり入力$3/出力$15、pokee-isaacでは入力$0.30/出力$5となっています。
2人のユーザーが同じPokeeセッションに同時にメッセージを送るとどうなりますか?
2つ目のメッセージには409エラーが返されます。セッションが別のメッセージを処理中でビジー状態であるためです。各セッションは一度に1ターンしか処理できないため、並行して作業を行うには別のセッションを使用する必要があります(デフォルト上限は10セッション)。
Pokeeエージェントはセッション間で記憶を保持できますか?
はい、保持できます。毎セッションでworkspace/.memory/MEMORY.mdを読み書きし、このファイルはポッドが再起動しても維持されます。
SharklyからPokeeエージェントを直接実行できますか?
いいえ、直接実行はできません。Sharklyには専用のPokeeコネクタはありません。ローカル環境(Computer)上で動作するSharklyエージェントがスキル経由でPokee APIを呼び出し、Sharklyのタスク上で担当割り当て、ステータス、そして人間によるレビューを管理する形をとります。



