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

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

一行で区別する

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

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

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

症状	まず確認すること
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` サービスに設定されているか確認

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