Bot 機能(モジュール)

Agent Workspace

Agent Workspace は、Discord のチャンネル 1 つを「開発支援のセッション」として使う機能です。セッションには GitHub のリポジトリを紐付け、チャンネルでの会話を通じてコードを調べさせたり、変更を提案させたり、Pull Request を作らせたりできます。このほか、Issue・Pull Request・CI の結果・Projects を調べさせたり、Issue の作成、Issue・Pull Request へのコメントや編集、Pull Request のレビュー、Projects のアイテムの追加・更新をさせたりすることもできます(Projects はそのリポジトリにリンクされたものに限ります)。

利用できる条件

Agent Workspace を使うには、次の 3 つがすべて必要です。

  1. Pro プラン以上の契約。
  2. AI 応答の「機能の有効化」がオンであること。
  3. AI 応答の「使う場面」区画にある「Agent Workspace」のスイッチがオンであること(既定はオフ)。

使えるモデルは、AI 応答のモデル表で「Agent Workspace」が付いているものです。

GitHub の連携

セッションで扱えるのは、Bot に連携した GitHub アカウント(個人または Organization)のリポジトリだけです。連携していないリポジトリを指定すると、セッションは作成されません。

連携は AI 応答 の設定ページにある「GitHub 連携」区画で行います。先に GitHub App をそのアカウントへインストールしてから、「GitHub を連携」を押して認可してください。

連携できるのは、その GitHub アカウントの管理者で、かつ Bot の管理者である人だけです。

サーバーごとの設定

作成先のカテゴリー、既定のモデル、既定の思考の強さ、同時に持てるセッション数は、Discord 上で /ai workspace settings を実行して設定します(ダッシュボードにはありません)。同時に持てるセッション数の既定は 3 です。作成先のカテゴリーを設定していないとセッションは作成できません。

セッションでの役割

チャンネルで発言できる人のうち、AI の作業を進められるのは「作業者」1 人だけです。

  • 作業者の発言だけが AI のターンを起こします。
  • それ以外の人の発言には 👀 が付き、次のターンの材料として残ります(AI への指示としては扱われません)。
  • 作業者が未設定のあいだは、セッションのオーナーが作業者です。
  • 「作業を代わる」ボタンは誰でも押せます(自分が作業者になる操作です)。そのチャンネルで発言できない人を作業者にすることはできません。
  • 許可ボタンと Pull Request の作成 / 破棄は作業者とオーナーのみ、セッションの編集・削除はオーナーのみが行えます。

エージェントモード

セッションごとに、AI がどこまで自動で進めてよいかを選べます。既定は「編集を許可」です。

モード内容
✋ 手動変更を提案するたびに 1 件ずつ許可を求めます。許可は 3 分で見送られます。
🗺️ プラン調べて手順を立てるだけで、変更は提案しません。
✏️ 編集を許可変更を提案し、Pull Request はボタンで作ります(既定)。
🚀 自動提案が揃うと、ボタンを押さなくても Pull Request を作ります。
🔍 デバッグ仮説と確かめ方を示し、貼られた出力を読んで絞り込みます。ツールの実行内容を詳しく表示します。

Issue の作成や Issue・Pull Request へのコメント・編集など、GitHub への書き込みは、「プラン」では行いません。「自動」以外のモードでは 1 件ごとに許可を求めます。

どのモードでも次は必ず守られます。マージ・Approve はしません。ブランチ・Issue・コメントなどの削除もしません。既定ブランチへ直接書き込みません。force push もしません。

「自動」モードは、人の承認なしに Pull Request の作成まで進みます(マージはしません)。レビュー体制が整っているリポジトリでのみ選んでください。

コマンド一覧

すべて既定で有効・全員に許可されています。

コマンドできること必要な Discord 権限
/ai workspace settingsこのサーバーの Agent Workspace 設定パネルを開きます。サーバーの管理
/ai workspace createセッションを作成します。チャンネルを 1 つ作り、GitHub リポジトリを紐付けます。サーバーの管理
/ai workspace closeセッションを閉じます。履歴は残り、resume で開き直せます。サーバーの管理
/ai workspace resume閉じたセッションを再開します。枠を 1 つ使います。サーバーの管理
/ai workspace forkいまの会話から分岐した別セッションを作ります。枠を 1 つ使います。サーバーの管理
/ai workspace editセッションを編集します。サーバーの管理
/ai workspace modelsこのセッションのモデルを変更します。なし
/ai workspace effortこのセッションの思考の強さを変更します。なし
/ai workspace modeエージェントモードを変更します。なし
/ai workspace worker作業者を変更します。user を指定すると他人へ渡せます。なし
/ai workspace btw作業を止めずに、いまの文脈へ軽く質問します。なし
/ai workspace contextこのセッションの文脈と利用状況を表示します。なし
/ai workspace compact古い会話を要約に畳んで文脈の枠を空けます。クレジットを消費します。なし
/ai workspace listこのサーバーのセッション一覧を表示します。なし

/ai workspace create では、name(セッション名)のほかに repo(owner/name 形式、省略可。連携済みのリポジトリから選べます)と mode(省略時は「編集を許可」)を指定できます。

セッションのチャンネルやスレッドを Discord 上で削除すると、セッションと会話記録も削除され、元に戻せません。そのセッションから分岐したセッションも削除されます。履歴を残したい場合は /ai workspace close で閉じてください。

上限

AI が一度に参照できる会話の広さはプランで決まります。

項目ProMax
保持するメッセージ数30 件60 件
文脈の文字数10,000 字25,000 字

枠が足りなくなると古い発言から落ちますが、落ちる前に自動で要約へ畳まれるため、会話が途中から始まったようにはなりません。/ai workspace compact を使えば、区切りのよいところで手動で畳めます。

次のステップ / 関連ページ

最終更新:

目次