agent.summarize() はローカルエージェントの会話を要約して Run を返す。CLI の /summarize と同じ操作。以降の送信は全文ではなく要約をモデルへ渡す。

ts
const run = await agent.summarize();
const result = await run.wait();

if (result.status === "finished") {
  console.log(result.result);
}

result.result は要約文、または要約できなかったときのトリム済みトランスクリプト。fallback: true のときは長いメッセージを切ったり一部を落とすことがある。コンテキストは空く。

要約は全部か無しか。実行中のキャンセル、または status が error のときは、以降の送信も全文のまま。クラウド(セルフホストのプールやマシンを含む)と、まだ会話の無いエージェントでは ConfigurationError になり実行しない。クラウド側はコンテキストが埋まるときに自分で要約する。別の実行が動いているあいだは send() と同様に例外になる。

要約の実行は summary メッセージ(SDKSummaryMessage)を流す。running のあと completed か error。コンテキスト上限に近づいた自動要約も、ローカルとクラウドの send() で同じメッセージを運ぶ。error のときは会話を変えない。

#参考文献