跳转到主要内容
通过 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 的回复上使用上下文菜单(⋯)来添加后续指令。当一个线程里有多个 agents、且你需要指定要跟进哪一个时,这很有用。

状态更新与交接

当 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=...] 明确指定模型时使用。可用选项见 settings

默认仓库

在未指定仓库时使用。请使用以下格式:
  • 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 支持隐私模式。 进一步了解 Privacy Mode 或管理你的隐私设置
不支持隐私模式(旧版)。Background Agents 在运行期间需要临时代码存储。

显示 Agent 摘要

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

在外部频道显示 Agent 摘要

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

权限

为让 Background Agents 在你的工作区内正常工作,Cursor 需要以下 Slack 权限:
PermissionDescription
app_mentions:read监听 @mention,以启动 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 账号匹配,用于权限和安全访问
I