はじめよう
インストール
- Cursor integrations にアクセス
- Slack の横にある Connect をクリック、またはここから installation page へ
- ワークスペースに Slack 用の Cursor アプリをインストールするよう求められる
-
Slack へのインストール後、セットアップ完了のために Cursor にリダイレクトされる
- GitHub を接続(未接続の場合)し、デフォルトのリポジトリを選択
- 従量課金を有効化
- プライバシー設定を確認
- Slack で @Cursor をメンションして Background Agents の利用を開始
使い方
コマンド
Command | Description |
---|---|
@Cursor [prompt] | Background Agent を開始。既存のエージェントがいるスレッドではフォローアップ指示を追加 |
@Cursor settings | デフォルトとチャンネルのデフォルトリポジトリを設定 |
@Cursor [options] [prompt] | 高度なオプションを使用: branch , model , repo |
@Cursor agent [prompt] | スレッドで新しいエージェントを強制的に作成 |
@Cursor list my agents | 実行中のエージェントを表示 |
オプション
Option | Description | Example |
---|---|---|
branch | ベースブランチを指定 | branch=main |
model | AI モデルを選択 | model=o3 |
repo | 対象リポジトリを指定 | repo=owner/repo |
autopr | 自動 PR 作成の有効/無効 | autopr=false |
構文フォーマット
- ブラケット形式 @Cursor [branch=dev, model=o3, repo=owner/repo, autopr=false] Fix the login bug
- インライン形式 @Cursor branch=dev model=o3 repo=owner/repo autopr=false Fix the login bug
オプションの優先順位
- 明示的な値がデフォルトを上書き
- 重複した場合は後に書いた値が前を上書き
- インライン指定は設定モーダルのデフォルトより優先
スレッドコンテキストの活用
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 は呼び出し時にスレッド全体を読み込み、
チームの議論に基づいて解決策を理解し実装する。
強制コマンドを使うとき
ステータス更新とハンドオフ


エージェントの管理

- Add follow-up: 既存のエージェントに追加入力(指示)を送る
- Delete: Background Agent を停止してアーカイブする
- View request ID: トラブルシューティング用の一意のリクエスト ID を表示(サポートに連絡するときに添えてね)
- Give feedback: エージェントの動作についてフィードバックを送る
設定
設定
デフォルトモデル
デフォルトリポジトリ
https://github.com/org/repository
org/repository
存在しないリポジトリを参照すると、アクセス権がないように見えるよ。
Background Agent の起動に失敗したときのエラーメッセージにそう表示される。
ベースブランチ
main
)を使う。
チャンネル設定
- チャンネルごとに異なるリポジトリで作業している
- チーム全員で設定を統一したい
- 毎回コマンドでリポジトリを指定したくない
- 目的のチャンネルで @Cursor settings を実行
- そのチャンネルのデフォルトリポジトリを設定
- そのチャンネルで Background Agents を使うメンバー全員にこのデフォルトが適用される
チャンネル設定は個人のデフォルトより優先されるけど、
@Cursor [repo=...] [prompt] のような明示的なオプションで上書きできるよ。
プライバシー
旧 Privacy Mode はサポートしていないよ。Background Agents は実行中に一時的に
コードを保存する必要がある。
エージェントサマリーの表示
外部チャンネルでのエージェントサマリーの表示
権限
権限 | 説明 |
---|---|
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 アカウントを突き合わせて、権限と安全なアクセスを付与する |