SMBeterCD的博客

在Agent任务执行中，通过interrupt_on设定工具中断权限（如approve、edit、reject等），结合checkpointer实现状态保存与恢复。利用when函数定义中断触发条件，如文件写入非工作区路径。文件系统中断通过permissions配置，自定义中间件可于after_model等节点调用interrupt()实现人工介入。中断后需通过Command(resume={...})传递反馈，确保并发请求的正确匹配，保障流程可控性与安全性。

Agent记忆分为短期与长期：短期记忆存于会话线程中，通过Trim、Delete、Summarize等策略管理，依赖StateBackend；长期记忆持久化于文件或数据库（如Postgres），支持跨会话调用，按assistant_id、user_id、org_id分类存储，使用CompositeBackend实现分流。自定义AgentState与ToolRuntime可实现状态读写，结合@before_model中间件控制记忆更新，适用于开发（InMemoryStore）与生产（PostgresStore

SKILL与TOOL本质区别在于：tool是原子操作工具（如搜索、计算），而skill是指导复杂任务的方法论，常调用多个tool。一个完整skill由SKILL.md及可选的script、references、assets目录构成，支持渐进式加载以节省上下文。其三种存储后端分别为本地文件系统、状态内存和持久化Store，适用于不同场景，支持多用户共享与优先级覆盖。

异步子Agent通过AsyncSubAgent解决主Agent阻塞问题，实现任务并行。基于ASGI或HTTP传输，主Agent可异步创建、查询、更新或取消子任务，通过thread_id与独立会话交互。借助async_tasks通道隔离上下文，确保通信可靠性。本地部署时零延迟、免鉴权，支持高效协同，提升系统响应性与可扩展性。

主agent派生出子agent去执行拆分出的任务的主要目的之一就是通过这种方法，某些拆分出来的任务的执行过程产生的上下文对主线任务的执行是不必要的，所以将这个任务给子agent去做，仅接收子agent的执行结果，而中间过程无需返回。

DeepAgent按中间件传入方式分为三类：默认中间件（Filesystem、Summarization、PatchToolCalls）保障长程任务上下文管理；专有参数配置中间件（如SubAgent、Skills、Memory等）实现子代理、技能、记忆等功能；通过middleware参数配置的中间件（如TodoList）支持任务拆解与持久化。三类协同，提升Agent在复杂任务中的可扩展性与鲁棒性。

本文介绍虚拟文件系统在Agent上下文管理中的核心作用：通过有选择地存储历史对话与工具调用信息，解决上下文溢出问题。系统支持按需加载、分类管理，并提供多类可插拔存储后端（如临时、本地磁盘、沙箱等），结合权限控制与自定义扩展能力，实现安全、高效、可复用的上下文持久化机制。

【代码】deepagent 学习笔记 1。