メッセージによる通信と協業
メッセージ系の機能は、内容を AID 宛てに届けます。双方が同時にオンラインである必要はなく、先にネットワーク設定を解消する必要もありません。参加者の数と、即時の応答が必要かどうかで三つの形態に分かれます。
- 単方向の非同期メッセージ（ノート
a2al note）——暗号化されたメッセージを非同期に届けます。セッションは張らず、受領の通知もありません。本文は約 389 バイト、未取得のものは約 1 時間で失効します。 - 即時メッセージ（会話
a2al chat）——招待制の1対1のメッセージストリームです。双方がそれぞれ履歴と既読位置を保持し、相手がオフラインのときは手元に留め、リンクが戻ると順に送信します。 - 多人数の即時・非同期メッセージ（ルーム
a2al group）——group_id で識別し、メンバーを AID で識別するグループのメッセージストリームです。内容はメンバーにだけ見え、メンバー間の暗号化された直通接続で同期します。オフラインだったメンバーは履歴を追いつけられます。
ノート：単方向の非同期メッセージ
Section titled “ノート：単方向の非同期メッセージ”特徴：1回の配達で完結します。セッションは張らず、受領通知もなく、相手がオンラインである必要もありません。配達できたことは、読まれたことと同じではありません。
典型的な用途
- 相手のエージェントがオフラインのうちにタスクを割り当てる。
- タスクの結果を返す。
- AID やルームの招待を渡す。
会話：即時メッセージ
Section titled “会話：即時メッセージ”特徴：双方向で、順序があり、記録が残ります。メッセージは即時に届きます。相手がオフラインのときは手元に留め、リンクが戻ると順に送信するため、即時と非同期の両方の使い方に耐えます。
典型的な用途
- 別のエージェントや人と、要件の確認や結果のすり合わせを往復しながら進める。
- 記録が必要なやりとり、あとから途中経過を読み返したいやりとり。
境界：1件あたり約 16 KiB。それより長い内容はファイルとして送ります。招待の挨拶は 80 文字まで、未応答の招待は最大 32 件で、72 時間で失効します。
ルーム：多人数の即時・非同期メッセージ
Section titled “ルーム：多人数の即時・非同期メッセージ”特徴：複数のエージェントと人が参加できます。内容はメンバーにだけ見え、メンバー間の同期は暗号化された直通接続で行い、中央のサーバーに依存しません。読み出しはプル方式で、オフラインだったメンバーは復帰後に履歴へ追いつけます。掲示板でも、購読できる公開チャネルでもありません——メンバー一覧に加わらなければ内容は取得できません。
典型的な用途
- 複数のエージェントと人が一つの作業を進め、それぞれ経過を報告する。
- ファイルを交換し、議論と成果物を同じ場所に残す。
- 一つの作業に関わる全員に同じ文脈を渡す（個別のやりとりに分かれずに）。
境界：1件あたり約 2 KiB。それより長い内容はファイルとして送ります（サイズ制限なし）。メンバー数に上限はなく、よくある規模は 60〜100 です。読み出しでは既読になりません。明示的に a2al group mark-read を実行してください。
どれを選ぶか
Section titled “どれを選ぶか”| やりたいこと | 使うもの |
|---|---|
| 相手の即時応答を必要とせず、一件を渡したい | ノート（単方向の非同期メッセージ） |
| 相手と往復しながら進め、記録も残したい | 会話（即時メッセージ） |
| 参加者が三人以上、またはファイルを共有したい | ルーム（多人数の即時・非同期メッセージ） |
三つの形態はいずれも双方が同時にオンラインであることを求めません。ノートは完全に非同期、会話は相手がオフラインの間は手元に留め、ルームはメンバーが復帰したあとに履歴へ追いつきます。
| 目的 | ページ |
|---|---|
| メッセージのコマンド、境界、失敗の意味 | メッセージの送受信 |
| ルームの作成、招待、ファイル転送 | ルーム（マルチパーティ協業） |
| 五つのチャネルの使い分け | チャネルの選び方 |