Slack
Cursor の Slack 連携を使うと、プロンプトを添えて @cursor にメンションすることで、Slack から直接 Cloud Agents にタスクを任せられます。
はじめ方
インストール
-
Cursor integrationsに移動する
-
Slack の横にある Connect をクリックするか、こちらからインストールページに移動する
-
ワークスペース用の Cursor Slack アプリをインストールするよう求められます。
-
Slack へのインストール後、セットアップを完了するために Cursor に戻ります
- リポジトリプロバイダーを接続し (未接続の場合) 、デフォルトリポジトリを選択する
- 使用量ベースの料金を���効にする
- プライバシー設定を確認する
-
@cursorにメンションして、Slack で Cloud Agents を使い始める
使用方法
@cursor をメンションして、プロンプトを入力します。Cursor は、メッセージからリポジトリ、モデル、ベースブランチ、または名前付きのCloud Agent 環境を検出します。リポジトリの選択時には、直近のエージェントのアクティビティも使用します。
名前付き環境を使用する場合は、プロンプトにその名前を含めてください。例: @Cursor use the Platform environment to update the shared API。
コマンド
最新のコマンド一覧を確認するには、@Cursor help を実行します。
| コマンド | 説明 |
|---|---|
@Cursor [prompt] | Cloud Agent を開始します。既存のエージェントがいるスレッドでは、追加の指示を送ります。フォローアップできるユーザーは、所有者だけでは決まらず、Team follow-ups で管理されます。 |
@Cursor settings | デフォルト設定とチャンネルのデフォルトリポジトリを設定します |
@Cursor [options] [prompt] | 実行のターゲット、モデル、ブランチ、PR の挙動、ワーカー、出力チャンネルを設定します |
@Cursor agent [prompt] | スレッド内に新しいエージェントを強制的に作成します (例: @Cursor start a new agent to fix billing) |
@Cursor list my agents | 実行中のエージェントを表示します |
オプション
以下のオプションでCloud Agentの挙動をカスタマイズできます。
| オプション | 説明 | 自然言語の例 | インライン例 |
|---|---|---|---|
repo | 特定のリポジトリを使用 | in acme/backend | repo=acme/backend |
env / environment | 名前付きのCloud Agent 環境を使用 | use the Platform environment | env=Platform |
branch | 特定のベースブランチを使用 | work from the dev branch | branch=dev |
model | 特定のモデルを使用 | with opus | model=opus |
autopr | PRの自動作成を有効または無効にする | インラインオプションが必要 | autopr=false |
worker / machine | 名前付きのMy Machineで実行 | インラインオプションが必要 | worker=my-devbox |
pool | 名前付きの持ち込みマシンプールで実行 | インラインオプションが必要 | pool=gpu |
self_hosted | チームのセルフホスト型プールで実行 | インラインオプションが必要 | self_hosted=true |
channel | あなたとCursorがアクセスできる別のチャンネルにエージェントの更新を投稿 | インラインオプションが必要 | channel=#eng-bots |
構文形式
自然言語:
@Cursor with opus, fix the login bug in backend-apiインライン:
@Cursor env=Platform branch=dev model=opus autopr=false Fix the login bugスペースを含む環境名は引用符で囲みます:
@Cursor env="Platform Services" Update the shared APIオプションの優先順位
オプションを組み合わせる場合:
- 明示的に指定した値はデフォルトより優先されます
- 重複している場合は、後から指定した値が先に指定した値より優先されます
- インラインオプションは設定モーダルのデフォルトより優先されます
- 両方が指定されている場合、**
env**はrepoより優先されます
botはメッセージ内のどこに記述されたオプションでも解析できるため、自然な形でコマンドを記述できます。
スレッドのコンテキストを利用する
Cloud Agents は、既存のスレッドでの議論からコンテキストを理解し、活用します。チームで課題について議論し、その会話に基づいてエージェントに解決策を実装させたい場合に便利です。
Cloud Agents は呼び出されると、コンテキストを把握するためにスレッド全体を読み取り、 チームの議論に基づいて解決策を理解し、実装します。
force コマンドを使う場面
@Cursor agent が必要なのはどんなときですか?
既存のエージェントがいるスレッドでは、@Cursor [prompt] で追加の指示を送れます。フォローアップできるユーザーは、Team follow-ups で制御されます。Team follow-ups が Disabled の場合、フォローアップできるのは所有者のみです。別のエージェントを起動するには、@Cursor agent [prompt] を使うか、自然言語で依頼します。
@Cursor start a new agent to refactor billing「新しいエージェントを作成」、「新しいエージェントを起動」、「新しいエージェントをお願いします」といったフレーズは、すべて同じように機能します。
フォローアップを追加 (コンテキストメニューから) はいつ必要ですか?
フォローアップの指示を追加するには、エージェントのレスポンスにあるコンテキストメニュー (⋯) を使用します。スレッド内に複数のエージェントがいる場合に、フォローアップするエージェントを指定するのに便利です。
ステータスの更新と引き継ぎ
Cloud Agent の実行開始時に、まず Cursor で開く オプションが表示されます。
Cloud Agent の完了時には、Slack で通知が届き、作成された PR を GitHub で表示できます。
エージェントの管理
実行中のすべてのエージェントを確認するには、@Cursor list my agents を実行します。
任意のエージェントメッセージにある三点リーダー (⋯) をクリックしてコンテキストメニューを開き、Cloud Agent を管理します。
利用可能なオプション:
- フォローアップを追加: 既存のエージェントに指示を追加
- 削除: Cloud Agent を停止してアーカイブ
- リクエスト ID を表示: トラブルシューティング用の一意のリクエスト ID を表示 (サポートにお問い合わせの際は、この ID を含めてください)
- フィードバックを送信: エージェントのパフォーマンスに関するフィードバックを送信
設定
ダッシュボード -> Cloud Agentsで、デフォルト設定とプライバシーオプションを管理できます。
設定
デフォルトモデル
メッセージでモデルが指定されていない場合に使用されます。利用可能なオプションについては、設定をご覧ください。
リポジトリの選択
Cursor は、以下に基づいて適切なリポジトリを自動的に選択します。
- メッセージの内容 — プロンプトに含まれるリポジトリ名やキーワード
- 直近のエージェントのアクティビティ — 最近使用したリポジトリ
- ルーティングルール — キーワードとリポジトリのカスタムマッピング (以下を参照)
- デフォルトリポジトリ — 一致するものがない場合のフォールバック
特定のリポジトリを使用するには、メッセージにその名前を含めてください。例: @Cursor in mobile-app, fix the login bug。
ベースブランチ
Cloud Agent の開始元となるブランチ。空欄の場合は、リポジトリのデフォルトブランチ (通常は main) が使用されます
チャンネル設定
@Cursor settings を使用して、チャンネルごとのデフォルト設定を行います。これらの設定はチーム単位で適用され、そのチャンネルでは個人のデフォルト設定より優先されます。
チャンネル設定は公開チャンネルにのみ適用されます。
特に次のような場合に便利です。
- チャンネルごとに異なるリポジトリで���業する場合
- チーム全体で一貫した設定を使用したい場合
チャンネル設定を行うには:
- 対象のチャンネルで
@Cursor settingsを実行します - そのチャンネルのデフォルトリポジトリを設定します
- そのチャンネルで Cloud Agents を使用するすべてのチームメンバーに、これらのデフォルト設定が適用されます
チャンネル設定は個人のデフォルト設定より優先されますが、メッセージ内で特定のリポジトリを指定すると 上書きできます。
ルーティングルール
ルーティングルールでは、ターゲットに自動的にマッピングされるキーワードを定義できます。メッセージにキーワードが含まれている場合、Cursor はエージェントを対応するリポジトリまたはCloud Agent 環境にルーティングします。環境には複数のリポジトリをまとめられるため、1 つのキーワードで、必要なすべてのリポジトリがあらかじめ設定されたエージェントを起動できます。
ルーティングルールの設定
- ダッシュボード -> Cloud Agents に移動する
- Routing Rules セクションを見つける
- キーワードとターゲットのマッピングを追加し、各キーワードをリポジトリまたは環境に紐付ける
ルールの例
| キーワード | ターゲット |
|---|---|
frontend | acme/web-app |
mobile | acme/mobile-app |
api | acme/backend-services |
platform | Platform 環境 |
これらのルールを設定すると:
@Cursor fix the frontend nav bug→acme/web-appにルーティングされます@Cursor update the mobile onboarding flow→acme/mobile-appにルーティングされます@Cursor add a migration across the platform→Platform環境で開始され、すべてのリポジトリが利用可能になります
環境をターゲットにすると、マルチリポジトリ環境で役立ちます。cloud agent docs で、マルチリポジトリ環境を含む設定方法を確認してください。
ルーティングの仕組み
Cursor は、次の順序でメッセージを評価します。
- メッセージの内容 — プロンプト内のリポジトリ名またはキーワード
- 直近のエージェントのアクティビティ — 最近使用したリポジトリ
- ルーティングルール — キーワードとターゲット (リポジトリまたは環境) のカスタムマッピング
- チャンネルのデフォルト — このチャンネルに設定されているリポジトリ
- デフォルトリポジトリ — 一致するものがない場合のフォールバック
プライバシー
Cloud Agents はプライバシーモードに対応しています。
プライバシーモードの詳細、またはプライバシー設定の管理をご確認ください。
プライバシーモード (Legacy) はサポートされていません。Cloud Agents の実行中は、一時的に コードを保存する必要があります。
エージェントの概要を表示
エージェントの概要と差分画像を表示します。ファイルパスやコードスニペットが含まれる場合があります。有効または無効にできます。
外部チャンネルにエージェントの概要を表示
他のワークスペースとの Slack Connect や、ゲストなどの外部メンバーがいるチャンネルでは、エージェントの概要を外部チャンネルに表示するよう設定できます。
権限
Cloud Agents がワークスペース内で機能するために、Cursor は以下の Slack 権限をリクエストします。
| Permission | Description |
|---|---|
app_mentions:read | @メンションを検出して Cloud 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 アカウントと照合します |
免責事項
Cursor は誤ることがあります。コードとレスポンスは必ず確認してください。
プライバシーポリシー
Cursorによるお客様のデータの収集、使用、保護については、プライバシーポリシーを参照してください。