メインコンテンツへスキップ
Cursor の Slack 連携を使えば、Slack で @Cursor にプロンプトを添えてメンションするだけで、Background Agents がタスクを直接実行してくれる。

はじめよう

インストール

  1. Cursor integrations に移動
  2. Slack の横にある Connect をクリック、またはここから installation page へ移動
  3. ワークスペースに Cursor の Slack アプリをインストールするよう求められる
  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 を実行。
CommandDescription
@Cursor [prompt]Background Agent を起動。既存のエージェントがいるスレッドでは追加入力を渡す
@Cursor settingsデフォルト設定とチャンネルのデフォルトリポジトリを設定
@Cursor [options] [prompt]高度なオプションを使用: branch, model, repo
@Cursor agent [prompt]スレッド内に新しいエージェントを強制的に作成
@Cursor list my agents実行中の自分のエージェントを表示

オプション

以下のオプションで Background Agent の動作をカスタマイズ:
OptionDescriptionExample
branchベースブランチを指定branch=main
modelAIモデルを選択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
オプションの優先順位
オプションを組み合わせる場合:
  • 明示的な値がデフォルトを上書き
  • 重複した場合は後に指定した値が前を上書き
  • インライン指定は設定モーダルのデフォルトより優先
ボットはメッセージ内のどこからでもオプションを解析するから、自然な書き方でコマンドを書ける。

スレッドコンテキストの活用

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 を表示できるよ。

エージェントの管理

実行中のエージェントをすべて見るには、@Cursor list my agents を実行してね。 任意のエージェントメッセージの三点(⋯)をクリックして、コンテキストメニューから Background Agent を管理できるよ。
利用できるオプション:
  • Add follow-up: 既存のエージェントに追加入力(指示)を送る
  • Delete: Background Agent を停止してアーカイブする
  • View request ID: トラブルシューティング用の一意のリクエスト ID を表示(サポートに連絡する際に含めてね)
  • Give feedback: エージェントのパフォーマンスに関するフィードバックを送る

設定

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 は実行中に一時的な コードの保存を必要とする。

エージェントサマリーの表示

エージェントのサマリーと差分画像を表示。ファイルパスやコードスニペットを含む場合がある。オン/オフ切り替え可。

外部チャンネルでのエージェントサマリー表示

他のワークスペースとの Slack Connect や、ゲストなど外部メンバーがいるチャンネルで、エージェントサマリーを表示するかどうかを選択。

権限

Cursor は、ワークスペースで Background Agents が動作するために次の Slack 権限をリクエストする:
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 アカウントを照合する
I