セルフホストワーカーリファレンス

このページでは、self_hosted環境を処理する事前構築済みのワーカーについて説明します。タスク指向のガイドについては、まずセルフホスト型サンドボックスとセルフホストワーカーをデプロイするを参照してください。

CLIコマンドとフラグ

環境変数

ホスト要件

メモリストアには独自の要件が追加されます。

サンドボックスのファイルシステム

セルフホスト環境では、セッションのシステムプロンプトから、Anthropic管理のサンドボックスで使用される/mnt/session/outputsの指示が省略されます。最終成果物は、エージェントがサンドボックスのファイルシステム内で書き込んだ場所（通常は作業ディレクトリ配下）に配置されます。

スキルには、エージェントが直接実行できる実行可能ファイルを含めることができます。CLIおよびSDKのワーカーは、スキルバンドルを展開する際に、バンドルに記録された実行権限を保持します。スキルのダウンロードを手動で実装する場合は、実行権限の設定はお客様の責任となります。

SDKヘルパー

Python、TypeScript、Go SDKは、制御レベルの異なる3つのヘルパーを提供します：

EnvironmentWorker

EnvironmentWorkerはAgentToolContextとツールセットを自動的に管理します。ツールリストをカスタマイズするには、toolsファクトリを渡します：

EnvironmentWorker(client, ..., tools=lambda env: [beta_bash_tool(env), my_custom_tool])

ワークポーラー

完全な例については、SDKポーラーからサンドボックスを起動するを参照してください。

セッションツールランナー

client.beta.sessions.events.tool_runner()は、ツールリストをtoolsとして受け取ります。そのリストを構築するには、AgentToolContextを自分でセットアップし、beta_agent_toolset_20260401(env)を呼び出します：

from anthropic.lib.tools.agent_toolset import (
    AgentToolContext,
    beta_agent_toolset_20260401,
)

async with AgentToolContext(
    workdir="/workspace", client=client, session_id=work.data.id
) as env:
    # スキルは /workspace/skills/<name>/ にダウンロードされます
    tools = beta_agent_toolset_20260401(env)

AgentToolContextとエージェントツールセット

AgentToolContextはツール呼び出しの実行コンテキストです。作業ディレクトリとパスポリシーを定義し、セッションのスキルをダウンロードできます。

EnvironmentWorkerは、セッションのメモリストアのディレクトリを自動的にallowed_rootsに追加し、access: "read_only"でアタッチされたストアのディレクトリをread_only_rootsに追加します。

この制限はファイルツールのみに対するガードレールであり、サンドボックスではありません。bashは制限されません。

beta_agent_toolset_20260401(env)はAgentToolContextを受け取り、標準のツール実装（bash、read、write、edit、glob、grep）を返します。