Agent Space中切换模型不销毁Session，但需校验project_id绑定、上下文注入、工具兼容性及system prompt适配，并确保longMemoryProvider一致、标记字段可序列化、加载时指定model_hint。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Agent Space中切换模型时，Session本身不会被销毁或重置，但模型变更会直接影响当前Session中上下文的可用性、工具调用兼容性与响应行为一致性，必须同步校验project_id绑定状态与上下文注入路径是否仍有效。
确认Session生命周期不受模型切换影响
Agent Space的Session对象由create_session()创建后即独立于模型实例存在。调用session.switch_model("qwen-max")或通过配置热更新模型参数，仅替换LLM执行层，不触发session.destroy()或重建流程。
这一步操作起来很简单，直接调用switch_model即可生效，无需重启Agent或重传project_id。
【project_id必须在模型切换前已正确绑定】。如果切换发生在create_session()之前，或切换后未重新校验project_id与AGENTS.md路径匹配性，后续自动加载的结构化上下文将静默失效——你看到的仍是旧模型的输出风格，但项目约束（如db_compatibility: "v3.2+"）可能已被跳过。
模型切换后必须重验上下文注入有效性
方法一：检查AGENTS.md是否仍被加载
运行session.get_context("project_structure")，若返回None或空dict，说明项目级上下文未注入。此时需手动调用session.inject_context("project_structure", load_from_file("AGENTS.md"))——注意该方法不持久化，仅限本次Session。
智能订单处理助手，帮助用户快速创建WMS发货单。 当用户请求以下操作时使用： 1. 采购/下单/创建发货单（如"帮我采购一本书"、"帮我下单"） 2. 批量处理订单（如"帮我完成这个表格中所有订单的发货"） 3. 从Excel/CSV文件导入订单 支持从标准格式的Excel表格中提取：商品名称、数量、ISBN、收...
方法二：验证工具调用链是否断裂
切换至DeepSeek-VL模型后，原DashScope专属工具（如dashscope.image_understand）将不可用。若Session中已缓存tool_schema，需显式调用session.clear_tool_cache()再重新注册适配新模型的工具集。
方法三：强制刷新system prompt语义锚点
某些模型对system prompt格式敏感（如Qwen要求首行带标签）。若切换后响应变迟钝或忽略约束，执行session.update_system_prompt(render_system_prompt_for(model_name))，否则LLM可能把约束当普通文本处理。
持久化状态是否跨模型生效
第一步：确认longMemoryProvider配置未被覆盖
检查Agent初始化时openLongMemory是否为true，且longMemoryProvider值（如MEMOS）在模型切换前后保持一致。若切换模型时通过config.yaml覆盖了全局配置，可能导致persist_async写入失败而不报错。
第二步：验证mark_for_persistence标记字段是否仍可序列化
例如session.mark_for_persistence(["arch_decision"])在Qwen下保存成功，但切换至Llama-3后，若arch_decision含中文注释+emoji混合结构，部分Mem0后端会因UTF-8编码差异拒绝写入。此时需先调用session.prune_context(["arch_decision"])做轻量清洗。
第三步：加载时强制指定model-aware schema
从长期记忆恢复Session状态时，必须传入model_hint参数：session.load_from_persistence("u_7a9b", model_hint="qwen-plus")。不指定会导致context rot加剧——同一段架构决策描述，在qwen-plus中是高价值Token，在llama-3中可能被压缩为无意义摘要。
