Cursor 自動化可在後臺運行雲端代理，按計劃執行，或響應來自 GitHub、GitLab、Slack、Webhook、Linear 等平臺的事件。
自動化可用於執行各類任務，例如評審近期 PR 提交以發現缺陷、深入評審以發現漏洞、在 Slack 中分診缺陷，以及按計劃彙總代碼庫更改。
快速開始¶
您可以在代理窗口、cursor.com/automations 創建新的自動化，也可以通過本地智能體會話中的 /automate 技能，或使用 插件市場 中的模板創建。
/automate 技能讓您可以用自然語言描述所需的工作流。Cursor 會爲您配置自動化的觸發器、指令和工具。
無論選擇哪種方式：
- 選擇觸發器，例如每小時觸發一次，或在 PR 創建時觸發。
- 編寫提示詞，說明自動化要執行的操作。
- 選擇智能體可使用的可選工具，例如 Send to Slack、Comment on Pull Request 或 MCP 工具。
- 選擇自動化需要一個倉庫、多個倉庫，還是完全不需要倉庫。
- 保存並啓用自動化。
自動化頁面還提供三個由 Cursor 管理的智能體：
計費¶
自動化會創建雲端代理，並按雲端代理用量計費。詳情請參閱雲端代理定價。
自動化以雲端代理的形式運行，因此會使用每個模型支持的最大上下文窗口。無法切換上下文窗口。
用量的計費方式取決於自動化的權限範圍：
- 團隊擁有：用量計入團隊的用量池。自動化通過共享的團隊服務賬戶執行，因此不會影響任何個人用戶的用量。
- 私有：用量計入創建該自動化的用戶。
- 團隊可見：與私有相同，用量計入創建該自動化的用戶。
觸發器¶
觸發器決定自動化的運行時機。一個自動化可以有多個觸發器，任一觸發器觸發時，自動化都會運行。
對於 Slack 或 cron 計劃等某些觸發器，Cursor 默認不使用倉庫。如果自動化需要修改代碼，請指定智能體應在哪個或哪些倉庫中工作。對於源代碼控制觸發器，必須指定一個或多個倉庫。
定時觸發器¶
定時觸發器會按設定週期運行。您可以選擇預設選項，也可以輸入 cron 表達式進行精確控制。
定時觸發器可能會延遲執行，但不會早於指定時間啓動。
源代碼控制觸發器¶
源代碼控制觸發器會響應來自已連接的 Git 提供商 (GitHub、GitLab 和 Bitbucket Cloud) 的 PR 和推送事件。將自動化關聯到一個代碼倉庫或多倉庫環境。
每個已連接的提供商都支持以下核心 PR 和推送觸發器：
- 草稿 PR 已創建 - 創建草稿 PR 時。
- PR 已創建 - 創建非草稿 PR，或將草稿標記爲可供評審時。
- PR 已推送 - 向現有 PR 推送新提交時。
- PR 已合併 - PR 合併時。
- 推送到分支 - 在 PR 之外向特定分支推送提交時。
- 已添加評論 - 有人在 PR 上發表頂層評論時。
GitHub 支持的觸發器最多。GitLab 和 Bitbucket 除支持上述核心觸發器外，還支持其下方分區中列出的部分額外觸發器。
GitHub 觸發器¶
GitHub 是參考提供商，支持所有源代碼控制觸發器。除核心觸發器外，還支持以下觸發器：
- PR 標籤已更改 - 當 PR 添加或移除特定標籤或任意標籤時。
- 議題標籤已更改 - 當非 PR 議題添加或移除標籤時。
- CI 已完成 - 當 GitHub 檢查在 PR 或分支上完成時。
- 議題評論 - 當有人在非 PR 議題上發表評論時。
- PR 評審評論 - 當有人在 PR diff 中留下內聯評論時。
- PR 評審已提交 - 當以批准、請求更改或評論的形式提交評審時。
- 評審線程已更新 - 當 PR 中的評審線程被標記爲已解決或未解決時。
- 工作流運行已完成 - 當 GitHub Actions 工作流運行在 PR 或分支上完成時。
插件市場提供了用於分流失敗的 GitHub Actions 工作流和修復 PR 評審評論的模板。
GitLab 觸發器¶
除核心觸發器外，GitLab 還提供：
- PR 標籤已更改 - 當合並請求的標籤被添加或移除時。
- PR 已批准 - 當合並請求獲批時。
Bitbucket 觸發器¶
僅支持 Bitbucket Cloud (bitbucket.org)。不支持 Bitbucket Server 和 Data Center。除核心觸發器外，還支持：
- PR 已批准 - PR 獲得批准時。
Bitbucket Cloud 不支持 PR 標籤或內聯評審評論觸發器。
從 fork 發起的 PR 不會觸發 PR 觸發器。這些運行會因“Fork PR 不受支持”錯誤而失敗，因爲該分支僅存在於 fork 中，使用倉庫權限運行外部代碼並不安全。PR 已合併觸發器是例外，仍會運行，因爲它們從合併提交啓動。要解決此問題，請將分支推送到倉庫本身，然後從該倉庫發起 PR。
Slack 觸發器¶
Slack 觸發器會響應 Cursor Slack 集成中的事件。
目前，Slack 觸發器只能訪問公開的 Slack 頻道。
- 頻道新消息 - 已連接的 Slack 頻道中有新消息時觸發。未設置消息篩選器時，觸發器僅會針對頻道中的頂層消息觸發。如需在線程回覆時也觸發，請添加關鍵詞或正則表達式篩選器。
- 表情 प्रतिक्रिया - 有人使用特定表情回應 Slack 消息時觸發。
- 頻道已創建 - 工作區中創建新的公開 Slack 頻道時觸發。
Webhook 觸發器¶
Webhook 觸發器會爲你的自動化創建一個私有 HTTP 端點。向該端點發送 POST 請求即可啓動一次運行。你可以使用 Webhook 將自動化與內部系統、CI 流水線、監控工具等連接起來。
要獲取 Webhook URL，必須先保存自動化。保存後，系統會生成可調用的 Webhook URL 以及用於身份驗證的 API 密鑰。
Linear 觸發器¶
Linear 觸發器會響應來自 Cursor Linear 集成的事件。
- 已創建問題 - 創建新問題時。
- 狀態已更改 - 問題狀態發生更改時。
- 週期結束 - Linear 週期完成時。
Sentry 觸發器¶
當 Sentry 項目中發生錯誤或問題事件時，Sentry 觸發器會運行。您可以使用它們自動調查錯誤、找出根本原因並提出修復方案。有關現成示例，請參閱 Investigate Sentry issues 市場模板。
- Issue created - 在 Sentry 中創建新問題時。
- Issue updated - 現有問題發生變更時，例如狀態或負責人更新。
- Any issue event - 匹配所有問題事件類型。
PagerDuty 觸發器¶
PagerDuty 觸發器會在事故事件發生時運行，可用於自動分類處理甚至解決事故。
- 事故已觸發 - 創建新事故時。
- 事故已確認 - 確認事故時。
- 事故已解決 - 事故解決時。
- 任意事故事件 - 匹配所有事故事件類型。
工具¶
Cursor 自動化可啓用工具，以增強與 GitHub、Slack、記憶、MCP 等相關的功能。自動化還包含與其他雲端代理相同的基礎工具集。詳情請參閱雲端代理能力。
創建 PR¶
基於倉庫的自動化在根據自動化提示詞完成所需的代碼更改後，可創建 PR。此工具默認在所有自動化中啓用。
PR 會在源代碼控制觸發器指定的倉庫中創建。對於其他觸發器，則使用環境中指定的倉庫。
在 PR 中評論¶
在目標 PR 中發佈評論。支持在評審層級發表評論，也支持添加內聯代碼評論。
如果啓用批准，智能體還可以批准、請求更改和撤銷評審。否則，它只能發佈評論。
請求審閱人¶
爲目標 PR 請求審閱人。智能體可以使用 git、記憶和其他工具來識別相關領域專家。
發送到 Slack¶
向 Slack 頻道發送消息。你可以指定特定頻道，也可以讓智能體動態選擇任意頻道。
當你允許使用任意頻道時，Cursor 還會授予智能體發現可用公開頻道所需的讀取權限。
請注意，智能體會獲得其可發送消息的公開頻道的讀取權限。
讀取 Slack 頻道¶
允許智能體以只讀方式查看公開 Slack 頻道列表並讀取其中的消息。
當智能體在回覆或創建 PR 前需要更多上下文時，可使用此功能。
MCP 服務器¶
連接 MCP (模型上下文協議) 服務器，讓智能體能夠使用外部工具和數據源。
連接 MCP 服務器後，智能體可訪問該服務器提供的所有工具。請僅連接你信任、且擁有自動化所需權限的服務器。
記憶¶
記憶功能讓智能體能夠在同一自動化的多次運行中讀取和寫入持久化筆記。藉此可構建能夠記住信息並隨時間不斷改進的智能體。每條記憶都存儲爲一個具名條目 (默認爲 MEMORIES.md) ，位於智能體工作文件系統之外。
記憶默認啓用，但也可以禁用。可在工具配置 UI 中查看和編輯記憶。
智能體可以在自動化運行期間刪除過時的記憶文件。你也可以在工具配置 UI 中刪除記憶文件。
記憶會在多次運行之間持續保留；如果自動化處理不受信任的輸入，請謹慎使用。輸入可能會產生誤導性或惡意的記憶，進而無意中影響後續的自動化運行。
計算機使用¶
計算機使用功能讓由自動化啓動的雲端代理能夠像開發者一樣操作計算機。這意味着自動化可以操作瀏覽器、生成屏幕截圖或錄屏，或使用您的內部服務。每個自動化默認都包含此功能。
爲確保計算機使用功能正常發揮作用，請爲自動化配置開發環境。之後，如果您希望智能體展示其工作成果，可以在自動化指令中要求其進行演示。例如，您可以告訴智能體，在更改面向用戶的流程後附上一段簡短的屏幕錄製。
自動化設置¶
模型¶
您可以選擇雲端代理執行自動化任務時使用的模型。
代碼倉庫¶
選擇自動化不使用倉庫、使用一個倉庫，還是使用多倉庫環境。
倉庫設置決定每次運行的代碼庫上下文：
- 無代碼倉庫：智能體不會克隆代碼。適用於僅需使用 Slack、MCP、webhooks、Linear 或 PagerDuty 的工作流。無法編輯代碼或創建 PR。
- 單個代碼倉庫：智能體在一個倉庫及其分支中工作。自動化需要在一個代碼庫中讀取、評審或更改代碼時，請使用此選項。
- 多倉庫環境：智能體可在環境中的多個倉庫之間工作。任務涉及多個代碼庫時，請使用此選項。
對於 Slack 或 cron 定時任務等特定觸發器，Cursor 默認不使用倉庫。如果自動化需要更改代碼，請指定智能體應在哪個或哪些倉庫中工作。
對於源代碼控制觸發器，必須指定一個或多個倉庫。
單倉庫自動化¶
默認情況下，自動化會在一個代碼倉庫和分支上運行。當智能體需要在單個代碼庫中讀取、評審或修改代碼時，這是合適的選擇。
源代碼控制觸發器會從 PR 中識別代碼倉庫。對於其他觸發器，請在自動化設置中選擇代碼倉庫和分支。
多倉庫自動化¶
當自動化需要跨多個倉庫運行時，請使用多倉庫環境。配置環境時選擇多個倉庫，或從您的 Cloud Agents 儀表盤 中選擇已有環境。
權限¶
控制誰可以查看和管理自動化。權限範圍還決定用量如何計費。
- 私有：只有你可以管理自動化。團隊管理員可以查看和禁用該自動化。
- 團隊可見：只有你可以管理自動化。團隊成員可以查看該自動化，團隊管理員可以禁用它。它仍使用你的認證信息運行。
- 團隊擁有：團隊成員可以查看該自動化。只有團隊管理員可以管理它。它使用團隊共享的自動化服務賬戶運行。
將自動化從私有或團隊可見提升爲團隊擁有，會改變其運行所使用的身份。它將不再使用你的認證信息，改用團隊共享的自動化服務賬戶。如果自動化使用 webhook 觸發器，請在更改權限範圍後重新生成其 webhook API 密鑰。如果它使用依賴個人 OAuth 憑據的 MCP 或其他集成，請確保改爲爲團隊的服務賬戶配置這些憑據。只有團隊管理員可以將自動化提升爲團隊擁有。
身份¶
當自動化與外部服務交互時，會使用以下身份：
- GitHub 評論、評審批准和請求審閱人均以
cursor身份執行。 - 團隊範圍的自動化會以
cursor身份創建 PR。 - 私有自動化會以你的 GitHub 賬戶身份創建 PR。
- Slack 消息會以 Cursor 機器人的身份發送。
編寫提示詞¶
提示詞用於定義智能體應執行的任務。編寫方式應與爲雲端代理運行編寫指令時相同。
提示：
- 明確說明智能體需要檢查、修改或產出什麼。
- 引用你已啓用的操作——可以通過 @ 提及工具，或直接提及工具名稱。
- 包含針對不同情況應採取何種操作的決策規則。
- 設定質量標準，明確智能體何時應創建 PR、發表評論或不執行任何操作。
- 描述所需的輸出格式。
