LangBot Docs
サンドボックス

ランタイムと拡張機能の関係

LangBot のランタイムと拡張を理解：Box Runtime・サンドボックスバックエンド・MCP サーバーの関係。

LangBot には プラグイン、MCP、Skills、サンドボックス という 4 種類の拡張機構が併存しており、混同されやすい部分です。本ページではそれぞれの役割と使い分けを整理します。

一行で区別する

  • Box 実行環境: Agent がコマンド実行やファイル読み書きを行う場所。隔離の有無は選択したバックエンドによる
  • Skills: オンデマンドで起動する指示パック。Agent に一時的に専門的なワークフローを追加する
  • MCP サーバー: 外部のツールサービスに接続する
  • プラグイン: 長期常駐する拡張プロセス。設定ページ、イベント監視、ナレッジベースを持てる

対応表

機能提供元Agent への入り方いつ使うか
Box 実行環境Box Runtimeexec/read/write/edit/glob/grep の 6 点セットを直接付与Agent がコード実行やファイル読み書きを行うとき
SkillsBox Runtime skill storeAgent が activate を呼び出した後、指示が Tool Result として注入されるAgent にワークフロー／テンプレート／スクリプトを追加し、必要時にのみ発火させたいとき
MCP サーバーLangBot MCP Loader（stdio モードは Box がホスト）ツールが利用可能ツール一覧に直接入る既存の MCP サービスに接続したいとき
プラグインPlugin Runtimeプラグインシステムから能力が公開される長期的な機能、設定ページ／イベント監視／ナレッジコンポーネントが必要なとき

パイプラインへのバインド

Skills、MCP サーバー、プラグインはすべて パイプライン拡張 に属します。WebUI でインストール／作成した後、パイプライン拡張設定で有効化範囲を決定する必要があります。

  • すべての拡張を有効化する、または
  • 指定した拡張のみをバインドする

Skills のバインドは Agent が どの Skill を見えるか を決定します（<available_skills> 一覧に影響）。具体的な Skill 内容は Agent が activate を呼び出した後にのみ注入されます。

バックエンドと隔離境界

Box API、Agent ツール、セッションスコープ、ライフサイクル、Skills、stdio MCP ホスティングの使い方は各バックエンドで同じですが、セキュリティ特性は異なります。Docker、nsjail、E2B はそれぞれのサンドボックス境界を提供します。Host は Box Runtime ホスト上のプロセスを直接使用し、信頼できるローカル開発専用です。Host を選択しても WebUI は変わらず、別々のセッションにホストレベルの隔離が追加されることもありません。

トラブルシューティングの入口

症状まず確認すること
Agent に exec/read/write ツールがないbox.enabled、バックエンドが利用可能か、パイプラインが組み込み Agent を使用しているか
Skill 一覧が空Box Runtime の状態、box.local.skills_root、パイプラインのバインド
stdio MCP の起動に失敗Box Runtime の状態、MCP コマンドと環境変数、起動タイムアウト
Docker デプロイでサンドボックスが起動しないlangbot_box が docker.sock をマウントしているか、Box ルートディレクトリのパスが一致しているか
ファイル読み書きに失敗box.local.host_root、box.local.allowed_mount_roots
バックエンド選択が効かないBOX__BACKEND が langbot_box ではなく langbot サービスに設定されているか確認
Host バックエンドが利用できないシステムが POSIX で、PATH に sh があることを確認。Windows では WSL を使用
外部 Host Box への接続が拒否されるLangBot と Box Runtime に同じ LANGBOT_BOX_CONTROL_TOKEN を設定

サンドボックスの組み込みツールと Skills は、現在は組み込み Agent 向けです。外部 Runner（Dify、n8n、Langflow、Coze など）では、各プラットフォーム独自のツールと実行機構を使用してください。

サンドボックス (Sandbox)

LangBot Box Runtime は組み込み Agent にコマンド・ファイルツールを提供し、サンドボックスまたは信頼済み Host バックエンドを選択可能。

サンドボックス設定

LangBot Box Runtime を設定し、Docker・nsjail・E2B、または明示的に有効化する非隔離 Host バックエンドを選択。

On this page

一行で区別する対応表パイプラインへのバインドバックエンドと隔離境界トラブルシューティングの入口