用途:在 TanStack AI 中接入 Honcho 托管记忆,实现会话级的记忆召回与保存。
主要能力:Honcho 将记忆建模为会话中相互交换消息的 peer。recall 调用用户 peer 的 dialectic chat(),把综合后的对话式回答作为系统提示注入,因此没有离散记忆片段;save 则把本轮消息追加到会话。
使用方式:从 @tanstack/ai-memory 导入 memoryMiddleware,从 @tanstack/ai-memory/honcho 导入 honcho()。应按请求基于服务端已验证的 session 构建,切勿使用 req.body。示例: import { memoryMiddleware } from '@tanstack/ai-memory' import { honcho } from '@tanstack/ai-memory/honcho' function memoryFor(session: { userId: string; threadId: string }) { const memory = honcho({ user: session.userId }) return memoryMiddleware({ adapter: memory, scope: { threadId: session.threadId, userId: session.userId }, }) }
选项:user 为用户 peer id,回退到 scope.userId,再回退到 'demo-user';baseURL 默认为 HONCHO_URL 或 http://localhost:8001;workspaceId 默认为 HONCHO_APP_NAME 或 'ai-memory';apiKey 默认为 HONCHO_API_KEY;assistantId 默认为 'assistant'。
作用域字段:session key 为 {tenantId|_}{threadId};当设置 tenantId 时 peer id 为 {tenantId}{user},否则为 user 或 scope.userId;namespace 被忽略。
依赖与限制:@honcho-ai/sdk 是可选 peer 依赖,首次使用时惰性加载,需在使用 honcho() 的环境中安装。Honcho 不提供 LLM 工具。