透過 Cursor 的 Slack 整合功能,你可以直接在 Slack 中使用背景代理來處理任務,只需要標記 @Cursor 並加上指令即可。

開始使用

安裝

  1. 前往 Cursor integrations
  2. 點擊 Slack 旁邊的 Connect 或從這裡前往安裝頁面
  3. 系統會提示你在工作區中安裝 Cursor 的 Slack 應用程式。
  4. 在 Slack 中安裝完成後,你會被重新導向回 Cursor 以完成設定
    1. 連接 GitHub(如果尚未連接)並選擇預設儲存庫
    2. 啟用基於使用量的定價
    3. 確認隱私設定
  5. 在 Slack 中提及 @Cursor 來開始使用 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。

管理 Agent

要查看所有執行中的 Agent,執行 @Cursor list my agents 使用右鍵選單管理 Background Agent,點擊任何 Agent 訊息上的三個點 (⋯)。
可用選項:
  • Add follow-up:為現有 Agent 新增指令
  • Delete:停止並封存 Background Agent
  • View request ID:查看用於疑難排解的唯一請求 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 權限,讓背景代理能在你的工作區中正常運作:
權限描述
app_mentions:read偵測 @提及來啟動背景代理並回應請求
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 帳戶配對來進行權限管理和安全存取