自動化

Console ボット

範囲を限定した Archibot のボット作業をチャットで下書きし、タスクパケットをレビューして、顧客ポリシー、プロファイル、ブループリントのゲートが許可した場合にのみ実行します。

顧客管理者プラットフォームオペレーター

最終更新 2026年6月18日

ボットの用途

Console ボットは、範囲を限定して十分に説明された変更を、Console のマージイベント、レビュー、QA、人間による承認で終わる Archibot 作業に変えます。ボットタスクは、作業対象のリポジトリとブランチ、その中に留まるべきパススコープ、そして後の QA ステップで実行すべき QA ノートを取り込みます。

タスクを保存してもコードはマージされません。アカウントがセットアップ専用モードの間、画面には Setup only バナーが表示され、レビュー可能なタスクレコードを取り込んでいるだけです。実行が有効になっても、Console はワークスペースが開始する前に、ボットポリシー、選択されたプロファイル、許可されたブループリント、同時実行数の上限、月次予算をなお確認します。

ボットを使えるユーザー

顧客管理者は、自分のアカウントのボット作業を下書きおよび管理できます。プラットフォームオペレーターは、選択した顧客アカウントについて同じことができ、さらに実行をゲートするポリシー、プロファイル、ブループリントの設定を管理します。

顧客メンバーはボットページを開けません。メンバーがボットタスクを必要とする場合は、顧客管理者にレビューと下書きを依頼してください。

ページのレイアウト

Console のサイドバーから Bots を開きます。ヘッダーバナーには、アカウントに応じて Setup only または Workspace handoff enabled と表示され、右上に New bot task ボタンと Refresh が配置されています。

ヘッダーの下には、それぞれにカウントが付いたセクションタブの行があります。

チャットでタスクを形作る

Task chat タブは Chat with Archibot で開きます。これは以前の固定フォームを置き換えるものです。会話の中で作業を説明すると、詳細が明確になるにつれて Archibot がタスクパケットを埋めていきます。

1. Bots を開き、Task chat タブに留まります。
2. Chat with Archibot サブタブを使います。何を変更する必要があるか、何をもって完了とするか、QA がどう証明すべきかを尋ねる冒頭メッセージを読みます。
3. スターターピルを使って会話の焦点を絞るか、自分のメッセージを入力します。
   • Acceptance criteria は説明を合格/不合格の基準に変えます。
   • QA plan はブラウザチェック、データ設定、実行を失敗とすべき条件を下書きします。
   • Add evidence はノートや貼り付けた証拠からタスクを形作ります。
   • Narrow scope はボットが触れてよいリポジトリのパス、ブランチ、ファイルを絞り込みます。
4. Message Archibot に入力して Send を選びます(または Ctrl+Enter を押します)。各メッセージは QA ノートを更新し、タイトルやスコープを提案できます。
5. Task packet サブタブに切り替えて、保存前に Archibot が取り込んだ内容をレビューします。

リクエストは具体的に保ちます。明確な受け入れ基準を伴う「Space Console にフィールドを追加する」は機能しますが、「アプリを直す」や「リポジトリを片付ける」は機能しません。

タスクパケットのレビューと完成

Task packet サブタブは、タスクと共に保存されワークスペースに渡される値を示します。右上にフィールド数が表示され、上部の 3 つのサマリーカードは Customer、Profile、Source を示します。

パケットは、それぞれにカウントが付いた独自のサブタブに整理されています。

1. Overview は、顧客、プロファイル、タスクタイトル、ベースブランチを含むパケットのフィールドを一覧表示します。
2. Source は、ボットの作業元となる Repository URL と Base branch、そして変更を特定のフォルダ内に留めるべき場合の Path scope(例 src/, docs/)を保持します。
3. Product はオプションです。ボットがランタイムリポジトリに依存する製品リポジトリを編集する必要がある場合に Add dependent product repository をオンにします。その後、製品リポジトリの URL、ベースブランチ、Checkout path、Deploy command を設定します。最初にランタイムリポジトリが準備され、次に製品リポジトリがチェックアウト、デプロイされ、ワークツリーおよびマージイベントのソースとして使われます。
4. QA & save は QA notes(ブラウザチェック、データ設定、エッジケース)と保存コントロールを保持します。

準備ができると、QA & save のボタンはアカウントの状態に応じてラベルが付けられます。

• セットアップ専用モードでは Save draft と表示され、レビュー可能なタスクレコードのみを保存します。ワークスペース実行、予算、マージイベントの引き継ぎは無効のままです。
• ワークスペースの引き継ぎが有効な場合は Start bot と表示されます。

ボタンは、タスクタイトルと必須フィールドが設定されるまで無効のままです。プラットフォームオペレーターは、まず Customer アカウントも選択する必要があります。

ボットタスク

Bot tasks タブは、下書きおよび完了したタスクを、そのレビュー、QA、ログ、承認状態と共に一覧表示します。タスクを開いてそのパケットと履歴を確認します。不要になった下書きを停止するには、それをキャンセルします。キャンセルは監査レコードを保持し、タスクを削除する代わりにステータスを canceled に設定します。

実行履歴

実行が有効になると、実行はブランチを作成し、ワークスペースを準備し、その結果をマージイベントとして Console に渡せます。Run history タブは、各実行リクエストを左側に、Run detail パネルを右側に表示します。

詳細パネルは、実行ステータス、Mode、Branch、ランナージョブ、Activity タイムライン、サニタイズされた実行ログを示します。マージイベントが存在する場合、Open merge request がそれにリンクします。Console はレビューレイヤーであり続けます。必要なレビューと QA のゲートが通った後、Console から人がレビュー承認しマージします。レビューフローについては 永続環境と CI レビュー を参照してください。

ボットポリシー(オペレーター)

Bot policy タブは、ワークスペース実行が許可される前に顧客がどのボットをリクエストできるかを制御します。バッジは Customer enabled または Customer disabled を示します。

主なコントロール:

1. Allow bot runs for this customer は顧客スイッチです。ワークスペースが開始する前にグローバルプラットフォームスイッチと実行オーケストレーターも有効化されている必要があることを、このノートが思い出させます。
2. Default profile と Workspace target は、新しい実行に適用されるデフォルトを設定します。
3. Monthly bot budget units と Concurrent runs は、プリセットの選択肢と自由入力を提供します。
4. Log and artifact retention days は、ログと証拠を保持する期間を設定します。
5. Workspace cleanup は、各実行後にワークスペースを削除するか、デバッグのために失敗したものを残すか、手動で削除するまですべてを残すかを選びます。
6. Artifact handling は、Shared Drive へのアーカイブを含め、証拠の保持方法を選びます。
7. Allowed blueprints は、この顧客が実行できるブループリントを制限します。

Save policy を選んで設定を保存します。

ボットプロファイル(オペレーター)

Bot profiles タブは、タスク下書きで使われるワーカーテンプレート、推論、ツール、上限を定義する顧客固有のプロファイルを作成します。

1. プロファイルを所有する Customer アカウントを選びます。
2. New profile を選び、Profile name と使用する Blueprint を設定します。
3. プロファイルが変更してよい内容と QA がその作業をどう扱うべきかの Profile description を追加します。
4. Make this profile selectable をオンにして、新しい実行に使えるようにします。無効なプロファイルはセットアップのために表示されたままですが、使用すべきではありません。
5. Workspace target、Template、Reasoning effort、Runtime cap (seconds)、Monthly budget units、Concurrent runs、Tool allowlist を設定します。
6. Save profile を選びます。既存のプロファイルは Edit profile、Use as template、Delete profile を提供します。

ブループリント(オペレーター)

Blueprints タブは、Console managed feature、Console managed fix、Console managed docs などの固定されたワークフローテンプレートを一覧表示します。各カードは、そのレビューモデル、QA ステップ、ランタイム上限、ファイル予算を、Enabled または Setup only バッジと共に示します。

Enable for customer または Disable for customer を使って、顧客が実行できるワークフローを制御します。ここでブループリントを有効にしても作業は開始しません。ポリシーとプロファイルが選択できる範囲を広げるだけです。

安全なコンテンツ

パスワード、API キー、クッキー、招待リンク、Webhook シークレット、プライベートリポジトリトークン、データベース URL、Pod 環境変数、生ログ、顧客データを、ボットタスク、QA ノート、プロファイル、ブループリント設定に入れないでください。

安全なコンテンツには、リポジトリ URL、ブランチ名、Issue 参照、パススコープ、シークレットでないセットアップノート、表示されている Console エラー、検証すべきブラウザの挙動が含まれます。

この後に起こること

アカウントでボット実行が有効になると、保存されたタスクは制御されたワークフローの起点になり得ます。ワークスペースのセットアップ、実装、マージイベントの作成、レビュー、QA、人間による承認です。各ステップは、何かがマージされる前に通常の Console レビューゲートをなお通過します。

関連ガイド

• 永続環境と CI レビュー
• オペレーションセンター
• ワークスペース Archibot と Shared Drive
• オペレーター向けテナント管理
• ワークスペースの管理