必须提前创建对应的数据表;当智能体需留存对话历史、维护重启不丢失的状态、写入时序数据缓存或使用memory.recall查询日志时,须手动预置表,且建表前需确认数据库类型、配置一致性和主键索引定义。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用函子Zion搭智能体时,是否需要先建数据表,取决于你打算让智能体执行的任务类型——如果涉及结构化数据读写、状态持久化或跨会话记忆,【必须提前创建对应的数据表】;如果只是做纯推理、调用外部API或临时计算,可跳过建表直接启动。
哪些场景必须建表
当你的智能体要处理以下任一任务时,Zion运行时会在首次访问时尝试自动建表,但失败概率极高,务必手动预置:
• 用户对话历史需长期留存并支持语义检索;
• 智能体要维护设备状态(如“服务器A当前负载”“工单B处理进度”),且该状态需在重启后不丢失;
• 需对接内部MES/SCADA系统,将采集的时序数据写入本地缓存表供后续分析;
• 使用Zion内置的记忆回溯功能(memory.recall)查询过去72小时内的操作日志。
建表前必须确认的三件事
第一步:确认Zion连接的是SQLite还是PostgreSQL。SQLite默认使用./zion.db文件,无需额外建库;PostgreSQL则需提前在目标实例中创建空数据库,并赋予Zion账号CREATE TABLE权限。
第二步:检查Zion配置文件中database.dialect字段值是否与实际一致——若填postgresql但连的是SQLite,建表语句会直接报错退出,且不会回退到内存模式。
第三步:在zio_schema.sql中定义主键和索引。Zion不自动添加主键,若遗漏id字段或未设PRIMARY KEY,后续insert会因约束缺失导致部分工具调用静默失败,排查极难。
快速建表示例(以用户记忆表为例)
方法一:用Zion CLI自动生成
执行zion schema init --table=user_memory,它会输出标准建表SQL,复制进psql或DB Browser for SQLite执行即可。
方法二:手写最小可用表(推荐)
CREATE TABLE user_memory (id TEXT PRIMARY KEY, session_id TEXT NOT NULL, timestamp DATETIME DEFAULT CURRENT_TIMESTAMP, content TEXT, embedding BLOB);
【embedding字段必须声明为BLOB类型】,Zion向量检索依赖该字段原生二进制存储,若误设为TEXT会导致相似度计算完全失效。


















