AgentKit智能体实例销毁重建配置实操方案

智能体调试需先停用旧实例并清除state.json、memory.db和cache/，再通过命令行、VS Code扩展或代码三种方式重建；验证时需确认日志显示工具加载数正确且内存为空，并通过带工具调用的请求测试无历史引用。

在开发调试智能体过程中，需要频繁销毁旧实例并重建新配置，避免状态残留导致工具调用失败或记忆错乱。

确认当前智能体实例是否处于运行状态

打开 VS Code 的 AgentKit-VSCode 扩展侧边栏 → 点击顶部「Agent Manager」标签 → 查看列表中目标智能体右侧状态图标：绿色圆点表示运行中，灰色方块表示已停止。

执行 agentkit stop --id 命令终止进程，等待终端返回 “Stopped” 提示后再继续下一步。

清除残留状态与缓存文件

进入项目根目录下的 .agentkit/ 子目录。

删除以下三项：
• state.json（保存了上一次执行的规划路径与工具调用上下文）
• memory.db（SQLite 格式对话记忆库，不删会导致新实例加载旧对话）
• cache/ 文件夹（含临时工具参数快照与LLM响应缓存）

注意：不要手动删除 config.yaml 或 tools/ 目录——它们属于配置层，需保留用于重建。

重建智能体实例的三种方式

方法一：命令行全自动重建
执行 agentkit create --from-config config.yaml --id new-test-202608，框架将自动读取配置、注册全部工具、初始化空记忆库，并启动监听服务。

方法二：VS Code 扩展界面重建
在 Agent Manager 列表中右键点击已停用的智能体 → 选择「Rebuild with current config」→ 弹窗中勾选「Clear memory on rebuild」→ 点击「Confirm」。这一步会跳过手动删文件环节，但

方法三：代码层面的重建（适用于集成到Python脚本中）
在您的主程序里进行调用：

from agentkit import AgentBuilder
builder = AgentBuilder.from_config("config.yaml")
agent = builder.build(reset_memory=True)

验证新实例是否干净启动

第一步：留意日志输出
启动后密切关注终端日志，留意是否出现两行关键信息：
• “Loaded 5 tools from ./tools/”（这里的数字需与你实际的工具数量保持一致）
• “Initialized empty memory store”（若出现 “Loaded memory from …” ，则表明未成功清空）

第二步：发起一次试探性调用
向新实例发送一条带工具意图的请求，例如：“查一下今天北京天气”。
若返回结果中包含 "tool_calls": [{"name": "weather_api", ...}] 且无历史对话引用，则证明实例重建成功。