跳轉到主要內容
透過 Cursor 與 Slack 的整合,你可以在 Slack 中直接提及 @Cursor 並附上提示,使用 Background Agents 來直接處理你的任務。

開始使用

安裝

  1. 前往 Cursor integrations
  2. 點擊 Slack 旁的 Connect,或從這裡前往安裝頁面
  3. 系統會提示你在工作區安裝 Cursor 的 Slack 應用程式
  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 取得最新指令清單。
指令說明
@Cursor [prompt]啟動 Background Agent。在已有 agent 的討論串中,會新增後續指示
@Cursor settings設定預設值與頻道的預設儲存庫
@Cursor [options] [prompt]使用進階選項:branchmodelrepo
@Cursor agent [prompt]在討論串中強制建立新的 agent
@Cursor list my agents顯示你目前執行中的 agents

選項

用這些選項來自訂 Background Agent 的行為:
選項說明範例
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。

管理代理

要查看所有執行中的代理,在 Slack 執行 @Cursor list my agents 在任何代理的訊息上點擊右上角的更多選單(三個點 ⋯),即可透過內容選單管理 Background Agents。
可用選項:
  • Add follow-up: 為現有代理新增後續指示
  • Delete: 停止並封存 Background Agent
  • View request ID: 檢視用於疑難排解的唯一 request ID(聯絡支援時請附上)
  • Give feedback: 提供代理效能的回饋

設定

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,或包含外部成員(如 Guest)的頻道,可選擇是否在外部頻道顯示 agent 摘要。

權限

Cursor 會請求以下 Slack 權限,讓 Background Agents 能在你的工作區中運作:
PermissionDescription
app_mentions:read偵測被 @ 提及以啟動 Background Agents 並回應請求
channels:history讀取討論串中的先前訊息,為新增後續指示提供脈絡
channels:join在被邀請或請求時自動加入公開頻道
channels:read存取頻道中繼資料(ID 與名稱)以張貼回覆與更新
chat:write當 agent 完成時傳送狀態更新、完成通知與 PR 連結
files:read下載分享的檔案(日誌、截圖、程式碼範例)以取得額外脈絡
files:write上傳 agent 變更的視覺化摘要以便快速檢視
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 帳號配對,以控管權限與安全存取
I