智能体调试需先停用旧实例并清除state.json、memory.db和cache/，再通过命令行、VS Code扩展或代码三种方式重建；验证时需确认日志显示工具加载数正确且内存为空，并通过带工具调用的请求测试无历史引用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在开发调试智能体过程中，需要频繁销毁旧实例并重建新配置，避免状态残留导致工具调用失败或记忆错乱。
确认当前智能体实例是否处于运行状态
打开 VS Code 的 AgentKit-VSCode 扩展侧边栏 → 点击顶部「Agent Manager」标签 → 查看列表中目标智能体右侧状态图标：绿色圆点表示运行中，灰色方块表示已停止。【若状态为绿色却无响应，说明实例已卡死，必须强制销毁】
执行 agentkit stop --id <your-agent-id> 命令终止进程，等待终端返回 “Stopped” 提示后再继续下一步。
清除残留状态与缓存文件
进入项目根目录下的 .agentkit/ 子目录。
删除以下三项：
• state.json（保存了上一次执行的规划路径与工具调用上下文）
• memory.db（SQLite 格式对话记忆库，不删会导致新实例加载旧对话）
• cache/ 文件夹（含临时工具参数快照与LLM响应缓存）
注意：不要手动删除 config.yaml 或 tools/ 目录——它们属于配置层，需保留用于重建。
Agent 记忆系统 — 五路融合检索 + 双时间线 + 因果链 + Spirit管家 + 记忆回声 + 弹性配置 + Circuit Breaker + GDPR合规 + 192项安全审计修复
重建智能体实例的三种方式
方法一：命令行全自动重建
执行 agentkit create --from-config config.yaml --id new-test-202608，框架将自动读取配置、注册全部工具、初始化空记忆库，并启动监听服务。
方法二：VS Code 扩展界面重建
在 Agent Manager 列表中右键点击已停用的智能体 → 选择「Rebuild with current config」→ 弹窗中勾选「Clear memory on rebuild」→ 点击「Confirm」。这一步会跳过手动删文件环节，但【不清理 cache/ 目录，仅适用于快速验证配置语法】。
方法三：代码级重建（适用于集成到 Python 脚本）
在你的主程序中调用：
from agentkit import AgentBuilder<br>builder = AgentBuilder.from_config("config.yaml")<br>agent = builder.build(reset_memory=True)其中
reset_memory=True 会自动触发 memory.db 的清空与重建，无需额外操作。
验证新实例是否干净启动
第一步：检查日志输出
启动后观察终端日志，确认出现两行关键信息：
• “Loaded 5 tools from ./tools/”（数字应与你实际工具数一致）
• “Initialized empty memory store”（若出现 “Loaded memory from …” 则说明未清空成功）
第二步：发起一次试探性调用
向新实例发送一条带工具意图的请求，例如：“查一下今天北京天气”。
若返回结果中包含 "tool_calls": [{"name": "weather_api", ...}] 且无历史对话引用，则证明实例重建成功。
