# Agent Mode (/ja/docs/verdent-manager/advanced-features/agent-mode)

> すべてのアクションを完全に可視化したエージェント型タスク実行



Agent Mode は Verdent のデフォルト実行モードで、エージェントがあなたの指示に基づいて直接アクションを実行します。構造化された計画セッションではなく、Agent Mode は完全な透明性を保ちながら素早い実行を優先します。

## このページで学べること [#このページで学べること]

* Agent Mode が適切な選択となる場面
* 実行ワークフローの仕組み
* 権限と可視性の管理

***

## Agent Mode が役立つ場面 [#agent-mode-が役立つ場面]

Agent Mode は、何をすべきか明確になっているときに最も効果を発揮します。

| シナリオ         | 状況                                           | Verdent の役割                                |
| ------------ | -------------------------------------------- | ------------------------------------------ |
| **要件が明確**    | 何を実装したいか正確に把握している。タスクは明確に定義され、具体的な成果が定まっている。 | エージェントが直接実装を進めます。計画のオーバーヘッドなしに、結果だけを得られます。 |
| **素早い反復**    | 結果に基づいて段階的に変更を加える、高速なフィードバックループの中にいる。        | 高速な実行サイクルにより、変更をすぐに確認して方向を調整できます。          |
| **シンプルなタスク** | バグ修正、小さな機能、コードのクリーンアップ、スコープが明確なリファクタリングなど。   | エージェントが余計なやり取りなしに、効率的に作業を完了します。            |

***

## Agent Mode のワークフロー [#agent-mode-のワークフロー]

<Steps>
  <Step title="リクエストを送信する">
    やってほしいことを記述します。Agent Mode では、明確で具体的な指示が最も効果的です。
  </Step>

  <Step title="エージェントがアクションを実行する">
    Verdent はすぐに実装を開始します。ファイルの編集、ツールの使用、進捗がリアルタイムで表示されます。
  </Step>

  <Step title="権限の確認">
    一部のアクションには承認が必要です。確認のうえ承認して進めます。
  </Step>

  <Step title="結果を確認する">
    何がどのように変更されたかを完全に可視化した状態で、作業が完了します。
  </Step>
</Steps>

***

## 主な特徴 [#主な特徴]

| 特徴            | 説明                                            |
| ------------- | --------------------------------------------- |
| **デフォルトモード**  | Plan Mode に切り替えない限り、新しいタスクは Agent Mode で開始します |
| **直接アクション**   | エージェントは大がかりな計画ではなく、実装を直接進めます                  |
| **完全な可視性**    | ファイルの編集、ツールの使用、進捗がリアルタイムで表示されます               |
| **インラインでの確認** | 質問は構造化されたアンケートではなく、チャット内に自然に表示されます            |

***

## Agent Mode と Plan Mode の比較 [#agent-mode-と-plan-mode-の比較]

タスクの明確さと複雑さに応じて選びます。

<Tabs>
  <Tab title="Agent Mode を使う場面">
    Agent Mode は次のような場合に最適です。

    * 明確で十分に定義された要件
    * シンプルな実装タスク
    * 素早い反復とフィードバックループ
    * アプローチに自信があるタスク
    * バグ修正や小さな機能
  </Tab>

  <Tab title="Plan Mode を使う場面">
    次のような場合は Plan Mode に切り替えます。

    * 複雑で多段階の機能
    * 未完成または変化し続けるアイデア
    * アーキテクチャ上の判断
    * 実装前に探索が必要なタスク
    * 構造化された要件の明確化を行いたいとき
  </Tab>
</Tabs>

***

## Agent Mode における権限 [#agent-mode-における権限]

Agent Mode はタスクを直接実行しますが、一部のアクションには明示的な承認が必要です。

* 想定スコープ外のファイル変更
* 破壊的な操作
* 特定のツールの実行
* 重大な副作用を伴うアクション

<Note>
  権限の確認は、日常的な操作の実行速度を保ちながら、意図しない変更を防ぎます。
</Note>

***

## よくある質問 [#よくある質問]

<AccordionGroup>
  <Accordion title="Agent Mode はデフォルトですか?">
    はい。新しいタスクは Agent Mode で開始します。構造化された計画が必要な場合は Plan Mode に切り替えてください。
  </Accordion>

  <Accordion title="Agent Mode でエージェントは質問しますか?">
    はい、必要に応じて質問します。質問は構造化されたアンケートではなく、チャット内にインラインで表示されます。タスクが十分に明確な場合は、質問せずに進めることもあります。
  </Accordion>

  <Accordion title="Plan Mode への切り替え方法は?">
    `Shift+Tab`（macOS: `Cmd+.`、Windows: `Ctrl+.`）を押すとモードを切り替えられます。モードの切り替えは特定のタイミングで可能で、実行中はできません。
  </Accordion>

  <Accordion title="Agent Mode はすべての確認を省略しますか?">
    いいえ。一部のアクションには引き続き承認が必要です。Agent Mode は、重大な変更に対する安全性を保ちつつ、日常的な操作の手間を減らします。
  </Accordion>

  <Accordion title="代わりに Plan Mode を使うべきなのはどんなときですか?">
    複雑な機能、アーキテクチャ上の判断、または実装を始める前に要件を探索・洗練したい場合は Plan Mode を使用してください。
  </Accordion>
</AccordionGroup>