# Agent Mode (/zh-Hant/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>