エージェントクライアントプロトコル (ACP)

1. AI チャットツールウィンドウを開きます。

2. をクリックしてチャットモードセレクターを開き、ACP レジストリからインストールオプションを選択します。

   

   または、設定 | ツール | AI Assistant | エージェントに移動します。

3. エージェントページで、使用するエージェントをインストールします。さらに、必要に応じて MCP 設定を構成します。

   

   • カスタム MCP サーバーをパスする – この設定を有効にすると、構成された MCP サーバーがインストールされたエージェントに公開されます。

   • IntelliJ MCP サーバーを通過 – この設定を有効にすると、統合された IntelliJ MCP サーバーがインストールされたエージェントに公開されます。

4. 変更を適用するには、OK をクリックします。

エージェントの更新

エージェントの新しいバージョンが利用可能になると、その横に青いドットが表示されます。

次のようにレジストリからエージェントを更新できます。

1. 設定 | ツール | AI Assistant | エージェントに移動します。

2. 利用可能な新しいバージョンのエージェントを見つけます。

3. 更新をクリックします。

   

4. 変更を適用するには、OK をクリックします。

エージェントをアンインストールする

エージェントをアンインストールするには:

1. 設定 | ツール | AI Assistant | エージェントに移動します。

2. アンインストールするエージェントを見つけます。

3. アンインストールをクリックします。

   

4. 変更を適用するには、OK をクリックします。

1. AI チャットツールウィンドウを開きます。

2. AI チャットツールウィンドウの右上隅にある ボタンをクリックし、カスタムエージェントの追加を選択します。

   

   このオプションを選択すると、~/.jetbrains/acp.json に acp.json ファイルが作成され、編集用に開きます。ここで、構成の詳細を指定する必要があります。

3. 設定ファイルにエージェントの詳細を入力します。必要に応じて複数のエージェントを追加できます。設定は以下の形式に従う必要があります。

   { "default_mcp_settings": {}, "agent_servers": { "Example Agent": { "command": "/path/to/agent", "args": [ "acp" ], "env": { "API_KEY": "your-api-key-here" } } } }

   • default_mcp_settings – エージェント固有の MCP 設定によって上書きされない限り、すべてのローカルエージェントに適用されるデフォルトの MCP 設定を定義します。2 つのオプションがあります。

     • use_custom_mcp –ユーザー設定の MCP サーバーをエージェントに公開するかどうかを制御します。デフォルトでは true に設定されています。

     • use_idea_mcp –統合された IntelliJ MCP サーバーをエージェントに公開するかどうかを制御します。デフォルトでは false に設定されています。このオプションを true に設定すると、idea_mcp_allowed_tools キーを指定することで、統合された MCP サーバーから利用できるツールを制限できます。指定しない場合は、統合された MCP サーバーから利用できるすべてのツールがエージェントに公開されます。

   • agent_servers – 設定されたすべてのエージェントを含む最上位オブジェクト。このオブジェクト内の各キーは、AI チャットに表示されるエージェントの表示名です。

   • Example Agent – エージェントを識別するために使用される表示名。

   • command – エージェント実行ファイルへのパス。AI Assistant はこのファイルをサブプロセスとして起動します。

   • args – エージェントの起動時に渡されるコマンドライン引数の配列。

   • env – エージェントプロセスに設定された環境変数のコレクション。

設定が完了すると、AI チャットでエージェントを選択できるようになります。追加されたエージェントは アイコンで表示されます。

設定されたエージェントを使用するには、リストからエージェントを選択し、プロンプトを入力して送信します。

1. メインメニューで、移動 | どこでも検索に移動するか、Shift を 2 回押して検索ウィンドウを開きます。

2. レジストリと入力し、Enter を押します。

3. 開いたダイアログで、Ctrl+F を使用して llm.agent.extended.logging キーを見つけて有効にします。

4. 変更を適用するには、閉じるをクリックして IDE を再起動します。

1. ログを収集します。

2. acp.json 構成をコピーします (コピーする前に機密情報を削除します)。

3. 問題を説明するスクリーンショットを撮るか、短いビデオを録画します。

4. YouTrack(英語) で問題を作成します。

5. スクリーンショット、ログ、構成ファイルを問題にアタッチしてください。