記憶対応チャット

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

const client = new Sonzai({ apiKey: process.env.SONZAI_API_KEY! });
const AGENT_ID = "agent_abc";
const USER_ID  = "user_123";

// 最初の会話——エージェントはまだメモリを持っていない
for await (const event of client.agents.chatStream(AGENT_ID, {
userId: USER_ID,
messages: [
  { role: "user", content: "My name is Mia. I'm allergic to peanuts and I love hiking." },
],
})) {
process.stdout.write(event.choices?.[0]?.delta?.content ?? "");
}
// プラットフォームが抽出：name="Mia"、allergy="peanuts"、interest="hiking"

// 2回目の会話——エージェントは上記すべてを想起
for await (const event of client.agents.chatStream(AGENT_ID, {
userId: USER_ID,
messages: [
  { role: "user", content: "What snacks should I bring on my next hike?" },
],
})) {
process.stdout.write(event.choices?.[0]?.delta?.content ?? "");
}
// エージェントはMiaがハイキング好きでピーナッツアレルギーであることを知っている——再自己紹介は不要。

// オンボーディング時またはCRMインポート後に一度呼び出す
await client.agents.memory.seed(AGENT_ID, {
userId: USER_ID,
memories: [
  {
    content: "Mia is a 32-year-old UX designer based in Berlin.",
    type: "user_fact",
  },
  {
    content: "Mia subscribed to the Pro plan on 2024-11-03.",
    type: "shared_experience",
    occurred_at: "2024-11-03T00:00:00Z",
  },
  {
    content: "Mia prefers email over SMS for notifications.",
    type: "user_preference",
  },
  {
    content: "Mia mentioned she wants to get into trail running.",
    type: "user_goal",
  },
],
});

const results = await client.agents.memory.search(AGENT_ID, {
query: "diet restrictions food allergies",
userId: USER_ID,
limit: 10,
});

for (const fact of results.facts) {
console.log(`[${fact.type}] ${fact.content} (confidence: ${fact.confidence})`);
}
// [user_fact] Mia is allergic to peanuts (confidence: 0.97)
// [user_preference] Mia prefers nut-free snacks on hikes (confidence: 0.85)

// トップレベルのノードを取得
const tree = await client.agents.memory.list(AGENT_ID, {
userId: USER_ID,
includeContents: false,  // ノードのメタデータのみ、事実テキストなし
});

for (const node of tree.nodes) {
console.log(`${node.path} — ${node.fact_count} facts`);
}
// /identity/traits — 3 facts
// /preferences/interests — 5 facts
// /episodes/sessions — 12 facts
// /temporal — 2 facts

// ノードにドリルダウン
const identityNode = await client.agents.memory.list(AGENT_ID, {
userId: USER_ID,
parentId: "node_identity_traits_id",
includeContents: true,  // 事実テキストを含む
});

const timeline = await client.agents.memory.timeline(AGENT_ID, {
userId: USER_ID,
// オプション：日付範囲を絞り込む
start: "2025-01-01T00:00:00Z",
end:   "2025-12-31T23:59:59Z",
});

for (const entry of timeline.entries) {
console.log(
  `${new Date(entry.created_at).toLocaleDateString()} — ${entry.type}: ${entry.content}`
);
}

// このユーザーのすべての事実（ページネーション付き）
const facts = await client.agents.memory.listFacts(AGENT_ID, {
userId: USER_ID,
limit: 50,
offset: 0,
factType: "user_preference",  // オプションフィルタ
});

console.log(`Total facts: ${facts.total}`);
for (const f of facts.facts) {
console.log(`  ${f.content}`);
}

const snapshot = await client.agents.getTimeMachine(AGENT_ID, {
userId: USER_ID,
at: "2025-03-01T00:00:00Z",  // この時点でエージェントは何を知っていたか？
});

console.log("Known facts at 2025-03-01:");
for (const fact of snapshot.facts) {
console.log(`  ${fact.content}`);
}