通过 Cursor 的 Slack 集成,您可以使用后台代理直接从 Slack 处理任务,只需提及 @Cursor 并附上提示即可。

开始使用

安装

  1. 前往 Cursor integrations
  2. 点击 Slack 旁边的 Connect 或从这里前往 installation page
  3. 系统将提示您在工作区中安装 Cursor 应用程序。
  4. 在 Slack 中安装后,您将被重定向回 Cursor 以完成设置
    1. 连接 GitHub(如果尚未连接)并选择默认存储库
    2. 启用基于使用量的定价
    3. 确认隐私设置
  5. 通过提及 @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] | 使用高级 选项:branchmodelrepo | | @Cursor agent [prompt] | 在线程中强制创建新 代理 | | @Cursor list my agents | 显示您正在运行的代理 |

选项

使用这些选项自定义后台代理行为:
| 选项 | 描述 | 示例 | |:-------|:------------|:--------| | branch | 指定基础分支 | branch=main | | model | 选择 AI 模型 | model=o3 | | repo | 针对特定仓库 | repo=owner/repo | | autopr | 启用/禁用自动 PR 创建 | autopr=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
选项优先级
组合选项时:
  • 显式值覆盖默认值
  • 后面的值覆盖前面重复的值
  • 内联选项优先于设置模态框默认值
机器人从消息中的任何位置解析选项,允许自然的命令编写。

使用线程上下文

后台代理理解并使用现有线程讨论的上下文。当您的团队讨论问题并希望代理基于该对话实现解决方案时很有用。
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 中打开 的选项。
当 Background Agent 完成时,您会在 Slack 中收到通知,并可以选择在 GitHub 中查看创建的 PR。

管理代理

要查看所有正在运行的代理,请运行 @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 在频道级别配置默认设置。这些设置是按团队设置的,会覆盖该频道中您的个人默认设置。 在以下情况下特别有用:
  • 不同频道处理不同的仓库
  • 团队希望所有成员使用一致的设置
  • 您希望避免在每个命令中指定仓库
配置频道设置:
  1. 在所需频道中运行 @Cursor settings
  2. 为该频道设置默认仓库
  3. 在该频道中使用 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 账户匹配以获取权限和安全访问 |