代理模式

自主 AI 编码代理，使用完整的工具独立探索、规划和执行复杂的代码库更改

Agent 是 Cursor 中的默认且最自主的模式，旨在以最少的指导处理复杂的编码任务。它启用了所有工具，可以自主探索您的代码库、阅读文档、浏览 Web、编辑文件和运行终端命令以高效完成任务。

代理模式 - 图1

​代理的能力

自主作

独立探索您的代码库，识别相关文件，并进行必要的更改

完全工具访问权限

使用所有可用工具搜索、编辑、创建文件和运行终端命令

情境理解

全面了解项目结构和依赖关系

多步骤规划

将复杂任务分解为可管理的步骤并按顺序执行

请务必阅读聊天概述 以了解有关模式在 Cursor 中的工作原理的更多信息。

​代理的工作流程

与人类非常相似，代理模式遵循系统的方法来完成任务：

1.了解请求

代理模式会分析您的请求和代码库的上下文，以完全理解任务要求和目标。

2.探索代码库

代理可以搜索您的代码库、文档和 Web 以识别相关文件并了解当前实现。

3.计划更改

根据分析，代理将任务分解为较小的步骤并规划更改，并在进行过程中从可用的上下文中学习。

4.执行更改

代理会根据整个代码库中的计划进行必要的代码修改，还可能会建议新的库、要运行的终端命令或您应该在 Cursor 之外执行的步骤。

5.验证结果

代理将确认更改在通过应用更改后看起来正确。如果它发现任何问题或 linter 错误（如果语言支持），它将尝试修复它们。

6.任务完成

一旦代理满意，它就会让步并总结它所做的更改。

代理模式在进行更改之前创建检查点，允许您根据需要进行还原。
了解有关检查点的更多信息。

​示例用例

为了获得最佳结果，请具体说明您要完成的任务，但您无需指定代理应如何处理任务。

  1. "Add a dark mode toggle to my React application"

代理模式将：

  1. 确定应用程序的样式方法
  2. 添加必要的主题状态管理
  3. Create toggle component （创建切换组件）
  4. 更新相关组件的样式
  5. 在适当的情况下添加持久性
  1. "Optimize my API calls to implement caching and reduce redundant requests"

代理模式将：

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

​配置选项

  • Select a Model（选择模型）：为代理模式预先选择模型
  • Edit Keybindings（编辑键绑定）：为代理模式设置键绑定
  • Toggle available tools（切换可用工具）：切换可用工具
  • 启用自动运行和自动修复错误：启用自动运行和自动修复错误（阅读有关工具设置的更多信息)

在启用自动运行的情况下使用代理模式时，请在确认主要修改之前仔细查看建议的更改。