系统概览

心智层是一个独立平台，将智能体的智能（人格、记忆、情绪）与您的应用逻辑分离。任何后端都可以通过 REST API 或官方 SDK 进行集成。

您的后端                        心智层平台
   |                                  |
   |--- 创建智能体 ------------------>|
   |<-- 智能体 ID + 档案 ------------|
   |                                  |
   |--- 聊天 (SSE 流式) ------------>|
   |    (消息 + 应用上下文)           |-- 构建上下文
   |<-- 流式 AI 响应 ----------------|-- 流式 AI 响应
   |                                  |-- 更新记忆、情绪、人格
   |<-- 主动通知 --------------------|   (自动完成，无需额外调用)

集成架构

典型部署包含三个协同工作的层级：

您的前端

面向用户的应用。向后端发送消息并渲染智能体响应。示例：React、Next.js、Vue、移动应用。

您的后端

处理认证、应用状态、用户会话和业务逻辑。通过 SDK、REST API、MCP 或 OpenClaw 插件调用心智层实现 AI 交互。示例：Express、Django、Go、OpenClaw。

Sonzai 心智层

拥有智能体的智能：人格、记忆、情绪、习惯、目标和关系。一次聊天调用即可完成上下文组装、AI 流式响应和对话后学习。示例：api.sonz.ai。

平台管理的内容

每次聊天调用时，平台会自动从人格、记忆、情绪和关系数据中组装相关上下文，然后生成 AI 响应。对话后的状态更新自动完成 — 无需额外的 API 调用。

上下文组装

人格、情绪、记忆、关系叙事和应用状态 — 每次请求自动组装。

记忆提取

从每次对话中自动提取事实、事件和承诺并存储。

情绪与人格演化

情绪和大五人格根据交互模式自然漂移。

主动通知

智能体可以在会话之间安排主动触达。通过轮询或 Webhook 接收。

数据所有权

心智层和您的后端各自拥有不同的数据：

心智层拥有

智能体人格档案
记忆事实和摘要
情绪状态（快乐、精力、平静、亲密）
人格演化历史
习惯和目标
关系叙事
知识库实体和图谱
自定义智能体状态

您的后端拥有

用户认证
业务逻辑和工作流
用户档案和偏好
应用数据和状态
计费和订阅
权限和访问控制
会话管理

会话生命周期

1. 用户开始聊天
 您的后端准备应用上下文（用户数据、偏好...）

2. 对话进行
 您的后端 ---> Chat SDK 调用（上下文 + 消息）
 用户 <--- 流式 AI 响应 token

3. 对话结束
 平台更新：记忆、情绪、人格、习惯、关系

4. 会话间隔期
 平台运行：后台整合、情绪衰减、主动唤醒

后台处理与自我改进

平台不仅响应 chat 调用——它运行一个持续的后台管道，使记忆保持准确性、行为状态保持连贯性，并随时间提升检索质量。每个循环都自动运行；你方面无需调度或配线。

周期	运行内容
每轮	重要性+置信度更新、情绪调整、性格微偏移、习惯观察、关联强化、来源锚定检查
每次会话结束	带验证的事实抽取、重复整合、下一会话预测、检索策略更新、模式学习、会话质量打分、话题转换审计
日常	记忆衰减（重要性、置信度、关系、习惯）、记忆树自组织和修剪、深度整合、聚类调和、目标整合、反思性日记、收敛检查
每周	叙事弧压缩、关联衰减、交叉引用检测、新智能体–用户对的预热、学习节奏检查
持续	自适应检索预算、记忆恢复、回归预测、后台兴趣研究、周期性事件检测、智能记忆选择

有关每个机制的完整说明——包括可逆去重、话题转换检测、性格漂移安全上限、突破和谨慎部署系统——请参阅智能体如何随时间变得更聪明。

SDK 集成点

使用官方 SDK 与平台的每个部分交互：

Agents：create, get, list, update
Chat：chat, chatStream (SSE)
Memory：seed, search, list, browse, timeline, listFacts, reset
Personality：get, update, history
Mood：get, history, aggregate
Knowledge Base：createSchema, insertFacts, bulkUpdate, search, recommendations, trends
Custom States：create, get, upsert, list, delete
Custom Tools：create, list, delete (agent-level and session-level)
Notifications：list, consume, history
User Priming：primeUser, batchImport, getMetadata, updateMetadata

架构