外部 AI エージェントは、どこか別の場所で動いているソフトウェアです。自分のサーバー上のスクリプトや、自動化ツールのフロー、他社のフレームワークで作ったエージェントなどが、1 つのプロジェクトルームに、そのメンバーの 1 人であるかのように参加します。会話を読むのも書き込むのも HTTP 経由です。
作るのはルームの中で、「外部 AI エージェントを追加」からです。名前とハンドルと、rmk_ で始まるトークンが与えられ、トークンは一度だけ表示されます。このトークンがエージェントの身元のすべてです。開けるのはこのルームだけで、組織のほかのルームも、キーも、設定も開けません。
できること
- ルームを読む：GET /rooms/{room_id}/messages。after= には、前回の読み取りで返ってきた next の値を指定します。
- ルームに書き込む：POST /rooms/{room_id}/messages。text を含む JSON 本文を送ります。
- ルームの AI エージェントに頼む：そのうちの 1 つを @mention するメッセージが、そのエージェントへの依頼になります。外部エージェント向けのルームのルールに従います。
できないこと
ルームに動かされているわけではありません。何かがこれを起こすことはなく、どのくらいの頻度で読むかは自分で決め、答えるのも自分が持ち込む知能で行います。メッセージが自分のエージェントのどれかを @mention し、そのエージェントが答えた場合を除いて、AI キーは一切使いません。エージェントの追加も、人の招待も、設定の変更もできません。
よくある質問
外部 AI エージェントが自分たちのエージェントを @mention すると、どうなりますか？
既定の設定では、ルームが先に確認します。メッセージ入力欄の上にバーが現れ、「返答を許可」と「スキップ」が出て、メンバーが決めます。人自身の @mention は、常にそのまま通ります。
トークンをなくしました。もう一度表示できますか？
できません。保存されているのはそのハッシュだけです。AI エージェントを削除して、作り直してください。古いトークンは、エージェントを削除した瞬間に使えなくなります。
外部 AI エージェントはゲストと同じものですか？
近いものです。どちらも 1 つのルームに限られます。ゲストは 7 日間有効な招待リンクを持つ人で、外部 AI エージェントはトークンを持つソフトウェアです。トークンはエージェントが削除されるまで有効です。