バックエンドマネージャー

バックエンドマネージャーは、すべてのバックエンド設定を管理する統一ダイアログである。これを通じて、バックエンド接続の追加、編集、削除、検証が可能である。

開き方

• メニュー: ツール → バックエンドマネージャー

インターフェースレイアウト

┌─────────────────────────────────────────────────┐
│  バックエンドマネージャー                  [キャンセル] [保存] │
├─────────────────────────────────────────────────┤
│  [ACP] [SkillRunner] [Generic HTTP]              │
├─────────────────────────────────────────────────┤
│  ACP                                   [ACPを追加] │
│                                                 │
│  ┌─ 表示名: [________]  ─┐               │
│  │  コマンド:      [________]    │               │
│  │  引数:    引数エディタ │             │
│  │  環境変数: 環境変数エディタ  │  [削除]  │
│  └──────────────────────────────┘               │
│                                                 │
│  ┌─ 表示名: [________]  ─┐               │
│  │  ...                       │  [削除]      │
│  └──────────────────────────────┘               │
└─────────────────────────────────────────────────┘

一般操作

タブの切り替え

ダイアログの上部にACP、SkillRunner、Generic HTTPの3つのタブがある。タブをクリックすると、対応するバックエンドタイプ設定エリアに切り替わる。各タブにはそのタイプの設定済みバックエンドがすべてリストされる。

バックエンドの追加

タブの下の追加ボタンをクリックすると、そのタイプの新しい空の設定行が作成される。フィールドに入力し、右下の保存をクリックして適用する。

バックエンドの編集

設定行内でフィールドを直接修正する。未保存の変更は有効にならない。

バックエンドの削除

設定行内の削除ボタンをクリックすると、そのバックエンドが削除される。削除は保存後に有効になる。

保存とキャンセル

ボタン	場所	機能
保存	ダイアログの右下	すべての変更を保存してダイアログを閉じる
キャンセル	ダイアログの右下（保存の隣）	未保存の変更をすべて破棄してダイアログを閉じる

ダイアログを閉じる前に未保存の変更がある場合、確認プロンプトが表示される。

---

ACPタブ

ACPバックエンドはローカルで動作するエージェントサブプロセスである。設定で起動コマンドを指定し、プラグインがプロセスライフサイクルを管理する。

フィールドの説明

フィールド	必須	説明
表示名	はい	バックエンドの表示名。ダッシュボードやサイドバーでの識別に使用
コマンド	はい	ACPバックエンドを起動するコマンド（例：npx -y opencode-ai@latest acp）
引数	いいえ	コマンドの追加引数。引数エディタを通じて1つずつ追加
環境変数	いいえ	追加の環境変数。環境変数エディタを通じて1つずつ追加（キーと値のペア）

ACPプリセット

ACPタブの上部にプリセットから追加ボタンがある。クリックするとプリセット設定ウィンドウが開く：左側で Agent を選択し、右側に起動オプションと読み取り専用設定プレビューが表示される。確認をクリックすると、プラグインはプレビュー内容に基づいて通常の ACP 設定行を追加する。キャンセルをクリックすると現在の設定は変更されない。

• npx で起動: チェックすると npx <package> 形式で起動し、Node.js と npm のインストールが必要な旨のメッセージと Node.js 公式サイトへのリンクが表示される。Codex と Claude Code は ACP adapter に依存しているため、デフォルトでチェックされている。その他の Agent はデフォルトでチェックされていない。
• 隔離環境: 隔離をサポートする Agent でのみ利用可能。チェックすると、プレビューに対応する環境変数が注入され、その隔離ディレクトリ内で Agent のオプションと認証を自分で管理する必要がある旨のメッセージが表示される。

プレビューエリアは読み取り専用で、Profile ID、表示名、コマンド、パラメータ、環境変数、Agent Family が含まれる。追加された設定行は通常の ACP バックエンドとして引き続き編集可能。

組み込みプリセットのデフォルトコマンド：

プリセット	デフォルトコマンド	説明
OpenCode	opencode acp	OpenCode ACP バックエンド。OPENCODE_CONFIG_DIR による設定ディレクトリの隔離をサポート
Codex	npx -y @agentclientprotocol/codex-acp@latest	OpenAI Codex 向け ACP adapter
Claude Code	npx -y @agentclientprotocol/claude-agent-acp@latest	Claude Code 向け ACP adapter
Gemini CLI	gemini --experimental-acp	Gemini CLI ACP モード
Hermes	hermes acp	Hermes Agent ACP バックエンド
Qwen Code	qwen --acp --experimental-skills	Qwen Code ACP モード
GitHub Copilot	copilot --acp --stdio	GitHub Copilot CLI ACP モード
Qoder CLI	qodercli --acp	Qoder CLI ACP モード。QODER_CONFIG_DIR による設定ディレクトリの隔離をサポート
Cursor Agent ACP	cursor-agent-acp	Cursor Agent ACP adapter。--session-dir によるセッションディレクトリの隔離をサポート
DeepAgents	deepagents-acp	DeepAgents ACP adapter
Auggie	auggie --acp	Auggie ACP モード
Kilo	kilo acp	Kilo Code ACP モード
Cline	cline --acp	Cline ACP モード
CodeBuddy	codebuddy --acp	CodeBuddy ACP モード
Grok	grok agent stdio	Grok agent stdio モード

OpenCode、Codex、Claude Code、Gemini CLI、Qwen Code、Hermes Agent のみがテスト済み。その他の ACP バックエンドの可用性は各実装に依存し、本プラグインでは保証しない。

アクションボタン

ボタン	機能
実行時オプションを更新	バックエンドのモデルリスト、モードリスト、その他の実行時機能を再検出

引数エディタ

引数を追加: 追加ボタンをクリックし、引数の内容を入力する。 引数を削除: 引数の隣の削除ボタンをクリックする。

環境変数エディタ

環境変数を追加: 追加ボタンをクリックし、キーと値を入力する。 環境変数を削除: 変数の隣の削除ボタンをクリックする。

---

SkillRunnerタブ

SkillRunnerバックエンドはHTTP APIを介してSkill-Runnerサービスと通信し、ローカルとリモートの両方のデプロイモードをサポートする。

フィールドの説明

フィールド	必須	説明
表示名	はい	バックエンドの表示名
Base URL	はい	Skill-Runnerサービスのアドレス（例：http://127.0.0.1:29813）
認証	いいえ	none（認証なし）またはbearer（Bearer Token認証）を選択
認証トークン	いいえ	Bearer Token（認証がbearerに設定されている場合のみ入力）
タイムアウト	いいえ	リクエストタイムアウト（ミリ秒）

アクションボタン

ボタン	機能
管理UIを開く	Skill-Runner組み込みWeb管理インターフェースを開く
モデルキャッシュを更新	このバックエンドのモデルリストキャッシュをリフレッシュ

---

Generic HTTPタブ

Generic HTTPバックエンドは任意のHTTPサービスにリクエストを送信するために使用される。主に外部APIの呼び出し（MinerUドキュメント解析サービスなど）に用いられる。

フィールドの説明

フィールド	必須	説明
表示名	はい	バックエンドの表示名
Base URL	はい	HTTPサービスのベースアドレス
認証	いいえ	noneまたはbearerを選択
認証トークン	いいえ	Bearer Token（認証がbearerに設定されている場合のみ入力）
タイムアウト	いいえ	リクエストタイムアウト（ミリ秒）

バックエンド機能検出

バックエンドを保存すると、プラグインはバックグラウンドでバックエンドの機能を自動的に検出する。

• ACP: コマンドの可用性、接続初期化、モデルリスト、モードリストを確認し、以降の変更を検出するための設定フィンガープリントを計算
• SkillRunner: APIの可用性、エンジンリスト、モデルリストを確認
• Generic HTTP: HTTPエンドポイントの到達可能性を確認

検出結果は、ダッシュボードやサイドバーのバックエンドステータスインジケータとして表示される。

次のステップ

設定完了後、以下が可能である。

• ACPチャットまたはACP SkillsでACPバックエンドを使用
• SkillRunnerタブを通じてSkillRunner実行を管理
• 設定したバックエンドを使用してWorkflowリストとダッシュボードでタスクを実行