> ## 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 模式

智能体模式具备自主决策、环境感知与工具调度能力。它可利用项目搜索、文件编辑、终端访问等工具，高效完成编码任务。此外，你可以配置模型上下文协议（MCP）工具，进一步扩展 AI 编码助手的能力，使其更契合开发工作流。

智能体模式提供以下核心功能：

* 项目级更改：基于任务描述，智能体模式可自主拆解任务并修改多个代码文件。通过多轮对话，可进行代码优化或快照回滚，更高效地完成任务。
* 计划制定：基于你的输入，智能体模式可创建分步计划供你审阅。
* 自动环境感知：智能体模式会从任务描述中自动检测项目框架、技术栈、所需代码文件及错误信息，无需手动补充项目 context。
* 工具使用：智能体模式可自主使用多种内置工具，如文件读写、代码查询与错误排查，也支持自动发现并使用 MCP 工具。
* 命令执行：智能体模式会自主决定需要执行的命令，并在终端中生成并运行这些命令。

<div id="plan">
  ## **规划**
</div>

Agent 会根据自主意图识别,针对复杂任务自动生成一份方案和规划。生成的规划方案会展示给你审阅,确认后即可按照规划执行。若希望了解 Planning 的详细工作机制,可参阅 [规划(Planning)](./plan-agent)。

<Tip>对于需要严格对齐技术方案或包含复杂步骤的中大型任务，推荐使用 Quest 工作区中的 [Spec 驱动](/zh/user-guide/quest/spec-driven) 模式，在写代码前先生成结构化设计文档。</Tip>

<div id="make-plans-by-to-dos">
  ## **通过待办事项制定计划**
</div>

基于你的输入，Qoder 会生成一个包含待办事项的计划供你审阅，将复杂问题拆解为可管理的、按顺序执行的步骤。如果你想添加更多步骤，只需补充你的需求，Qoder 会将相应的待办事项添加到计划中。

在聊天窗口底部，你可以查看每个任务的进度：

* 空心圆圈：任务尚未开始。
* 旋转圆圈：任务进行中。
* 复选框：任务已完成。

<div id="code-modification-and-review">
  ## **代码修改与评审**
</div>

<div id="multi-file-edits">
  ### **多文件编辑**
</div>

在智能体模式下，Qoder 可能会修改多个代码文件。每项修改包含“生成”和“应用”两个阶段，你可以在聊天框或工作区查看文件状态：

* **正在生成**：基于任务拆解生成代码建议。
* **正在应用**：将建议与原始文件集成，生成变更文件。
* **已应用**：代码变更已完成，等待审阅。

点击文件可查看建议生成过程和变更差异对比（diff）。

<div id="review-accept-or-reject-modifications">
  ### **审阅、接受或拒绝修改**
</div>

点击 **查看变更** 按钮对比修改，然后：

* 使用上下箭头在当前文件中导航查看变更。
* 针对每处变更选择接受或拒绝。
* 使用文件级操作区的前进/后退箭头在变更文件间切换。
* 在文件级操作区批量接受或拒绝。
* 对变更文件进行部分修改。

<div id="multi-turn-iterations">
  ## **多轮交互迭代**
</div>

<div id="refine-requirements-in-multiple-turns">
  ### **通过多轮对话细化需求**
</div>

在智能体模式下，完成当前会话并生成代码更改后，你可以继续提交补充查询来完善需求。Qoder 会合并先前的代码更改，分析更新后的需求，并生成新的代码更改文件。如需撤销当前会话产生的全部代码变更，点击对话流中的 **Revert** 按钮即可触发自动回滚。

<div id="programming-tools">
  ## **编程工具**
</div>

Qoder 为 智能体模式提供了丰富的编程工具，可由其自主使用。这些工具支持文件搜索、文件读取、目录遍历、语义符号检索、文件修改、错误信息获取、命令执行等。智能体模式还可以根据返回结果规划下一步操作。

<div id="execute-commands">
  ## **执行命令**
</div>

智能体模式会根据需求自主选择并运行命令。默认情况下，每条命令执行前需进行确认。

* 若点击 **执行**，智能体模式将提交并执行该命令。
* 若点击 **取消**，智能体模式将跳过该命令，并根据指示进行下一步。

对于在后台运行的任务，会显示“在后台执行”指示器。智能体模式会继续处理其他任务，并在需要时返回检查输出。

可在 **Qoder 设置** 中配置自动执行命令的允许列表。点击用户图标或使用键盘快捷键（`⌘` `⇧` `,`（macOS）或 `Ctrl` `Shift` `,`（Windows）），选择 **Qoder 设置**，然后进入 **智能会话**。添加多个命令时，请用逗号分隔。

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

Qoder 的智能体模式可与 MCP（Model Context Protocol）服务集成。你可以为智能体配置自有 MCP 服务，扩展 AI 编码助手的能力，使其更契合你的工作方式。
智能体还可连接第三方 MCP 服务的应用市场，一键安装所需的 MCP 服务。

详情请参阅 [MCP](/zh/user-guide/chat/model-context-protocol)。