Agent 模式
Agent 是 Cherri Code 的 AI 助手，可搜索您的代码库、编辑多个文件、运行终端命令，并自行修复错误。
Agent 模式可以做什么？
Agent 可以从零构建功能、重构现有代码、修复缺陷、编写测试并运行 shell 命令。只需用自然语言描述任务，它就会自行判断要读取哪些文件、需要做出哪些更改，以及如何验证结果。
如何开始使用 Agent？
- 打开 Agent 面板：
- Mac：按 CmdCtrl + I
- Windows/Linux：按 Ctrl + I
- 输入您的请求，并明确说明您想要实现的内容。例如：“在首页添加一个包含电子邮件和密码字段的登录表单。”
- 按 ReturnEnter。Agent 会开始分析您的代码库并进行更改。
- 在 diff 视图中查看实时显示的更改。
您也可以通过浏览器访问 cursor.com/agents，使用 Cloud Agents 运行智能体。
如何中断 Agent？
点击 Stop 按钮可在 Agent 执行任务过程中将其停止。随后你可以调整方向或尝试其他方案。
如何评审 Agent 的更改？
Agent 会在工作过程中应用编辑。请在 diff 视图中检查这些编辑，并拒绝不需要的更改。对于 PR 级别的评审，Bugbot 可以自动发现缺陷和安全问题。
如何撤销智能体所做的更改？
将鼠标悬停在之前的消息上，然后点击右下角的 恢复检查点，即可回滚智能体在该检查点之后所做的所有更改。恢复只会还原文件；不会从对话中移除消息。要缩短对话本身，请从较早的消息分叉聊天。
Agent 可以将任务委派给子智能体吗？
可以。Agent 可以启动专门的子智能体，并行进行研究、执行 shell 命令或与浏览器交互。每个子智能体都在独立的上下文窗口中运行，并将结果返回给主对话。你还可以通过在 .cursor/agents/ 中添加 markdown 文件来创建自定义子智能体。
Agent 可以生成图像吗？
可以。Agent 可以根据文本描述或参考图像生成图像，适用于 UI 原型、产品素材或架构图。生成的图像会保存到你的项目中，并直接显示在聊天中。
Agent 工作时，我可以将后续消息加入队列吗？
可以。Agent 忙碌时，你可以提交下一条指令。你的消息会在队列中等待，并在当前任务完成后自动执行。你可以拖动调整队列中消息的顺序。
Agent 可以搜索我过去的对话来获取上下文吗？
可以。对话搜索可作为智能体工具使用。当 Agent 需要你之前讨论过的内容作为上下文时，它可以自行搜索你过去的对话。你无需记得具体在哪个聊天中。
我该使用哪种模式？
| 模式 | 最适合用于 | 可以编辑文件？ |
|---|---|---|
| Agent | 构建功能、重构、修复缺陷 | 是 |
| Ask | 理解代码、探索架构 | 否 (只读) |
| Plan | 希望先评审方案的复杂功能 | 是 (批准方案后) |
| Debug | 需要运行时证据的棘手缺陷 | 是 |
大多数任务都使用 Agent。想在不更改代码的情况下获取答案时，切换到 Ask。对于需要先评审方案的多文件功能，使用 Plan。对于难以复现或理解的缺陷，使用 Debug。
如何切换模式？
- 按 Shift + Tab 在各模式间循环切换
- 点击 Agent 面板中的模式选择器下拉菜单
每种模式都使用独立的上下文，因此切换模式会开启新的上下文窗口。更换任务时，建议新建聊天以获得最佳效果。
规则在所有模式下都生效吗？
是。项目规则、用户规则和团队规则适用于 Agent、Ask、Plan 和调试模式。无论使用哪种模式，每次对话都会包含这些规则。