パターン 5: スタンドアローンメモリ（バッチ）

会話の所有権はあなたにあります。Sonzai はリアルタイムには介入しません。 通話終了、サポートケースのクローズ、ジャーナリングセッションの完了など、 会話が終わったタイミングでトランスクリプトを 1 回だけ POST すれば、 Sonzai の抽出器がそれをファクト、ムード更新、パーソナリティのドリフト、 習慣検出、プロアクティブな連絡シグナルへ変えます。チューター、フィットネス、 CRM、音声通話、ジャーナリングなど、Sonzai がホットパスにいることが 許容されない／不可能なフローに最適です。

使うべき時

• レイテンシ予算がターンごとの /turn ラウンドトリップに耐えられない。
• すでにトランスクリプトが存在する（録音、Gong/Zoom のエクスポート、 ジャーナルのエントリ）。
• 事後にバッチで取り込みたい — ログのリプレイ、ユーザー移行、エージェント 品質のベンチマーク。

切り替えるべき時

• ターンごとに新鮮なコンテキストが必要 — パターン 4: スタンドアローン・リアルタイム。
• LLM 呼び出しまで Sonzai に任せられる — パターン 1: マネージドランタイム。

アーキテクチャ

┌─────────────┐     ┌──────────────────┐     ┌──────────────┐
│  Your App   │     │   Sonzai API     │     │   Your LLM   │
└──────┬──────┘     └────────┬─────────┘     └──────┬───────┘
     │                     │                       │
     │  GET /context       │                       │
     │────────────────────>│ (optional pre-session │
     │  <── user profile ──│  personalization)     │
     │                     │                       │
     │  ══ Your conversation (Sonzai not involved) ═════════│
     │                     │                       │              │
     │  Chat ──────────────┼──────────────────────>│             │
     │  <── reply ─────────┼───────────────────────│             │
     │  [N turns, your loop, your tools]            │             │
     │                     │                       │             │
     │  ════════════════════════════════════════════════════════│
     │                     │                       │
     │  /process or sessions.end({ messages })     │
     │────────────────────>│── extract facts,      │
     │  (full transcript)  │   personality, mood,  │
     │                     │   habits, interests   │
     │  <── extractions ───│   (Sonzai LLM)        │
     │                     │                       │
     │  Use insights       │                       │
     │  (push notif,       │                       │
     │   dashboard,        │                       │
     │   exercises, …)     │                       │
     └─────────────────────┴───────────────────────┘

エンドツーエンドの例

もっとも簡単な経路は /process：1 回の呼び出しで自動的にセッションを作成し、 生成された session_id を相関付けに使えます。セッションスコープのツール、 通話時間、非同期ポーリングが必要な場合は、明示的な sessions.start → end({ messages }) ライフサイクルを使います。

import { Sonzai } from "@sonzai-labs/agents";

const sonzai = new Sonzai({ apiKey: process.env.SONZAI_API_KEY! });

async function ingestTranscript(
agentId: string,
userId: string,
transcript: { role: "user" | "assistant" | "tool"; content: string; tool_calls?: any[] }[],
) {
// One call. Auto-creates a session. Tool messages allowed.
const result = await sonzai.agents.process(agentId, {
  userId,
  messages: transcript,
  provider: "gemini",                          // optional override
  model:    "gemini-3.1-flash-lite-preview",   // optional override
});

// result.session_id is the auto-created session id.
// Pull extractions from the read endpoints when ready:
const memory = await sonzai.agents.memory.list(agentId, { userId });
const mood   = await sonzai.agents.getMood(agentId, { userId });

return { sessionId: result.session_id, memory, mood };
}

次に読む