メモリと重要イベント

メモリパネルは2種類のメモリを管理します。対話コンテキスト（短期メモリ、フルコンテキスト）と、重要イベント（セッションをまたぐ長期の業務メモリ）です。

短期メモリ

短期メモリは、エージェントが「直近の数ターンの対話を覚えていられる」かを決めます。

メモリパネルの**「直近 N ターンのチャット履歴を有効化」**設定で制御されます。直近何ターンの対話を保持するか（1問1答を1ターンとする）を設定でき、デフォルトは 30 ターンです。
オフにすると、ターンをまたぐ履歴がモデルに渡されなくなり、エージェントは「前のターンを忘れ」ます。顧客から「前のターンを覚えていない」と言われたら、まずここを確認してください。
デバッグ／プレビュー状態では常に空のメモリ（毎回クリーンなコンテキスト）ですが、これは正常です。

フルコンテキスト

短期メモリウィンドウでは、古いターンはデフォルトで「何を尋ね、何を答えたか」のプレーンテキストしか保持しません——そのときどのツールを呼び出し、どんなパラメータを渡し、どんな結果を得たかは履歴に残りません。フルコンテキストは短期メモリの上に重ねる層で、直近の数ターンに完全なツール呼び出しの軌跡（どのツールを呼び出したか、入力パラメータ、戻り値）を追加で持たせ、モデルが直前に具体的に何をしたかを正確に覚えていられるようにします。

メモリパネルのフルコンテキスト設定で制御されます（値は「直近 N ターン」と表示）。デフォルトは 1 ターン、範囲は 0–5 です。0 はオフを意味します（それより前のターンは問答テキストのみを保持）。
これは短期メモリのターン数とは2つの独立した設定であり、互いに影響しません。
ターン単位でカウントし（1問1答を1ターンとする）、返信の件数ではカウントしません。同じターン内に複数の返信があっても、途中で切り分けられることはありません——1ターンまるごとツール軌跡を持たせるか、まったく持たせないかのどちらかです。

いつ大きくするか：モデルが「前のターンで結局どのツールを呼び出し、どんなパラメータを渡したかを覚えていないようだ」というとき、まずこの値が 0 や小さすぎに設定されていないか確認し、大きくすればよいです。逆に、持たせるターン数が多いほどToken 消費の増え方が速くなるため、大きければよいというものではありません——通常は 1〜2 ターンで十分です。

重要イベント

重要イベントは LoopAgent のセッションをまたぐ、ユーザー単位の長期メモリです（チケットに相当）。モデルは対話の中で、ユーザーのためにイベント（「返金処理」「アカウント異常」など）を能動的に作成／更新／照会します。同じユーザーが別のセッションで戻ってきても、それを見て引き続き進められます。

イベントはユーザーの識別情報に紐づき、そのユーザーのすべてのセッションをまたいで閲覧・変更できます。
毎ターンのシステムプロンプトには、そのユーザーの未クローズのイベントを最大 5 件自動的に含めます。それ以上必要な場合はモデルが能動的に照会します。

通常の Agent／FlowAgent との違い：3種類のエージェントは同一の重要イベント設定（スイッチ＋イベントタイプ）を共有しますが、書き込み方が異なります——LoopAgent はモデルが対話の中で同期的に書き込みます（本ターンで直接イベントを作成／変更）。通常の Agent／FlowAgent は対話後にバックグラウンドで非同期に抽出します。重要イベントの概念、イベントタイプの設定、活用シナリオなどの共通内容は、重要イベントを参照してください。

表示される前提：2つの条件をどちらも満たす

重要イベント関連のツールが表示されるには、次を同時に満たす必要があります。

メモリ内の重要イベントのメインスイッチがオンになっている。
イベントタイプの分類に少なくとも1つのタイプが設定されている。

スイッチはオンでも、イベントタイプを1つも作成していない場合 → 重要イベントのツールは表示されず、履歴イベントも注入されません。これは不具合ではありません。

よくある質問

「イベント作成でパラメータエラーが出る」：多くの場合、モデルが使ったイベントタイプが、あなたが設定したタイプ辞書に存在しません。モデルが渡したタイプと設定ページのタイプ名が一字一句一致しているか（大文字・小文字、スペースに敏感）を照合してください。
「作成したのに再訪時に照会できない」：まずユーザーの識別情報が解決されていない（匿名／チャネルセッション）ことを疑ってください。この場合、イベントはセッション単位でフォールバックされるため、セッションをまたぐ検索では漏れる可能性があります。