开始使用
安装
- 前往 Cursor integrations
- 点击 Slack 旁边的 Connect 或从这里前往 installation page
- 系统将提示您在工作区中安装 Cursor 应用程序。
-
在 Slack 中安装后,您将被重定向回 Cursor 以完成设置
- 连接 GitHub(如果尚未连接)并选择默认存储库
- 启用基于使用量的定价
- 确认隐私设置
- 通过提及 @Cursor 开始在 Slack 中使用 Background Agents
如何使用
提及 @Cursor 并给出您的提示。这可以处理大多数用例,但您也可以使用下面的命令来自定义您的代理。 例如,在对话中直接提及 @Cursor fix the login bug,或使用特定命令如 @Cursor [repo=torvalds/linux] fix bug 来针对特定的仓库。命令
运行 @Cursor help 获取最新的命令列表。| 命令 | 描述 | |:--------|:------------| |
@Cursor [prompt] | 启动后台代理。
在已有代理的线程中,添加后续指令 | |
@Cursor settings | 配置默认设置和
频道的默认仓库 | |
@Cursor [options] [prompt] | 使用高级
选项:
branch
、model
、repo
| |
@Cursor agent [prompt] | 在线程中强制创建新
代理 | | @Cursor list my agents
| 显示您正在运行的代理 |选项
使用这些选项自定义后台代理行为:| 选项 | 描述 | 示例 | |:-------|:------------|:--------| |
branch
| 指定基础分支 | branch=main
| | model
| 选择 AI 模型 |
model=o3
| | repo
| 针对特定仓库 | repo=owner/repo
| |
autopr
| 启用/禁用自动 PR 创建 | autopr=false
|语法格式
以多种方式使用选项:- 括号格式 @Cursor [branch=dev, model=o3, repo=owner/repo, autopr=false] Fix the login bug
- 内联格式 @Cursor branch=dev model=o3 repo=owner/repo autopr=false Fix the login bug
选项优先级
组合选项时:- 显式值覆盖默认值
- 后面的值覆盖前面重复的值
- 内联选项优先于设置模态框默认值
使用线程上下文
后台代理理解并使用现有线程讨论的上下文。当您的团队讨论问题并希望代理基于该对话实现解决方案时很有用。S
Sarah2:30 PM
嘿团队,我们收到报告说用户在最新部署后无法登录
M
Mike2:32 PM
我检查了日志 - 看起来 auth.js 第 247 行的认证令牌验证失败了
A
Alex2:33 PM
哦,我觉得是因为我们改变了令牌格式但没有更新验证正则表达式
S
Sarah2:35 PM
是的,正则表达式仍然期望旧格式。我们需要更新它以处理新旧格式,以保持向后兼容性
Y
You2:36 PM
@Cursor fix this
⏳1
后台代理在被调用时会读取整个线程的上下文,
理解并基于团队讨论实现解决方案。
何时使用强制命令
我什么时候需要 @Cursor agent? 在已有代理的线程中,@Cursor [prompt] 添加后续指令(仅在您拥有该代理时有效)。使用 @Cursor agent [prompt] 启动单独的代理。 我什么时候需要Add follow-up
(来自上下文菜单)?
使用代理响应上的上下文菜单(⋯)进行后续指令。当线程中存在多个代理且您需要指定要跟进哪个代理时很有用。
状态更新和交接
当后台代理运行时,您首先会得到一个 在 Cursor 中打开 的选项。

管理代理
要查看所有正在运行的代理,请运行 @Cursor list my agents。 通过点击任何代理消息上的三个点(⋯)使用上下文菜单来管理 Background Agent。
- 添加后续指令:向现有代理添加指令
- 删除:停止并归档 Background Agent
- 查看请求 ID:查看用于故障排除的唯一请求 ID(联系支持时请包含此信息)
- 提供反馈:提供关于代理性能的反馈
配置
从 Dashboard → Background Agents 管理默认设置和隐私选项。设置
默认模型
当没有使用 @Cursor [model=...] 明确指定模型时使用。查看设置了解可用选项。默认仓库
当没有指定仓库时使用。使用以下格式:https://github.com/org/repository
org/repository
如果您引用一个不存在的仓库,会显示为您没有访问权限。这会在 Background Agent 启动失败时的错误消息中显示。
基础分支
Background Agent 的起始分支。留空以使用仓库的默认分支(通常是main
)
频道设置
使用 @Cursor settings 在频道级别配置默认设置。这些设置是按团队设置的,会覆盖该频道中您的个人默认设置。 在以下情况下特别有用:- 不同频道处理不同的仓库
- 团队希望所有成员使用一致的设置
- 您希望避免在每个命令中指定仓库
- 在所需频道中运行 @Cursor settings
- 为该频道设置默认仓库
- 在该频道中使用 Background Agents 的所有团队成员都将使用这些默认设置
频道设置优先于个人默认设置,但可以被明确选项覆盖,如@Cursor [repo=...] [prompt]
隐私
Background Agents 支持隐私模式。 了解更多关于隐私模式或管理您的隐私设置。不支持隐私模式(旧版)。Background Agents 在运行时需要临时代码存储。
显示代理摘要
显示代理摘要和差异图像。可能包含文件路径或代码片段。可以开启/关闭。在外部频道中显示代理摘要
对于与其他工作区的 Slack Connect 或包含外部成员(如访客)的频道,选择是否在外部频道中显示代理摘要。权限
Cursor 请求以下 Slack 权限,以便 Background Agents 在您的工作区中正常工作:| 权限 | 描述 | |:-----------|:------------| |
app_mentions:read
| 检测 @提及以启动 Background Agents 并响应请求 | | channels:history
| 读取线程中的历史消息,为后续指令提供上下文 | | channels:join
| 在受邀或请求时自动加入公共频道 | | channels:read
| 访问频道元数据(ID 和名称)以发布回复和更新 | | chat:write
| 在代理完成时发送状态更新、完成通知和 PR 链接 | | files:read
| 下载共享文件(日志、截图、代码示例)以获取额外上下文 | | files:write
| 上传代理更改的可视化摘要以便快速审查 | | groups:history
| 读取私有频道中的历史消息,为多轮对话提供上下文 | | groups:read
| 访问私有频道元数据以发布响应并维持对话流程 | | im:history
| 访问直接消息历史记录,为持续对话提供上下文 | | im:read
| 读取直接消息元数据以识别参与者并维持正确的线程 | | im:write
| 发起直接消息以进行私人通知或个人沟通 | | mpim:history
| 访问群组直接消息历史记录以进行多参与者对话 | | mpim:read
| 读取群组直接消息元数据以向参与者发送消息并确保正确传递 | | reactions:read
| 观察表情符号反应以获取用户反馈和状态信号 | | reactions:write
| 添加表情符号反应来标记状态 - ⏳ 表示运行中,✅ 表示已完成,❌ 表示失败 | | team:read
| 识别工作区详细信息以分离安装并应用设置 | | users:read
| 将 Slack 用户与 Cursor 账户匹配以获取权限和安全访问 |