スマートフォンでのdurable agentの表示

実験的。 スマートフォン上でdurable agentが表示する内容は、今後のマイナーリリースで変更されるか、機能自体が削除される可能性があります。durable agentに存続を決定する条件が記載されています。

このページでは、ダッシュボードの行、会話リスト、質問、チャット、スターター、プッシュ通知など、スマートフォン上でdurable agentが表示されるすべての場所を説明します。durable agentで最初にdurable agentをアタッチします。

durable agentは、helloで実行可能と宣言した操作のコントロールのみを描画します。コントロールを指定している以下の行は、durable agentがそれを宣言していることを前提としています。

ダッシュボードのDurable agentsセクション

各durable agentは、スペースとは別のDurable agentsセクションに1行として表示されます。

ソケット、あるいはhttp://127.0.0.1またはhttp://localhost経由でアクセスされたdurable agentはlocalになります。それ以外のURLはすべてremoteになります。

このセクションはスペースの下に配置されます。ユーザーの入力を待っている会話が1つでもあるdurable agentが存在する場合はスペースの上に移動し、最後の1つに応答すると再び下に戻ります。durable agentが1つもアタッチされていない場合、このセクションは描画されません。

「要対応ペインのみ表示」が有効な場合、このセクションにはユーザー待ちのdurable agentのみが一覧表示されます。行をタップすると、状態を問わずそのdurable agentの会話リストが開きます。

会話リスト

durable agentのホームには、メッセージングアプリのチャット一覧と同じ形式で会話が一覧表示されます。

ユーザー待ちの会話が先頭に表示され、その後にその他の開いている会話が新しい順に並びます。クローズした会話は「Closed」ラベルの下に続きます。各行にはタイトル、状態マーク、最終アクティビティの時刻が表示され、その下の1行に待機中の質問（なければdurable agentのサブタイトル）が表示されます。待機中の行には、保留中の質問数も表示されます。タイトルのない行には「Untitled conversation」と表示されます。

開いている行をタップするとChatで開きます。クローズした行をタップすると読み取り専用で閲覧できます。durable agentが会話の再開に対応している場合、クローズした会話には「Reopen」ボタンが表示されます。

開いている行はダッシュボード自体のデータから取得されるため、即座に描画されます。クローズした行はdurable agentから取得され、Collieはアクセスごとに1回、および会話のオープン/クローズ時に再問い合わせを行います。毎回のポーリングで取得されることはありません。

履歴を保持しない durable agent は、進行中の会話のみを表示し、Closed グループや注記は表示しません。描画済みのリストは、その後の読み込みが失敗してもそのまま表示され続けます。

スマートフォンでの質問

durable agent による質問は、対象となるツール呼び出しの下にチャット内のカードとして表示されます。

キャプションには durable agent の名前が表示されます（"Needs your answer · desk"）。durable agent が有効期限を設定した場合、タイトルの下の行に "Expires in 4 min"、"Expires in 40 s"、"Expired" とカウントダウンされます。期限切れ後もボタンは残り、遅れてタップされた場合は durable agent 自身が回答します。

"Always allow" には2回のタップが必要です。1回目のタップでボタンが "Tap again to always allow" とツール名に変わり、2回目で送信されます。質問にツール名が含まれていない場合、Collie はこのボタンを表示しません。

Collie が durable agent の文言を切り詰めたり整理したりした場合、全文が表示されていないため、カードに "Text shortened" と表示され "Always allow" は選択できなくなります。

この Collie が認識できない種類のカードは、その文言を表示し、"This ask cannot be answered from the phone." と表示します。会話内では最初の5件の質問がカードとして描画され、"Show N more" 行から残りを展開できます。

タップ後の動作

各タップは1つのリクエストIDを保持し、タップ操作によってのみ回答が送信されます。

レシート

Collie は、ユーザーが回答しなかった質問がどう終了したか、また durable agent が拒否された理由を表示します。

スマートフォンから回答した質問や、ターンを停止したために終了した質問には、この行は残りません。操作したカードが既に表示されています。

警告ボックスには双方が対応するwireバージョンが表示されます (例: 「Program speaks wire v2, this Collie speaks v1. Update Collie, or the durable agent's SDK.」)。古い方を更新してください。ルールについてはバージョンを参照してください。

チャット

durable agentの会話は、唯一のビューであるChatで開きます。

生成中のreply、thinking、notice、markdownアイテムには末尾にカーソルが表示され、時刻は表示されません。最終テキストを受信するとカーソルは消えます。停止したターンには「stopped」というメモが残ります。

ユーザー自身の行

[送信] をタップした瞬間に、小さな時計アイコンとともに入力行がスレッドに表示されます。durable agent自身のコピーが到着すると、その行と置き換わります。

リクエストIDをエコーバックしないdurable agentは、30秒以内の同一テキストによって照合されます。durable agentが書き戻さなかった行は、10分後に表示されなくなります。

スレッド内でユーザーの行が最新であり、durable agentがまだ応答していない間は、3つのドットが処理中であることを示します。

ヘッダー

ヘッダーは2行で構成されます。1行目には会話のタイトルとExperimentalバッジが表示されます。

進行状況は、会話の処理中またはユーザーの入力を待っている間にのみ表示されます。

ベルト

ベルトにはSteerとStopが配置され、続いてdurable agent固有のボタンが最大4つまで配置されます。

Steerは、新しいターンを開始する代わりに実行中のターンにテキストを送信します。Stopは実行中のターンを終了します。現在操作できないボタンはその場でグレーアウトされるため、位置がずれることはありません。

タップすると、スマートフォン側で最後に確認されたターンが指定されます。すでに会話が進んでいた場合は何も実行されず、スマートフォンに「The conversation moved on, so the action did not run.」と表示されます。内容を確認し、実行を継続したい場合はもう一度ボタンをタップしてください。

durable agentペインに含まれない要素

durable agentには画面がないため、そのペインにはTerminalビュー、タブストリップ、ペインストリップ、Keys/Type/Quickボタンがありません。メニューにもHistory、Pane settings、Pin to top rowはありません。メニュー内のCloseは「Close conversation」と表示されます。

New conversationとスターター

durable agentのNewページは「New conversation」というタイトルになり、durable agentのスターターが一覧表示されます。

スターターはフォルダーやテキストを受け取りません。作業場所はdurable agent側が決定します。スターターをタップすると、durable agentが新しい会話を開きます。このページからマシンのagent、シェル、コマンドを指定することはできません。スターターが存在しないdurable agentの場合、「This machine's durable agent offers no starters yet.」と表示されます。

プッシュ通知

durable agentごとの上限内であれば、質問をスマートフォンにプッシュ通知できます。

プッシュ通知には「Permission needed in」とペイン名が表示されます。durable agentは、最大60文字の独自のタイトルと最大120文字の1行を追加できます。Collieはマシン、durable agent、ツール呼び出しごとに質問を1回プッシュ通知するため、再起動後に再度尋ねられた質問は表示のみが行われ、プッシュ通知は送信されません。詳細はdurable agentからのプッシュ通知を参照してください。

マスキング

シークレットマスキングが有効な場合（COLLIE_REDACT、デフォルトで有効）、Collieはdurable agentの会話リストのタイトルとサブタイトルに含まれるシークレットをマスクします。

crew内

leadのダッシュボードには、crewの各マシンに対応するDurable agentsセクションが1つずつあります。メンバーのdurable agentは2行目にメンバー名を追加し（例: pi-durable, local, workshop）、lead自身のdurable agentにはマシン名が付きません。いずれかのマシンで質問が発生すると、その該当セクションがスペースの上に移動します。誰が何に応答するかについてはcrew内のdurable agentを参照してください。