借助 Cursor 的 Slack 集成,你可以在 Slack 中直接通过提及 @Cursor 并附上提示,使用 Background Agents 处理任务。

开始上手

安装

  1. 前往 Cursor 集成
  2. 点击 Slack 旁的 Connect,或从这里进入安装页面
  3. 系统会提示你在工作区安装用于 Slack 的 Cursor 应用
  4. 在 Slack 中安装完成后,你会被重定向回 Cursor 完成最后设置
    1. 连接 GitHub(若尚未连接)并选择一个默认仓库
    2. 启用按用量计费
    3. 确认隐私设置
  5. 在 Slack 中通过提及 @Cursor 开始使用 Background Agents

使用方法

@ 提及 @Cursor 并输入你的提示词。这个方式适用于大多数用例;你也可以用下面的命令来自定义你的 agent。 比如,在对话里直接提及 @Cursor fix the login bug,或者用 @Cursor [repo=torvalds/linux] fix bug 这样的命令来指定某个仓库。

命令

运行 @Cursor help 获取最新命令列表。
CommandDescription
@Cursor [prompt]启动一个 Background Agent。在已有 agent 的线程中,会添加后续指令
@Cursor settings配置默认值和频道的默认仓库
@Cursor [options] [prompt]使用高级选项:branchmodelrepo
@Cursor agent [prompt]在线程中强制创建一个新 agent
@Cursor list my agents显示你正在运行的 agents

选项

用这些选项自定义 Background Agent 的行为:
OptionDescriptionExample
branch指定基准分支branch=main
model选择 AI 模型model=o3
repo指定目标仓库repo=owner/repo
autopr启用/禁用自动创建 PRautopr=false
语法格式
选项可按以下方式使用:
  1. 方括号格式 @Cursor [branch=dev, model=o3, repo=owner/repo, autopr=false] Fix the login bug
  2. 行内格式 @Cursor branch=dev model=o3 repo=owner/repo autopr=false Fix the login bug
选项优先级
组合使用选项时:
  • 显式值会覆盖默认值
  • 若有重复,后面的值覆盖前面的值
  • 行内选项优先于设置弹窗中的默认值
机器人会从消息的任意位置解析选项,支持自然书写命令。

使用线程上下文

Background Agents 会读取并利用现有线程的讨论上下文。当团队讨论某个问题、而你想让 agent 基于这段对话来实现方案时,这很实用。
S
Sarah2:30 PM
Hey team, we're getting reports that users can't log in after the latest deploy
M
Mike2:32 PM
I checked the logs - looks like the auth token validation is failing on line 247 of auth.js
A
Alex2:33 PM
Oh, I think it's because we changed the token format but didn't update the validation regex
S
Sarah2:35 PM
Yeah, the regex still expects the old format. We need to update it to handle both old and new formats for backwards compatibility
Y
You2:36 PM
@Cursor fix this
1
Background Agents 在被调用时会读取整个线程的上下文, 并基于团队的讨论来理解并实现解决方案。

何时使用强制命令

什么时候需要 @Cursor agent 在已有 agent 的线程中,@Cursor [prompt] 会添加后续指令(仅当你拥有该 agent 时有效)。使用 @Cursor agent [prompt] 来启动一个独立的 agent。 什么时候需要使用 Add follow-up(来自上下文菜单)? 在 agent 的回复上用上下文菜单(⋯)添加后续指令。当一个线程里有多个 agent、而你需要指定要跟进哪一个时,这很有用。

状态更新与交接

当 Background Agent 开始运行时,你会先看到一个 Open in Cursor 的选项。
当 Background Agent 运行完成时,你会在 Slack 收到通知,并可选择在 GitHub 查看创建的 PR。

管理 agents

要查看所有正在运行的 agents,运行 @Cursor list my agents 在任意 agent 消息上点击省略号(⋯)打开上下文菜单来管理 Background Agents。
可用选项:
  • Add follow-up:为现有 agent 添加后续指令
  • Delete:停止并归档该 Background Agent
  • View request ID:查看用于故障排查的唯一请求 ID(联系支持时请附上)
  • Give feedback:对 agent 的表现提交反馈

配置

Dashboard → Background Agents 管理默认设置和隐私选项。

设置

默认模型

当没有通过 @Cursor [model=...] 明确指定模型时使用。可用选项见设置

默认仓库

在未指定仓库时使用。请使用以下格式:
  • https://github.com/org/repository
  • org/repository
如果你引用了不存在的仓库,会看起来像是没有访问权限。 当 Background Agent 启动失败时,错误信息中会显示这一点。

基础分支

Background Agent 的起始分支。留空则使用仓库的默认分支(通常为 main)。

频道设置

使用 @Cursor settings 在频道级别配置默认设置。这些设置按团队生效,并会覆盖你在该频道的个人默认值。 在以下情况下特别有用:
  • 不同频道使用不同的仓库
  • 团队希望所有成员保持一致的设置
  • 你想避免在每条命令中都指定仓库
配置频道设置的方法:
  1. 在目标频道运行 @Cursor settings
  2. 为该频道设置默认仓库
  3. 在该频道使用 Background Agents 的所有团队成员都会使用这些默认值
频道设置优先于个人默认设置,但可以被如下显式选项覆盖@Cursor [repo=...] [prompt]

隐私

Background Agents 支持隐私模式。 了解更多隐私模式信息,或管理你的隐私设置
不支持隐私模式(旧版)。Background Agents 在运行时需要临时代码存储。

显示 Agent 摘要

显示 Agent 摘要和差异图像。可能包含文件路径或代码片段。可开启或关闭。

在外部频道显示 Agent 摘要

针对与其他工作区的 Slack Connect,或包含外部成员(如来宾)的频道,可选择是否在外部频道显示 Agent 摘要。

权限

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 账号匹配,以进行权限与安全访问控制