AIエージェント
「AIエージェント」は、やってほしい作業を文章で渡すと、AIが実際に手を動かして結果を返す機能です。画面は2つのタブに分かれています。
| タブ | 何をするもの |
|---|---|
| コンテナエージェント | 依頼するたびに専用の作業環境が立ち上がり、GitHubリポジトリのコード変更・PR作成や、調べもの・文書作成を行います |
| ワーカーエージェント | 指示文とスケジュールを登録しておき、決めた時間に自動で実行します（あなたの権限の範囲でTWPの情報を読み書きします） |
サイドバーの「AIエージェント」を開くと、コンテナエージェントの「セッション履歴」が表示されます。
この画面のAIエージェントは、TWPの中でAIが作業する機能です。Claude Code など外部のAIクライアントからTWPのデータを操作したい場合は、別機能のMCP連携をご利用ください。逆に、TWPの画面からAIに作業を任せたいときはこのページの機能を使います。
はじめる前に
- 開発タスクを使うにはGitHub App の連携が必要です。 全体管理者が、画面右上のアカウントメニュー →「組織設定」→「GitHub連携」タブで GitHub App をインストールします。インストールしたリポジトリだけが、タスク開始画面の「リポジトリ」に表示されます。連携していない場合、リポジトリの候補が1件も出ないため開発タスクは開始できません
- AIの利用料はクレジットとして消費されます。 タスク開始画面の下部に推定クレジットが表示されます。自社で契約しているAIのAPIキーを使いたい場合は、「組織設定」→「AI設定」タブで登録できます（APIキーの持ち込みはエンタープライズプランの機能です）
- メニューに「AIエージェント」が出ていない場合は、ご契約のプランかユーザー権限で機能が無効になっています。管理者にご確認ください
コンテナエージェント
タスクを依頼する
セッション履歴の右上「新規タスク」を押すと、依頼内容を入力する画面が開きます。
| 項目 | 説明 |
|---|---|
| タスクモード | 「開発タスク」はGitHubリポジトリで作業してPRを作成します。「汎用タスク」はリポジトリを使わず、調べものや文書作成を行います |
| リポジトリ | 開発タスクのときに選びます。GitHub App をインストールしたリポジトリが候補に出ます |
| ベースブランチ | 作業の起点にするブランチです。指定しない場合は既定のブランチが使われます |
| AIモデル | 使用するAIモデルを選びます（Claude・GPT・Gemini の各モデル） |
| タスクの説明 | やってほしいことを文章で書きます。画像も最大5枚まで添付できます（⌘V で貼り付け） |
| コンテキストを追加 | ファイル管理のフォルダ、TWPのタスク、ヒアリングセッションの情報をAIに渡せます |
| オプション指示 | 「テストを自動実行する」「CI失敗時に自動修正を試みる」「完了時にPRを自動作成する」「聞き返さず自律的に実行する」を指定します |
| 実行モード | 「対話型」は進捗を見ながらやり取りします。「バックグラウンド」は任せきりで進めます |
| 共有メンバー | 追加したメンバーも同じセッションの対話に参加できます |
汎用タスクを選ぶと「出力先」が表示されます。「フォルダに保存」を選ぶとファイル管理の指定フォルダへ成果物が保存され、「なし（チャットのみ）」を選ぶと完了時に通知で回答が届きます。
入力が終わったら「タスクを開始」を押します。タスクの説明が空のままでは開始できません。
依頼文には、パスワード・APIキーなどの秘密情報や、社外に出せない個人情報を書かないでください。AIエージェントは依頼文の内容をもとにリポジトリやファイルへ書き込みます。
進み具合を見る・追加で指示する
タスクを開始するとセッション実行画面に移ります。AIの作業内容が対話形式で表示されます。
- 下部の入力欄から追加の指示を送れます（完了したセッションでも、指示を送れば続きから再開できます）。モデルは送信のたびに選び直せます
- 右端の「CLIコンソール」を開くと、AIが実行したコマンドの出力を確認できます
- 「ファイル変更」を開くと、変更されたファイルの一覧と差分を確認できます
- ヘッダーの人型アイコンからは、このセッションを共有しているメンバーを確認できます
- 「接続済み」の表示は、進捗がリアルタイムで届いている状態を示します
画面を閉じても処理は続きます。セッション履歴から同じセッションを開き直せば、続きを確認できます。
履歴から探す
セッション履歴の表には、次の内容が並びます。
| 列 | 内容 |
|---|---|
| ステータス | 待機中・実行中・完了・失敗・中断・キャンセル |
| タスクモード | 開発タスク／汎用タスク |
| リポジトリ | 開発タスクの対象リポジトリ（汎用タスクは「-」） |
| タスク概要 | 依頼文の冒頭 |
| 作成者 | 依頼した人 |
| 実行時間・作成日時 | かかった時間と開始した日時 |
- 右上のプルダウンでステータスを絞り込めます
- 「更新」で最新の状態に読み込み直します
- 行をクリックするとセッション実行画面が開きます
- 表の末尾の「続きを読み込む」で、古いセッションを追加で表示します
- ゴミ箱アイコンでセッションを削除できます（実行中のセッションは削除できません）
ワーカーエージェント
ワーカーエージェントは、あなたの代わりに定期的に決まった作業をするエージェントです。コンテナエージェントと違ってリポジトリでは作業せず、許可したTWPの機能（ツール）だけを使います。動く権限はオーナー（作成した本人）の権限の範囲に限られ、本人が見られない情報は取得できません。
一覧では、登録したエージェントごとにスケジュール・次回実行予定・最終実行の結果・許可したツールの数・オーナーを確認できます。上部には、有効にできる件数と本日の実行回数の上限に対する使用状況が表示されます。
作成する
「新規作成」を押すと設定画面が開きます。
| 項目 | 説明 |
|---|---|
| 名前 | 100文字以内。一覧に表示されます |
| 説明 | 何をするエージェントかの覚え書き（任意） |
| 指示文 | 実行してほしい手順を書きます。20,000文字まで。行頭のインデントは保持されます |
| スケジュール | 「一定間隔」「毎日」「毎週」「毎月」から選び、実行時刻を指定します。タイムゾーンは Asia/Tokyo 固定です |
| 許可ツール | エージェントが使ってよい機能を選びます。検索欄で絞り込めます。1つのエージェントで選べる数には上限があります |
| 書き込み系ツールの実行を許可する | オフのあいだは「書き込み」と表示されたツールを実行しません |
| スケジュール実行を有効にする | オフのあいだは自動実行されません（手動実行はできます） |
指示文は「どのツールをどの順番で使うか」まで書くと安定します。設定画面の入力例のように、番号付きの手順で書くのがおすすめです。
許可ツールは機能ごとに分類されて並び、それぞれ何ができるかの説明と、書き込みを伴うかどうかのラベルが付いています。必要なツールだけを選んでください。 選んでいないツールは、指示文に書いてあってもエージェントは実行できません。
動きを確かめる（ドライラン）
作成したら、まず一覧の操作メニュー（右端の「…」）から「ドライランで実行」を選んでください。ドライランでは書き込みだけを行わず、「何をしようとしたか」を記録します。問題なければ「今すぐ実行」で本番の動作を確認できます。
ドライランでも、AIが考えるためのトークン分のクレジットは消費されます。手動実行には1日あたりの回数制限があります（設定画面の下部に当日の実行回数が表示されます）。
実行はキューに入り、非同期で進みます。結果は一覧の「最終実行」列（ステータスと実行日時）で確認してください。
編集・削除・権限
設定の変更・削除・手動実行はオーナー本人だけが行えます。管理者にできるのは、参照・無効化・実行中のキャンセルです。一覧でも、オーナー以外には操作メニューを表示しません。
削除すると、そのエージェントの実行履歴も参照できなくなります。しばらく止めたいだけなら、削除ではなく「スケジュール実行を有効にする」をオフにしてください。
エラーが続くなどの理由でエージェントが自動停止された場合は、一覧の名前の下に停止理由が表示されます。指示文や許可ツールを見直してから、あらためて有効にしてください。
よくある質問
リポジトリが選べません
GitHub App がインストールされていないか、対象のリポジトリがインストール対象に含まれていません。全体管理者に「組織設定」→「GitHub連携」での設定を依頼してください。
セッションの画面を閉じても大丈夫ですか
問題ありません。処理はサーバー側で続き、セッション履歴から開き直せば途中経過と結果を確認できます。
コンテナエージェントとワーカーエージェントはどちらを使えばよいですか
「いま1回やってほしい」作業はコンテナエージェント、「毎朝・毎週など決まったタイミングで繰り返したい」作業はワーカーエージェントです。リポジトリのコードを触るのはコンテナエージェントだけです。
ワーカーエージェントが何も実行しません
「スケジュール実行を有効にする」がオフになっていないか、一覧の「次回実行」が「—（無効）」になっていないかを確認してください。有効にできるエージェントの数には、ユーザーごと・テナントごとの上限があります。
Claude Code から TWP を操作したい
その用途はMCP連携です。APIキーの発行と接続手順は Claude Code セットアップ をご覧ください。