保存と公開

これは LoopAgent を使ううえで最初に理解しておくべきルールであり、最も混同しやすいポイントでもあります。「保存」は Debug 版を更新するだけで、Online 版を更新するのは「公開」です。

中核となるルール

設定ページで保存をクリックする（モデルの変更、ペルソナの編集、ナレッジベースの紐付け、ツールの追加……）と → デバッグ版にのみ書き込まれ → 右側のデバッグチャットに即時反映されるため、すぐに検証できます。
しかし、すべての対外チャネル（Open API、共有ページ、Widget、Web サイトプラグイン、Telegram、Slack、LiveChat、LiveDesk……）が実行時に使うのは、最後に「公開」した時点で固定された設定スナップショットです。

「公開」をクリックしない限り、本番は常に古い設定のままです。

flowchart LR
    S[保存をクリック] --> DBG[Debug 版]
    DBG --> DC[Debug チャットに即時反映]
    P[公開をクリック] --> PROD[Online 版]
    PROD --> CH[対外チャネルに反映]

よくある質問：「設定／ペルソナを変更したのに、なぜ本番が変わらないのか？」——保存しただけで公開していないためです。変更を本番に反映させるには、もう一度公開／Release をクリックする必要があります。デバッグチャットが正常 ≠ 本番が正常。

LoopAgent が一度も公開されていない場合、対外チャネルはそのままエラーとなり、まったく動作しません。初めて API やチャネルに接続する前に、必ず一度公開してください。

何が公開に伴い、何が即時反映されるか

すべてが「公開」を必要とするわけではありません。区別しておくと遠回りを減らせます。

対象	いつ反映されるか
ペルソナ、ループ上限、モデル、各種能力のオン／オフと紐付け関係	公開に伴う（エージェント設定に属し、公開スナップショットに入る）
Agent プライベートスキル	公開に伴う（ペルソナと同じロジック）
組織／プラットフォームスキル	即時かつグローバル（保存すれば、それを参照するすべてのエージェントに反映）
ナレッジベース文書、重要イベントのデータ、ユーザー属性値	即時かつグローバル（設定ではなく実行時データ）

ひと言でいえば、設定変更は公開が必要、データ／組織レベルのリソース変更は即時反映。

デバッグチャット

設定ページ右側のデバッグチャットは、設定の効果を検証するためのものです。

読み込むのはデバッグ版の設定で、保存後すぐに反映されるため、繰り返し調整しながら即座に効果を確認できます。
デバッグチャットは実際の対話であり、同様に課金されます。
デバッグ／プレビュー状態ではターンをまたぐ履歴記憶を持ちません（毎回クリーンなコンテキスト）が、これは正常な挙動です。

連続送信されたメッセージは1つの返信にまとめられる

エージェントがまだ生成中のうちにさらにメッセージを送っても、それらのメッセージは失われません。システムはまずセッションロックを取りに行きます。取得できたものは即座に処理され、取得できなかったものはキューに入るか吸収待ちとしてマークされ、最終的に1つの返信にまとめられます。したがって「立て続けに数件送ったのに、返信は1件だけ」というのは設計どおりの挙動であり、メッセージが失われたわけではありません。

連続送信されたメッセージには2つの処理モードがあります。QUEUE（キュー） と APPEND（追加） です。

QUEUE（キュー、デフォルト）

キューに入ったメッセージはメッセージ境界でまとめられます——現在の返信が完全に終了して初めて、後続のメッセージが新しいターンとして処理されます。

メッセージ①がセッションロックを取得し、即座に処理されて単独で返信①を生成します。
メッセージ②③は①がまだ処理中のうちに到着し、ロックの取得に失敗してキューに入ります。
①が処理を終えてロックを解放すると、システムが自動的にもう1ターン実行し、キュー内の②③を一度にまとめて1つの返信にします。

メッセージ②自体には単独の返信が生成されません——ここが最も「メッセージが失われた」と誤解されやすい点です。

QUEUE モード：キューに入ったメッセージが本ターン終了後に1つの返信にまとめられる

APPEND（追加）

追加されたメッセージは本ターンの終了を待つ必要がなく、次にモデルへリクエストするタイミングで進行中のこのターンに吸収されます。

メッセージ②は①がまだ実行中のうちに到着しますが、キューに入らず、①の終了も待たず、「吸収待ち」とマークされるだけです。
エンジンが次のループに進み、モデルへリクエストを発行する際に、②の内容も併せて渡します。

まとめはループ境界で発生し、QUEUE より早いタイミングです。新しいメッセージも作られず、余分な返信も現れません。顧客が見るのは、依然として「追加」の影響を受けた同じ返信①です。実行中のリアルタイムな補足や軌道修正に適しています。

APPEND モード：追加メッセージが次のループリクエスト時に現在のターンへ吸収される

マルチモーダルの連続送信：ターン間で連続送信されたメッセージが画像、ファイル、音声などのマルチモーダルコンテンツを含む場合、まとめて処理する際にそれらも併せてモデルに提出されます——ただし、選択したモデルが対応するマルチモーダル入力能力をサポートし、入力設定で該当カテゴリが有効になっていることが前提です。

単一のキュー／追加メッセージの本文は最大 8192 文字までです。