智能体 Agent 模式使用指南 - Qoder 中文教程
智能体 Agent 模式具备自主决策、环境感知与工具调用能力，可借助项目搜索、文件编辑、终端访问等工具高效完成编码任务。您还可通过配置 Model Context Protocol（MCP）工具进一步扩展 AI 编码助手的能力，使其更贴合您的开发流程。
Agent 模式与 Ask 模式的核心区别在于：Agent 模式可在无需您反复确认的情况下，自主将改动应用到项目。
Agent 模式提供以下核心功能：
- 项目级变更：根据任务描述，自主拆解并同时修改多份代码文件；通过多轮对话实现代码优化或快照回滚，更高效地完成任务。
- 制定计划：根据您的输入生成可审阅的分步计划。
- 自动环境感知：自动识别项目框架、技术栈、所需代码文件及报错信息，无需手动补充上下文。
- 工具调用：自主使用文件读写、代码查询、错误排查等内置工具，并支持自动发现与调用 MCP 工具。
- 命令执行：智能体模式会自主决定需要执行的命令，并在终端中生成并运行这些命令。
通过待办事项 To-dos 制定计划
- Qoder 会根据您的需求生成一份包含待办清单（To-dos）的执行计划供您审阅。如需追加步骤，只需继续输入需求，Qoder 将自动补充对应 To-dos。
- 在聊天窗口底部，您可以实时查看每项任务的进度：
- 空心圆 — 任务尚未开始
- 加载圆 — 任务进行中
- 复选框 — 任务已完成
编程工具
Qoder 为 Agent 模式准备了丰富的编程工具，可自主完成文件搜索、读取、目录遍历、语义符号检索、文件修改、错误信息获取、命令执行等操作，并根据返回结果规划下一步行动。
执行命令
Agent 模式会根据需求自动选择并运行命令。默认情况下，每条命令在执行前均需您确认。
- 点击 Run，Agent 模式将发送该命令并执行。
- 点击 Cancel，Agent 模式将跳过该命令，并根据您的指示继续后续步骤。
对于后台运行的任务，界面会显示“Running in Background”标识。Agent 模式会继续处理其他任务，并在需要时回头检查输出结果。
您可在 Qoder 设置 Settings 中设置自动命令执行白名单。点击用户图标或使用快捷键 ⌘ ⇧ ,（macOS）/ Ctrl Shift ,（Windows），进入 Qoder Settings → Chat，在对应输入框填写允许自动执行的命令，多条命令以英文逗号分隔。
MCP 工具
若已配置 MCP 工具，Agent 模式将自主判断是否调用某 MCP 工具来完成任务，并在执行前征求您的确认。点击 执行 Execute 后，Agent 模式将调用该 MCP 工具，并将其返回结果作为后续步骤的上下文。
有关在 Qoder 中使用 MCP 的更多细节，请参见 MCP 文档。
一键优化提示词
Qoder 支持自动优化对话框内输入的提示词，并自动结合已添加的上下文、对话历史等相关信息，以进一步优化效果。
- 输入提示：在输入框中键入您的初步想法（例如：“添加工单升级功能”）。
- 点击“优化输入”按钮 ✨：Qoder 会基于您输入的内容，结合更丰富的上下文，生成详细且可操作的提示词。
- 查看并编辑：优化后的提示包含清晰的目标、约束条件和实现指导，您还可以根据需要进一步完善它。
- 撤销或提交：如有需要，可撤销增强操作，或提交优化后的提示以生成高质量的回应。