透過 Cursor 與 Slack 的整合,你可以直接在 Slack 中用 Background Agents 處理任務,只要提及 @Cursor 並附上提示即可。

開始使用

安裝

  1. 前往 Cursor 整合
  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]啟動 Background Agent。在已有代理的討論串中,會新增後續指示
@Cursor settings設定預設值與頻道的預設儲存庫
@Cursor [options] [prompt]使用進階選項:branchmodelrepo
@Cursor agent [prompt]在討論串中強制建立新的代理
@Cursor list my agents顯示你正在執行的代理

選項

用以下選項自訂 Background Agent 的行為:
選項說明範例
branch指定基底分支branch=main
model選擇 AI 模型model=o3
repo指定目標儲存庫repo=owner/repo
autopr啟用/停用自動建立 PRautopr=false
語法格式
有幾種方式使用選項:
  1. 括號格式(Bracket format) @Cursor [branch=dev, model=o3, repo=owner/repo, autopr=false] Fix the login bug
  2. Inline 格式 @Cursor branch=dev model=o3 repo=owner/repo autopr=false Fix the login bug
選項優先順序
當組合使用選項時:
  • 明確指定的值會覆蓋預設值
  • 重複時,後面的值會覆蓋前面的值
  • Inline 選項優先於設定視窗中的預設值
機器人會從訊息的任意位置解析選項,讓你能用自然語句撰寫指令。

使用討論串脈絡

Background Agents 會理解並使用現有討論串的脈絡。當團隊正在討論某個問題,而你想讓代理根據該對話實作解法時特別好用。
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 在已有代理的討論串中,@Cursor [prompt] 會新增後續指示(只在你擁有該代理時有效)。使用 @Cursor agent [prompt] 可啟動一個獨立的代理。 什麼時候需要使用 Add follow-up(從內容功能表)? 在代理的回覆上使用內容功能表(⋯)來提供後續指示。當討論串中有多個代理、需要指定要跟進哪一個時很實用。

狀態更新與交接

當 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:檢視用於疑難排解的唯一 request 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 或管理你的 privacy settings
不支援「隱私模式(舊版)」。Background Agents 在執行時需要暫存程式碼。

顯示 Agent 摘要

顯示 agent 摘要與差異圖。可能包含檔案路徑或程式碼片段。可開/關。

在外部頻道顯示 Agent 摘要

對於與其他工作區的 Slack Connect,或含有外部成員(例如 Guests)的頻道,可選擇是否在外部頻道顯示 agent 摘要。

權限

Cursor 會請求以下 Slack 權限,讓 Background Agents 能在你的工作區中運作:
PermissionDescription
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讀取 DM 中繼資料,以識別參與者並維持正確的串接
im:write發起直接訊息,用於私人通知或個別溝通
mpim:history存取群組 DM 歷史,用於多參與者對話
mpim:read讀取群組 DM 中繼資料,以標註參與者並確保正確投遞
reactions:read觀察表情符號反應,以取得使用者回饋與狀態信號
reactions:write新增表情符號反應以標記狀態——⏳ 代表執行中,✅ 代表已完成,❌ 代表失敗
team:read識別工作區詳細資訊,以區分安裝並套用設定
users:read將 Slack 使用者與 Cursor 帳號配對,以控管權限與確保安全存取