agent space 中保存预览状态需在关键节点显式调用 save_state()，支持内置接口、手动数据库插入和 cli 命令三种方式，并通过查询 sessions 表、验证 state_data 可解析性及加载比对完成确认。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 Agent Space 中保存预览状态，是为了让中断后的调试过程可续跑、多会话不混淆、工具执行结果不丢失。这一步不是简单存个变量，而是要把当前会话的上下文快照、工具调用链、未完成任务标记、以及关键中间状态写入持久化层。
确认预览状态保存的触发时机
Agent Space 的预览状态默认只在主动调用 save_state() 时写入，不会在每次模型输出后自动保存。如果你正在调试一个长流程（比如跨3轮工具调用的报销审核），但没手动触发保存，中断后将丢失全部中间状态。
必须确保在关键节点——例如工具返回成功响应后、用户输入新指令前、或准备进入条件分支前——显式调用状态保存逻辑。
使用 SQLite 持久化保存预览状态
方法一：调用内置 save_state 接口
进入调试会话后，在 Python 控制台或 CLI 中执行：agent.save_state(session_id="preview_abc123")。该操作会把当前内存中的 state 字典序列化为 JSON，并写入 sessions 表的 state_data 字段。
方法二：手动构造并插入数据库
若需覆盖特定字段（如强制重置 retry_count 或注入调试标记），可直连 SQLite 数据库：INSERT INTO states (session_id, key, value) VALUES ("preview_abc123", "debug_flag", "true");。注意：此操作绕过校验逻辑，【务必先备份 sessions.db 文件】，否则可能破坏状态一致性。
方法三：通过 CLI 命令触发
从经过验证的商家搜索、比较并购买产品。返回包含决策包（优缺点、适用场景、过敏原、验证价格）的结构化产品数据，而非原始网页抓取结果。无需验证码或身份验证。覆盖约980种产品和10家商家。适用于用户想要查找、比较或购买产品的场景。
在命令行交互界面中输入：/save preview_abc123。该命令会自动提取当前会话上下文、过滤掉临时缓存字段（如 _temp_buffer）、压缩大体积工具返回体后再落库。
验证预览状态是否已正确保存
第一步：检查 sessions 表是否存在对应记录
运行 SQL 查询：SELECT session_id, created_at, updated_at FROM sessions WHERE session_id = 'preview_abc123';。若返回空行，说明 save_state 未执行或 session_id 拼写错误。
第二步：确认 state_data 字段非空且可解析
执行：SELECT state_data FROM sessions WHERE session_id = 'preview_abc123';。返回值应为合法 JSON 字符串，且包含 "last_tool_call"、"step_index" 等关键键。如果字段为空或为 null，说明保存流程在序列化阶段失败，常见原因是 state 中混入了不可 JSON 序列化的对象（如文件句柄、线程锁）。
第三步：加载并比对状态内容
在 Python 中调用：agent.load_state("preview_abc123")，观察返回字典是否与中断前最后一轮的 agent.state 完全一致。特别注意 messages 列表长度、最后一条 role 是否为 "assistant"、以及 tool_calls 中的 id 是否连续。
