架构
心智层平台如何融入您的应用架构。
系统概览
心智层是一个独立平台，将智能体的智能（人格、记忆、情绪）与您的应用逻辑分离。任何后端都可以通过 REST API 或官方 SDK 进行集成。
您的后端 心智层平台
| |
|--- 创建智能体 ------------------>|
|<-- 智能体 ID + 档案 ------------|
| |
|--- 聊天 (SSE 流式) ------------>|
| (消息 + 应用上下文) |-- 构建上下文
|<-- 流式 AI 响应 ----------------|-- 流式 AI 响应
| |-- 更新记忆、情绪、人格
|<-- 主动通知 --------------------| (自动完成，无需额外调用)三层服务架构
典型部署包含三个协同工作的层级：
您的后端
处理认证、应用状态、用户会话和业务逻辑。拥有所有应用数据。通过 SDK 或 REST API 调用心智层实现 AI 交互。
Express, Django, 自定义后端
心智层平台
拥有智能体的智能：人格、记忆、情绪、习惯、目标和关系。一次聊天调用即可完成上下文组装、AI 流式响应和对话后学习。
Sonzai 心智层平台
AI 服务
无状态 LLM 层。接收丰富的上下文，生成 AI 响应、图像、视频和音频。
Sonzai AI 服务
平台管理的内容
每次聊天调用时，平台会自动从人格、记忆、情绪和关系数据中组装相关上下文，然后生成 AI 响应。对话后的状态更新自动完成 — 无需额外的 API 调用。
上下文组装人格、情绪、记忆、关系叙事和应用状态 — 每次请求自动组装。
记忆提取从每次对话中自动提取事实、事件和承诺并存储。
情绪与人格演化情绪和大五人格根据交互模式自然漂移。
主动通知智能体可以在会话之间安排主动触达。通过轮询或 Webhook 接收。
数据所有权
心智层和您的后端各自拥有不同的数据：
心智层拥有
- • 智能体人格档案
- • 记忆事实和摘要
- • 情绪状态（快乐、精力、平静、亲密）
- • 人格演化历史
- • 习惯和目标
- • 关系叙事
- • 知识库实体和图谱
- • 自定义智能体状态
您的后端拥有
- • 用户认证
- • 业务逻辑和工作流
- • 用户档案和偏好
- • 应用数据和状态
- • 计费和订阅
- • 权限和访问控制
- • 会话管理
会话生命周期
1. 用户开始聊天
您的后端准备应用上下文（用户数据、偏好...）
2. 对话进行
您的后端 ---> Chat SDK 调用（上下文 + 消息）
用户 <--- 流式 AI 响应 token
3. 对话结束
平台更新：记忆、情绪、人格、习惯、关系
4. 会话间隔期
平台运行：后台整合、情绪衰减、主动唤醒SDK 集成点
使用官方 SDK 与平台的每个部分交互：
Agentscreate, get, list, update
Chatchat, chatStream (SSE)
Memoryseed, search, list, browse, timeline, listFacts, reset
Personalityget, update, history
Moodget, history, aggregate
Knowledge BasecreateSchema, insertFacts, bulkUpdate, search, recommendations, trends
Custom Statescreate, get, upsert, list, delete
Custom Toolscreate, list, delete (agent-level and session-level)
Notificationslist, consume, history
User PrimingprimeUser, batchImport, getMetadata, updateMetadata