> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent モード

Agent モードは、自律的な意思決定、環境認識、ツール活用の機能を備えています。プロジェクト検索、ファイル編集、ターミナルアクセスなどのツールを用いて、コーディングタスクを効率的に実行できます。さらに、Model Context Protocol（MCP）ツールを構成して AI コーディングアシスタントの能力を拡張し、開発ワークフローにより適合させることができます。

Agent モードと Ask モードの主な違いは、Agent モードが常時の承認を求めることなく自律的に変更を適用できる点です。

Agent モードは、次の中核機能を提供します。

* プロジェクトレベルの変更: タスク記述に基づき、Agent モードはタスクを自律的に分解し、複数のコードファイルを変更できます。複数ターンの対話を通じて、コードの最適化やスナップショットのロールバックを行い、より効率的にタスクを完了できます。
* 計画作成: 入力内容に基づき、Agent モードはレビュー用のステップバイステップの計画を作成します。
* 自動環境認識: Agent モードは、タスク記述からプロジェクトのフレームワーク、テックスタック、必要なコードファイル、エラーメッセージを自動検出し、手動でプロジェクトの context を追加する必要をなくします。
* ツール活用: Agent モードは、ファイルの読み書き、コードクエリ、エラーのトラブルシューティングなど、さまざまな組み込みツールを自律的に使用します。MCP ツールの自動検出と利用にも対応します。
* コマンド実行: Agent モードは、実行すべきコマンドを自律的に判断し、コマンドを生成してターミナルで実行します。

<div id="plan">
  ## **プラン**
</div>

Agent は自律的に意図を認識し、複雑なタスクに対して自動的にプランを生成します。生成されたプランはレビュー用に提示され、確認後、プランに従って実行されます。Planning の詳細な動作については [Planning](./plan-agent) を参照してください。

<Tip>技術的なソリューションの厳密なすり合わせや複雑な手順を含む中・大規模タスクには、コードを記述する前に構造化ドキュメントを生成する、Quest ワークスペースの [Spec 駆動](/ja/user-guide/quest/spec-driven) モードを使用することをお勧めします。</Tip>

<div id="make-plans-by-to-dos">
  ## **To-dos を使ってプランを作成する**
</div>

入力内容に基づいて、Qoder は To-dos を含むプランを生成し、複雑な問題を管理可能で順次実行できるステップに分解してレビュー用に提示します。手順を追加したい場合は、要件を入力するだけで、Qoder がプランに対応する To-dos を追加します。

チャットの下部で、各タスクの進捗を確認できます:

* 空の円 - タスクは未開始です。
* 読み込み中の円 - タスクは進行中です。
* チェックボックス - タスクは完了です。

<div id="code-modification-and-review">
  ## **コードの変更とレビュー**
</div>

<div id="multi-file-edits">
  ### **複数ファイルの編集**
</div>

Agent モードでは、Qoder が複数のコードファイルを変更する場合があります。各変更には「Generating（生成中）」と「Applying（適用中）」の 2 つの段階があります。ファイルの状態は、チャットボックスまたはワークスペースで確認できます：

* **生成中**: タスクの分解に基づいてコードの提案を生成します。
* **適用中**: 提案を元のファイルと統合し、変更ファイルを作成します。
* **適用済み**: コードの変更が完了し、レビュー待ちの状態です。

ファイルをクリックすると、提案の生成プロセスと変更の差分（diff）を表示できます。

<div id="review-accept-or-reject-modifications">
  ### **変更のレビュー、承認、または拒否**
</div>

**View Changes**（変更を表示）ボタンをクリックして、変更内容を比較します。その後、次の操作を行えます：

* 上下矢印を使用して移動し、現在のファイル内の変更を表示します。
* 各変更を承認または拒否します。
* ファイルレベルの操作領域にある「進む」・「戻る」矢印を使用して、変更されたファイル間を切り替えます。
* ファイルレベルで承認または拒否します。
* 変更ファイルを部分的に変更します。

<div id="multi-turn-iterations">
  ## **複数ターンの反復**
</div>

<div id="refine-requirements-in-multiple-turns">
  ### **複数回の対話で要件を磨き込む**
</div>

Agent モードでは、ひと区切りの対話を終えてコード変更を生成した後でも、追加の問い合わせを送って要件を補足・修正できます。Qoder は先に生成したコード変更を取り込み、更新後の要件を分析し、新しいコード変更ファイルを生成します。現在の会話で生成されたすべてのコード変更を取り消したい場合は、チャットストリーム内の **Revert** ボタンをクリックすると自動ロールバックがトリガーされます。

<div id="programming-tools">
  ## **プログラミングツール**
</div>

Agent モードは自律的に利用できる組み込みのプログラミングツールをサポートします。これらのツールは、ファイル検索、ファイル読取、ディレクトリの横断、セマンティックなシンボル取得、ファイルの変更、エラーメッセージの取得、コマンドの実行などをサポートします。Agent モードは、返された結果に基づいて次のアクションを計画することもできます。

<div id="execute-commands">
  ## **コマンドを実行する**
</div>

Agent モードは要件に基づいて自律的にコマンドを選択して実行します。既定では、各コマンドを実行する前に確認が必要です。

* **Run** をクリックすると、コマンドが実行されます。
* **Cancel** をクリックすると、コマンドの実行がスキップされます。

バックグラウンドで実行中のタスクには、"Running in Background" インジケーターが表示されます。Agent モードは他のタスクを続行し、必要に応じて出力を確認します。

自動コマンド実行の許可リストは **Qoder 設定** で構成可能です。ユーザーアイコンまたはキーボードショートカット（`⌘` `⇧` `,`（macOS）または `Ctrl` `Shift` `,`（Windows））を使用して **Qoder 設定** を開き、**Chat** に移動します。複数のコマンドを追加する場合は、カンマで区切ってください。

<div id="mcp-tools">
  ## **MCP tools**
</div>

Qoder の Agent モードは、MCP (Model Context Protocol) サービスと統合できます。Agent に独自の MCP サービスを構成することで、AI コーディングアシスタントの能力を拡張し、ワークフローにより適合させることができます。
また、Agent はサードパーティの MCP サービスのアプリケーションマーケットに接続し、必要な MCP サービスをワンクリックでインストールすることもできます。

詳細については、[MCP](/ja/user-guide/chat/model-context-protocol) を参照してください。