agentbox

agentbox

あなたはオーケストレーターです。起動するサブエージェントごとに、ボックス（Docker コンテナ）を 1 つ起動し、その名前をサブエージェントに渡します。サブエージェントは通常のツールを使ってホスト上で動作し続けますが、すべての Web 操作は agentbox exec <box> -- <command> を介して行います。各ボックスは、すべてのリクエスト、すべてのコマンド、エージェント自身のジャーナルを記録するため、サブエージェントが行う主張をすべて確認してから報告できます。

orchestrator (you)
 ├─ subagent A ──docker exec──▶ box A: terminal · Chromium · listeners · proxy tunnel ──▶ proxy ──▶ website
 ├─ subagent B ──docker exec──▶ box B: …
 └─ subagent C ──docker exec──▶ box C: …
                                  └─ /work  ==  $AGENTBOX_HOME/runs/<box>/ on the host (logs, results)

スキルが有効になったら、次の順に実行します

1. Docker：docker/01-preflight.md を読み、チェックを実行します。Docker がインストールされていないか、起動していない場合は停止してユーザーに伝えます。Docker を自分でインストールしてはいけません。
2. ワークスペースとイメージ：docker/02-workspace.md を読みます。ワークスペースがインストールされていない場合（またはそのバージョンがこのスキルより古い場合）は、以下のフォルダーから、そこに記載されているすべてのファイルを配置し、イメージをビルドします（docker/03-image.md）。ホスト CLI については docker/04-cli.md を参照してください。
3. プロキシ：proxy/01-config.md を読みます。ユーザーのプロキシサービス、ボックスごとの予算、各サービスのコストが設定された $AGENTBOX_HOME/config/proxy.json が存在することを確認します。存在しない場合はユーザーに提示を求めます（認証情報や価格を決して捏造しないでください）。ボックスはプロキシなしでも、ダイレクトモードのみで動作します。
4. 誰かに指示を出す前に、構成要素を理解します（セッションごとに一度読み、以降はざっと目を通します）。
   • proxy/02-routing.md：ボックスからトラフィックがどのように送信されるか、proxy on|off、予算の適用について。
   • listener/README.md：リクエストに手を加えずに監視する方法について。
   • browser/browser.md：永続ブラウザーとその CLI について。
   • logs/logs.md：記録される内容、エージェントのジャーナル、タイムライン、監査について。
5. オーケストレーション：subagents/orchestrator.md に従います。subagents/subagent-prompt.md に記入し、プロキシのコスト表も含めて各サブエージェントに指示を出します。サブエージェントが従うべきエスカレーション手順は subagents/escalation.md にあります。
6. 監査と報告：サブエージェントが終了したら、そのトランスクリプトを収集し、タイムラインを作成して、すべての主張をリクエストログと照合します（logs/logs.md の「Audit」を参照）。その後にのみ報告します。
7. 終了処理：agentbox down <box> または agentbox down --all を実行します。実行記録はディスク上に保持されます。

フォルダーマップ

フォルダー	内容
docker/	事前チェック、ワークスペースのレイアウト、Dockerfile とイメージのビルド、ホスト CLI
proxy/	プロバイダーに依存しないプロキシ設定（認証情報、予算、サービスごとのコスト）、ブラウザートンネル、proxy コマンド、予算の計算
listener/	共有ログライブラリー、ブラウザーリスナー（CDP）、curl ラッパー、Python フック、reqlog
browser/	Chromium の起動フラグと browser コマンド
logs/	ログファイル、エージェントのジャーナル、トランスクリプトのインポート、タイムライン、主張の監査
subagents/	オーケストレーターの手順、サブエージェントのプロンプトテンプレート、エスカレーション手順

常に適用されるルール

• サブエージェントごとにボックスを 1 つ割り当てます。サブエージェント間でボックスを共有してはいけません。
• リスナーは監視のみを行います。トラフィック経路上に何も配置せず、ログ記録のために TLS を復号することもありません。
• プロキシはボックスごとにオプトイン（proxy on）で、予算によって上限が設定されています。予算を使い切ると、リクエストは HTTP 402 で失敗します。コストは設定された価格に基づく推定値です。正確な情報はプロバイダーのダッシュボードで確認してください。
• ログイン、ペイウォール、CAPTCHA を回避しようとしてはいけません。ブロックされているものと、その先にあるものを報告してください。
• 各サイトの利用規約とレート制限を遵守してください。ユーザーが収集を許可されているものだけをスクレイピングしてください。
• サブエージェントの「ブロックされた」または「利用できない」という主張は、エスカレーション手順のすべての段階で失敗したことがログに示されている場合にのみ認められます。