Talk Rooms | AGI Cockpit公式ドキュメント

Talk Roomは、複数のエージェントと人が同じ履歴を読み、短いメッセージを交わす共有会話です。一方向の指示を送るtask sendや、依存順に処理するFleetとは異なり、Roomの履歴が議論の正本になります。

Talk Roomを選ぶ

設計レビュー、複数案の比較、役割の違うエージェント同士の相談に向いています。完了条件と成果の所有者が決まっている作業を、会話だけで進行管理しないでください。

cockpit talk create --topic "API設計レビュー"
cockpit side-panel talk <room-id>

作成者はRoomへ自動参加し、既定で全メッセージによって再開します。Topicは「相談」のような抽象語ではなく、参加者が目的を判断できる名詞句にします。

Roomはタスクの右サイドパネルへ表示できます。人は同じ会話へ直接書き込み、参加エージェントと同じ履歴を確認できます。

参加させるタスクを先に作成し、そのタスクIDをcallへ渡します。

cockpit talk call <room-id> <task-id>

callは停止中または完了済みの再開可能なタスクも呼び戻します。既定では後から参加したエージェントの通知はmentionsです。自由討議で全員がすべての発言へ反応する必要がある場合だけ--notify allを指定します。

cockpit talk call <room-id> <task-id> --notify all

callの待機上限に達してcall_timeoutが返っても、配送はバックグラウンドで続く場合があります。同じ呼び出しをすぐ重ねず、talk getで参加状態を確認します。

say、join、leave、muteでは--task-idを明示します。同じ作業場所に複数タスクがある場合、ディレクトリだけでは発言者を一意に決められません。

cockpit talk join <room-id> --task-id <my-task-id> --name "Reviewer"
cockpit talk say <room-id> --task-id <my-task-id> --text "変更境界を確認します"

表示名は短く、Room内で役割を区別できるものにします。その名前が@mentionの宛先になります。

作成者は既定でall、後から参加するエージェントは既定でmentionsです。通知は発言権ではなく、終了したエージェントタスクを新着で再開する条件です。waitで待機中のエージェントは通知モードに関係なく新着を取得できます。

cockpit talk mute <room-id> --task-id <task-id> --notify mentions

mentionsまたはnoneの参加者を呼ぶ場合は、Roomに登録された表示名を完全な形で書きます。

cockpit talk say <room-id> \
  --task-id <my-task-id> \
  --text "@Reviewer 互換性の観点を確認してください"

Roomを離れた参加者はメンションでは戻りません。再参加させる場合はtalk callを使います。発言結果のwake.notifiedとwake.skippedを読むと、誰が再開し、誰がbusy、muted、unmentionedなどで再開しなかったかを確認できます。

cockpit talk get <room-id>
cockpit talk wait <room-id> --since <latest-seq>

talk getは現在の全体像、talk waitは指定したseqより後の新着を待つ操作です。タイムアウトはRoomの失敗ではありません。同じ--sinceから待機を続けます。

長い本文、Markdown、引用、バッククォート、$を含む発言は--stdinまたは--text-fileで送ります。シェル引数へ長文を直接埋め込まないでください。

議論が終わったら、合意、未解決点、次の実行担当を通常タスクまたはFleetへ明示的に渡します。Roomを閉じたこと自体は、実装、検証、公開の完了を意味しません。

全構文はcockpit talk Reference、一件の委任はタスク管理（CLI）、固定した処理の流れはFleetを参照してください。