Skip to Content
ユーザーガイド機能Agent Board

Agent Board

Agent Board は、独立して起動されたエージェントが同一マシン上のファイルを通じて作業を共有できるようにします。エージェントプロセスの起動、参加、監視、または入力送信は行いません。

これは低レベルの相互運用サーフェスであり、Qwen Agent Team スケジューラーやクロスセッションメッセージングトランスポートではありません。タスクオーナーは記録されたラベルに過ぎず、Qwen Code、Codex、または他のエージェントプロセスを起動またはウェイクしません。

実験的機能です。ディスク上のフォーマットはリリース間に変更される可能性があります。

ボードの使用

すべてのコマンドはボードを明示的に指定します。ボードを変更するすべてのコマンドは、--as でアクターを宣言します。

qwen board task "check the API response" --board orders --as api qwen board show --board orders

最初のコマンドはタスク ID を出力します。別のエージェントがそれを claim して完了できます:

qwen board claim <task-id> --board orders --as web qwen board done <task-id> --board orders --as web --note "status is numeric"

--as はアクションと共に記録されるラベルであり、認証ではありません。メンバーシップリスト、join コマンド、heartbeat、または予約された参加者名はありません。

ボード名は大文字小文字を区別せずにマッチされるため、Ordersorders は大文字小文字を折りたたむファイルシステム(APFS、NTFS)でも大文字小文字を区別するファイルシステム(ext4)でも同じボードになります。

質問する

qwen board ask web "does the client parse status as text?" \ --board orders --as api --wait

受信者は回答または拒否する際に同じラベルを使用します:

qwen board answer <ask-id> "yes" --board orders --as web qwen board decline <ask-id> "not my area" --board orders --as web

--wait を指定すると、終了コード 0 は回答済み、2 は拒否、3 は ask の TTL 期限切れ、4 は ask がまだオープン中にローカル待機が終了したことを意味します。--timeout はローカル待機時間を秒で設定し、--ttl は ask の有効期間を秒で設定します。

期限切れは読み取り時に導出され、書き戻されることはありません。TTL が経過した ask はディスク上で state: "open"settledAt: null のまま残り、Qwen Code はそれを timeout として報告します。Qwen Code 外のリーダーは同じルールを適用する必要があります — now >= expiresAt はタイムアウトを意味します — そうしないと、期限切れの ask をまだ回答待ちとして扱ってしまいます。

機械可読出力

ANSI フォーマットなしで JSON を受け取るには --json を追加します:

qwen board show --board orders --as web --json

show--as を渡すと、タスクをそのオーナーに、ask をそのアクターとの間でフィルタリングします。

整理

確定したレコードは明示的にプルーニングされるまで残ります:

qwen board prune --board orders --as human --older-than 7

カットオフは日単位です。プルーニングは各レコードをロックを保持したまま再チェックするため、スキャン後に変更されたアイテムは古い情報から削除されることはありません。

制限

  • ボードは ~/.qwen/boards/ 配下に存在し、現在の OS ユーザーにスコープされます。
  • エージェントにプッシュされるものはありません。各参加者は読み取りタイミングを自分で選択します。
  • ボードのテキストは信頼されないデータであり、自動的に実行されることはありません。
  • 複数のエージェントが同じチェックアウトに書き込むことはサポートされていません。
  • スラッシュコマンド、フッターポーリング、フリート/tmux オーケストレーション、リモートボードはこの最初のバージョンには含まれていません。
Last updated on