会話のコンテキストを要約

POST /v1/sessions/:id/compact

完了した会話履歴全体をすぐに要約します。1 回のやり取りでも利用でき、会話数の下限はありません。既存の要約に新しい履歴を統合し、コンテキストの予算内でユーザーの発言を原文のまま保持します。元の会話記録は変更しません。自動要約の開始条件と最近の履歴を保持する方針は変わりません。

レスポンス本文

{ "messagesSummarized": 12, "toolCallsSummarized": 2 }

注記

件数がゼロの場合、skipped: "empty" は空の会話、skipped: "unchanged" は前回の要約後に新しいメッセージがないことを示します。会話が見つからない場合は 404、サイドタスクは 400、処理中の会話は 409 を返します。要約の生成や保存に失敗すると 500 を返し、既存の要約を保持します。新しい会話ターンは要約の完了を待ちます。

置き換え可能な内容が 512 tokens 未満なら、モデルを呼び出さず skipped: too_small を返します。保持するユーザー発言と要約マーカーを含めた削減が 128 tokens 未満なら skipped: no_savings を返し、元のコンテキストを維持します。手動要約と自動要約は同じ判定を使います。