跳到主要内容

Agent 模式

Agent 是 Cursor 中默认且自主性最强的模式，专为以最小化指导完成复杂编码任务而设计。该模式启用了所有工具，能够自主探索代码库、阅读文档、浏览网页、编辑文件以及运行终端命令，从而高效完成任务。

Agent 的核心能力​

🤖

自主运行

自动探索您的代码库，识别相关文件并独立执行必要修改

🛠️

完整工具链支持

支持使用所有可用工具进行文件搜索、编辑、创建以及终端命令执行

🧠

上下文感知

深度理解项目架构与依赖关系，确保修改合理

🗂️

多步骤规划

将复杂任务拆解为可执行步骤并按序完成


提示

建议阅读 chat 功能概述 以深入了解 Cursor 的工作模式。

Agent 模式的工作流程​

与人类工作方式相似，代理模式通过系统化的步骤完成任务：

1

理解请求

代理模式会分析你的请求以及代码库的上下文，全面理解任务需求和目标。通过智能解析，准确把握开发意图和预期结果。

2

探索代码库

代理可能会检索你的代码库、文档以及网络资源，以定位相关文件并理解当前实现方案。深度分析项目结构和依赖关系。

3

制定修改计划

基于分析结果，代理会将任务拆解为多个步骤，并根据可用上下文持续学习来规划代码修改方案。确保修改的逻辑性和完整性。

4

执行修改

代理按照计划对整个代码库进行必要的代码调整，可能还会建议引入新库、需要运行的终端命令或在 Cursor 之外应执行的操作步骤。

5

验证结果

代理在完成修改后，会通过应用更改来确认变更的正确性。如果发现任何问题或 linter 错误（当语言支持时），它将尝试自动修复。

6

任务完成

当代理确认无误后，将结束任务并总结所做的修改内容。提供清晰的变更报告，确保开发者了解所有修改细节。

信息

代理模式在修改前会创建检查点，方便你在需要时进行回滚。了解更多关于检查点的信息。

示例用例​

提示

最佳实践：明确说明您想要实现的目标，但无需指定代理应如何执行任务。

"为我的 React 应用添加深色模式切换功能"

代理模式将执行以下操作：

  1. 识别应用的样式方案
  2. 添加必要的主题状态管理
  3. 创建切换组件
  4. 更新相关组件的样式
  5. 根据需要添加持久化存储
"优化 API 调用，实现缓存机制并减少冗余请求"

代理模式将执行以下操作：

  1. 定位所有 API 调用位置
  2. 实施合适的缓存策略
  3. 添加缓存失效逻辑
  4. 更新组件以使用缓存数据

配置选项​

  • 选择模型：预选代理模式使用的模型
  • 编辑快捷键：设置代理模式的快捷键绑定
  • 切换可用工具：启用或禁用可用工具
  • 启用自动运行和错误自动修复：开启自动执行与错误修复功能（详细了解工具设置）
注意

当启用自动运行的代理模式时，在确认重大修改前请仔细审查建议的更改。