Agent 概览

Agent 是 Cursor 里能独立完成复杂编码任务、运行终端命令并编辑代码的助手，在侧边面板用 Cmd+I 打开。对于较大的工作（如一个功能或一次迁移），可以创建一个 Project：由协调者智能体规划工作并委派给其他智能体。

Agent 如何工作

一个智能体由三个部分构成：

1. 指令：引导智能体行为的系统提示和规则
2. 工具：文件编辑、代码库搜索、终端执行等
3. 模型：你为任务选的智能体模型

Cursor 的智能体为每个支持的模型编排这些部分，专门为每个前沿模型调整指令和工具；新模型发布时，你可以专注于构建软件，由 Cursor 处理模型特定的优化。

工具

工具是 Agent 的构建块，用来搜索你的代码库和网络以找到相关信息、编辑文件、运行终端命令等。Agent 在一个任务里可以进行的工具调用次数没有限制。

• 搜索文件和文件夹：按名称搜索文件、读取目录结构、在文件里查找精确的关键词或模式
• 网络：生成搜索查询并执行网络搜索
• 获取规则：按类型和描述检索特定规则
• 读取文件：智能读取文件内容，也支持图片文件（.png、.jpg、.gif、.webp、.svg），并把它们加入对话上下文供有视觉能力的模型分析
• 编辑文件：建议对文件的编辑并自动应用
• 运行 shell 命令：执行终端命令并监控输出；默认使用第一个可用的终端配置，要设置偏好的终端配置，打开命令面板（Cmd/Ctrl+Shift+P）搜索「Terminal: Select Default Profile」
• 浏览器：控制浏览器截屏、测试应用并验证视觉改动
• 图像生成：从文本描述或参考图像生成图像，默认保存到项目的 assets/ 文件夹并内联显示在聊天里
• 提问：任务期间提出澄清问题；等待你回答时，智能体继续读文件、做编辑或运行命令，你的回答一到就被纳入

检查点

检查点在 Agent 会话期间保存你代码库的快照。Agent 在做重大改动前自动创建它们，捕获所有被修改文件的状态。如果 Agent 走错了路，点击聊天时间线里的任何检查点预览那时的文件，然后恢复就能把所有文件还原到那个状态；也可以从之前请求上的 Restore Checkpoint 按钮或悬停在消息上时的 + 按钮恢复。检查点存储在本地，与 Git 分开，只用来撤销 Agent 的改动，永久的版本控制仍要用 Git。

排队的消息与引导

Agent 工作时有两种方式与它对话：排队一条消息，它等当前任务结束；或立即发送后续消息，它在智能体下一次工具调用时引导当前回合。

• 使用队列：Agent 工作时输入你的下一条指令，按 Enter 加入队列；消息按顺序显示在活动任务下方，可以拖动重新排序，Agent 完成后按顺序处理
• 快捷键：Agent 工作时按 Enter 排队（等 Agent 完成当前任务），按 Cmd+Enter 立即发送、绕过队列
• 引导运行中的智能体：可以在智能体工作时发送后续消息来引导它而不打断它：输入后续消息并点 Send now，或按两次 Enter。消息在智能体的下一次工具调用时送达，而不是在动作中途打断，保留了进行中的工作并让智能体保持在任务上。在 CLI 里，智能体工作时按 Enter 会在安全边界引导当前运行，再按一次 Enter 则中断该回合

Side chat 与对话搜索

打开 side chat，提问或调查一个旁支问题而不打断主对话：在聊天输入框里输入 /side 或 /btw（可后跟你的问题），或用聊天面板顶部的加号按钮。side chat 是持久的智能体对话：它把父线程用作隐藏的参考上下文并保存自己的转录，在主线程里 @ 提及该 side chat 可以把那个上下文拉回来。在 Agents Window 里搜索过去的智能体转录：Mac 上按 Cmd+K（Windows 和 Linux 上按 Ctrl+K）打开命令面板，在对话间搜索（Cursor 构建本地搜索索引）；在打开的对话里查找文本用 Cmd+F 或 Ctrl+F。

用 /goal 设定目标

Agent 把每条消息当作新工作。用 /goal 给智能体一个长期目标，让它持续朝着目标工作直到完全完成：

/goal fix all flaky tests and make CI green

在 CLI 里，Ctrl+C 暂停目标。把目标与 Custom Mode 搭配，当你想让智能体遵循某个手册时；或与内置的 /loop skill 搭配，按重复或可变的间隔运行某个提示或 skill（不指定固定间隔时由智能体选择何时唤醒，想结束时停止循环）。/goal 正在逐步推出，看不到时在新聊天里试试。