Agent Mode
代理模式
自主AI编程代理（Agent），可借助完整工具集独立探索、规划并执行复杂的代码库变更
Agent 是Cursor中默认且自主性最高的模式，旨在以最少指导完成复杂编码任务。该模式启用全部工具，可自主探索代码库、阅读文档、浏览网页、编辑文件以及运行终端命令，从而高效完成任务。
Agent的核心能力
自主操作
独立探索代码库，识别相关文件并执行必要修改
完整工具权限
使用全部可用工具进行文件搜索、编辑、创建及运行终端命令
上下文理解
全面构建项目结构和依赖关系的认知模型
多步骤规划
将复杂任务拆解为可执行步骤并按顺序实施
建议阅读聊天功能概述深入了解Cursor的模式运作机制。
Agent的工作流程
与人类工作方式相似，Agent模式遵循系统化任务处理流程：
- 理解需求
分析用户需求及代码库上下文，全面理解任务目标与要求 - 探索代码库
检索代码库、文档及网络资源，定位相关文件并理解当前实现 - 规划变更
基于分析结果将任务拆解为子步骤，结合上下文制定变更计划 - 执行变更
根据规划在代码库中实施修改，可能建议新增库、需运行的终端命令或Cursor外操作步骤 - 验证结果
通过应用变更确认修改正确性。若发现异常或语法错误（语言支持时），将尝试修复 - 任务完成
确认无误后交还控制权并汇总变更内容
Agent模式在执行变更前创建检查点（checkpoint），支持按需回滚操作。
了解更多检查点机制。
典型用例
为获得最佳效果，请明确任务目标但无需指定实现方式：
"为我的React应用添加深色模式切换功能"
Agent模式将：
- 识别应用样式方案
- 添加主题状态管理
- 创建切换组件
- 更新相关组件样式
- 按需添加状态持久化
"优化API调用，实现缓存机制并减少冗余请求"
Agent模式将：
- 定位所有API调用点
- 实施合适的缓存策略
- 添加缓存失效逻辑
- 更新组件使用缓存数据
配置选项
- 模型预选：为Agent模式预设模型
- 快捷键设置：配置Agent模式快捷键
- 工具开关：启用/禁用特定工具
- 自动运行与错误 修复：启用自动运行及错误修复功能（详见工具设置）
启用自动运行的Agent模式时，请务必在确认重大修改前仔细审查变更方案。