Skip to content

エージェントマネージャー

エージェントマネージャーは専用のコントロールパネルで、VJSPエージェントをインタラクティブなコマンドラインプロセスとして実行・監視します。以下の機能をサポートしています。

  • ローカルセッションの実行

  • 既存セッションの復元

  • パラレルモード(Gitワークツリーと互換性あり)による、安全で分離されたコード修正

  • 現在のコードリポジトリと一致するクラウド同期セッションの表示と再開

本ページの内容は、プラグインの実際の実装ロジックと完全に一致しています。

前提条件

  1. VJSPコマンドラインインターフェース(CLI)の最新バージョンをインストール/更新します — 詳細はCLI設定を参照してください。

  2. VS Codeでプロジェクトを開きます(ワークスペースが事前に作成されている必要があります)。

  3. 認証:プラグイン設定からログインを完了するか、VJSPをサービスプロバイダーとするCLIを使用します(詳細は認証要件のセクションを参照してください)。

エージェントマネージャーを開く

  • コマンドパレット:「VJSP: エージェントマネージャーを開く」と入力します。

  • VJSPインターフェースに該当するタイトル/メニュー項目がある場合、直接クリックしてマネージャーを開くことができます。

パネルはウェブビューとして開かれ、ウィンドウのフォーカスを切り替えてもアクティブな状態を維持します。

メッセージ送信、操作承認およびプロセス制御

  • 会話の継続:実行中のエージェントにフォローアップメッセージを送信します。

  • 操作承認:エージェントがツールの呼び出し、コマンドの実行、ブラウザの起動、またはMCPサーバーへの接続を要求した場合、画面に承認プロンプトが表示されます。

  • 承認または拒否を選択でき、必要に応じて短いメモを追加することもできます。

キャンセルと停止の違い

  • キャンセル:実行中のプロセスに構造化されたキャンセル命令を送信します(協調的な優雅な停止)。

  • 停止:基盤となるコマンドラインプロセスを強制終了し、プロセスの状態は自動的に「停止済み」に更新されます。

既存セッションの復元

ローカルセッションとリモートセッションの両方を後で再開することができます。

  • 対象のセッションが現在実行されていない場合、エージェントマネージャーは新しいコマンドラインプロセスを起動し、そのセッションの一意の識別子(ID)にリンクします。

  • 元のセッションのタグ情報は、可能な限り保持されます。

  • 送信する最初のフォローアップメッセージが、セッション復元の入力内容として使用されます。

パラレルモード

パラレルモードは、エージェントを分離されたGitワークツリーブランチで実行し、メインブランチのコードを冗長な修正から保護します。

  1. エージェントを起動する前に、「パラレルモード」のスイッチをオンにします。

  2. プラグインは、既存のワークツリー内でのパラレルモードの使用を禁止します。

  3. この機能を使用するには、メインコードリポジトリ(.gitフォルダーを含むディレクトリ)を開く必要があります。

ワークツリーの保存パス

ワークツリーは、プロジェクトディレクトリ配下の.vjsp/worktrees/フォルダーに作成されます。このフォルダーは自動的にGitのローカル無視ルール(.git/info/exclude)に追加され、コードリポジトリにコミットする必要はありません。

plain

your-project/
├── .git/
│   └── info/
│       └── exclude   # Gitローカル無視ルール(.vjsp/worktrees/を含む)
├── .vjsp/
│   └── worktrees/
│       └── feature-branch-1234567890/   # 分離されたコード作業ディレクトリ
└── ...

実行中の状態表示

エージェントマネージャーは、以下の情報をリアルタイムで表示します。

  • 作成/使用中のブランチ名

  • ワークツリーの正確なパス

  • エージェントの実行が完了すると、ブランチのマージ/完了に関する操作ガイドラインが表示されます。

実行後の処理

  • ワークツリーは自動的にクリーンアップされますが、対応するブランチは保持されます。

  • バージョン管理(VCS)インターフェースで、そのブランチのコード修正を確認できます。

  • 必要に応じてブランチのマージまたはチェリーピックを実行し、コード修正を統合します。

パラレルモードのセッション復元

後でパラレルモードのセッションを復元する場合、プラグインは以下のロジックに従って実行します。

  1. 元のワークツリーがまだ存在する場合は、直接そのワークツリーを再利用します。

  2. 元のワークツリーがクリーンアップされている場合は、そのセッションにリンクされたブランチからワークツリーを再作成します。

認証要件

エージェントマネージャーの全機能(セッション同期を含む)を利用するには、有効な認証を完了する必要があります。

サポートされている認証方法

方法1:VJSPプラグイン(推奨)

  • プラグイン設定ページからログインを完了します。

  • エージェントマネージャーでシームレスな認証体験を提供します。

方法2:VJSPをサービスプロバイダーとするCLI

  • vjspをデフォルトのサービスプロバイダーとして設定したCLIを使用します。

  • vjsp configコマンドを実行し、認証設定を完了します。

  • 詳細はCLI設定を参照してください。

トラブルシューティング

プロンプト:「Please open a folder…」(フォルダーを開いてください…)

エージェントマネージャーはVS Codeのワークスペースフォルダーに依存しています。まずプロジェクトディレクトリを開いてください。

プロンプト:「Cannot use parallel mode from within a git worktree」(Gitワークツリー内ではパラレルモードを使用できません)

メインコードリポジトリ(.gitフォルダーを含むディレクトリ)を開く必要があります — ワークツリーのチェックアウトディレクトリではなく。

認証失敗

  • プラグイン設定からログインしたか、VJSPをサービスプロバイダーとするCLIを使用しているかを確認してください。

関連機能