怎样做seo网站推广,wordpress提高浏览量,公司注册网上核名几个字,做盗版电影网站赚钱BackendProtocol 深度解析 一、什么是 BackendProtocol#xff1f; BackendProtocol 是 deepagents 定义的统一后端协议#xff0c;用于抽象文件存储和执行环境。它是一个抽象基类#xff08;ABC#xff09;#xff0c;所有后端实现都必须遵循这个协议。 ┌───────…BackendProtocol 深度解析一、什么是 BackendProtocolBackendProtocol是 deepagents 定义的统一后端协议用于抽象文件存储和执行环境。它是一个抽象基类ABC所有后端实现都必须遵循这个协议。┌─────────────────────────────────────────────────────────┐ │ BackendProtocol │ │ (统一文件操作接口) │ ├─────────────────────────────────────────────────────────┤ │ • ls_info() - 列出目录文件及元数据 │ │ • read() - 读取文件内容 │ │ • grep_raw() - 文本搜索 │ │ • glob_info() - 文件模式匹配 │ │ • write() - 写入新文件 │ │ • edit() - 编辑现有文件 │ │ • upload_files() - 上传文件 │ │ • download_files() - 下载文件 │ └─────────────────────────────────────────────────────────┘ ▲ │ 扩展 │ ┌─────────────────────────────────────────────────────────┐ │ SandboxBackendProtocol │ │ (增加沙箱执行能力) │ ├─────────────────────────────────────────────────────────┤ │ • id - 沙箱唯一标识 │ │ • execute() - 执行 Shell 命令 │ │ • aexecute() - 异步执行 Shell 命令 │ └─────────────────────────────────────────────────────────┘二、核心设计目标2.1 存储后端解耦# 所有文件数据统一表示为{content:list[str],# 文本行created_at:str,# ISO 时间戳modified_at:str,# ISO 时间戳}2.2 可切换的执行环境┌─────────────────────────────────────────────────────────┐ │ 开发/测试环境 │ │ StateBackend │ │ (内存模拟安全) │ └─────────────────────────────────────────────────────────┘ │ │ 切换 backend 参数 ▼ ┌─────────────────────────────────────────────────────────┐ │ 生产环境 │ │ FilesystemBackend │ │ (真实文件系统/S3/数据库) │ └─────────────────────────────────────────────────────────┘三、应用场景3.1 场景一开发环境 vs 生产环境fromdeepagentsimportcreate_deep_agentfromdeepagents.backendsimportStateBackend,FilesystemBackend# 开发环境 - 内存模拟安全不会真实写文件dev_agentcreate_deep_agent(backendStateBackend,)# 生产环境 - 真实文件系统prod_agentcreate_deep_agent(backendFilesystemBackend(root_dir/workspace),)优势开发测试用StateBackend操作只在内存中不会影响真实文件系统生产部署用FilesystemBackend操作真实持久化3.2 场景二沙箱隔离执行fromdeepagents.backendsimportSandboxBackend# 容器化沙箱环境 - 执行命令安全隔离sandbox_agentcreate_deep_agent(backendSandboxBackend(container_imagepython:3.12,timeout300,),)# 可以安全执行用户提供的代码# 即使在容器内 rm -rf / 也不会影响宿主机适用代码执行平台用户自定义脚本运行需要安全隔离的场景3.3 场景三云端文件存储fromdeepagents.backendsimportS3Backend# 使用 S3 作为文件存储后端cloud_agentcreate_deep_agent(backendS3Backend(bucketmy-agent-files,regionus-east-1,),)# 所有文件操作都持久化到 S3# agent 重启后文件依然存在适用需要持久化存储多实例共享文件分布式 Agent 系统四、使用案例4.1 案例一自定义 Backend 实现fromdeepagents.backends.protocolimportBackendProtocol,FileInfo,WriteResultclassDatabaseBackend(BackendProtocol):将文件存储在数据库中的自定义后端def__init__(self,db_connection):self.dbdb_connectiondefls_info(self,path:str)-list[FileInfo]:# 从数据库查询文件列表filesself.db.query(SELECT * FROM files WHERE parent_path ?,path)return[FileInfo(pathf[path],is_dirf[is_dir],sizef[size],modified_atf[modified_at])forfinfiles]defread(self,file_path:str,offset:int0,limit:int2000)-str:# 从数据库读取文件内容file_dataself.db.query_one(SELECT content FROM files WHERE path ?,file_path)ifnotfile_data:returnError: File not foundlinesfile_data[content].split(\n)[offset:offsetlimit]return\n.join(f{i1}|{line}fori,lineinenumerate(lines))defwrite(self,file_path:str,content:str)-WriteResult:# 写入文件到数据库try:self.db.execute(INSERT INTO files (path, content) VALUES (?, ?),file_path,content)returnWriteResult(pathfile_path,files_updateNone)exceptExceptionase:returnWriteResult(errorstr(e))# ... 实现其他方法# 使用自定义后端agentcreate_deep_agent(backendDatabaseBackend(my_db_connection),)五、协议方法详解5.1 核心文件操作方法功能典型用例ls_info(path)列出目录内容探索项目结构read(path, offset, limit)分页读取文件大文件分段读取write(path, content)创建新文件生成代码文件edit(path, old, new)精确替换文本修改代码glob_info(pattern, path)模式匹配文件查找所有.py文件grep_raw(pattern, path, glob)文本搜索搜索 TODO 注释5.2 批量文件传输# 批量上传responsesbackend.upload_files([(/app/config.json,b{key: value}),(/app/data.txt,bcontent),])# 批量下载responsesbackend.download_files([/app/config.json,/app/data.txt,])六、架构优势总结┌─────────────────────────────────────────────────────────┐ │ Agent 应用层 │ │ create_deep_agent() │ └─────────────────────────────────────────────────────────┘ │ │ 使用 BackendProtocol ▼ ┌─────────────────────────────────────────────────────────┐ │ BackendProtocol │ │ (统一抽象接口层) │ └─────────────────────────────────────────────────────────┘ │ │ │ ▼ ▼ ▼ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ StateBackend│ │FilesystemBE │ │ SandboxBE │ │ (内存) │ │ (磁盘) │ │ (容器) │ └─────────────┘ └─────────────┘ └─────────────┘核心优势可测试性- 用StateBackend单元测试不影响真实文件系统可替换性- 轻松切换存储后端本地/云端/数据库安全性- 沙箱环境隔离危险操作可扩展性- 自定义 Backend 满足特殊需求统一接口- 上层代码无需关心底层实现七、Backend 在 create_deep_agent 中的使用方式使用流程图┌─────────────────────────────────────────────────────────┐ │ create_deep_agent(backendxxx) │ │ 用户传入 backend │ └─────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────┐ │ Line 193: backend backend if backend is not None │ │ else (StateBackend) │ │ 默认值StateBackend内存模拟 │ └─────────────────────────────────────────────────────────┘ │ ▼ ┌───────────────┴───────────────┐ │ │ ▼ ▼ ┌─────────────────┐ ┌─────────────────┐ │ 子代理中间件栈 │ │ 主代理中间件栈 │ │ (gp_middleware) │ │(deepagent_middleware) └─────────────────┘ └─────────────────┘ │ │ 注入 backend 注入 backend │ │ ▼ ▼ FilesystemMiddleware(backend) FilesystemMiddleware(backend) SummarizationMiddleware(backend) SummarizationMiddleware(backend) SkillsMiddleware(backend) SkillsMiddleware(backend) MemoryMiddleware(backend) SubAgentMiddleware(backend)具体注入位置1️⃣通用子代理的中间件栈Line 196-208gp_middleware[TodoListMiddleware(),FilesystemMiddleware(backendbackend),# ← 注入SummarizationMiddleware(modelmodel,backendbackend,# ← 注入# ...),AnthropicPromptCachingMiddleware(),PatchToolCallsMiddleware(),]ifskillsisnotNone:gp_middleware.append(SkillsMiddleware(backendbackend,sourcesskills))# ← 注入2️⃣用户自定义子代理的中间件栈Line 236-252subagent_middleware[TodoListMiddleware(),FilesystemMiddleware(backendbackend),# ← 注入SummarizationMiddleware(modelsubagent_model,backendbackend,# ← 注入# ...),AnthropicPromptCachingMiddleware(),PatchToolCallsMiddleware(),]ifsubagent_skills:subagent_middleware.append(SkillsMiddleware(backendbackend,sourcessubagent_skills))# ← 注入3️⃣主代理的中间件栈Line 267-292deepagent_middleware[TodoListMiddleware(),]ifmemoryisnotNone:deepagent_middleware.append(MemoryMiddleware(backendbackend,sourcesmemory))# ← 注入ifskillsisnotNone:deepagent_middleware.append(SkillsMiddleware(backendbackend,sourcesskills))# ← 注入deepagent_middleware.extend([FilesystemMiddleware(backendbackend),# ← 注入SubAgentMiddleware(backendbackend,# ← 注入subagentsall_subagents,),SummarizationMiddleware(modelmodel,backendbackend,# ← 注入# ...),AnthropicPromptCachingMiddleware(),PatchToolCallsMiddleware(),])最终传递链┌─────────────────────────────────────────────────────────┐ │ deepagent_middleware (7-8 个中间件) │ │ 每个中间件都持有 backend 引用 │ └─────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────┐ │ create_agent(middlewaredeepagent_middleware) │ │ 传递给 LangChain 基础框架 │ └─────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────┐ │ 运行时Agent 调用工具 │ │ → FilesystemMiddleware 使用 backend.read/write() │ │ → SkillsMiddleware 使用 backend 加载 skill 文件 │ │ → MemoryMiddleware 使用 backend 读取记忆文件 │ │ → SummarizationMiddleware 使用 backend 存储摘要 │ └─────────────────────────────────────────────────────────┘关键总结中间件使用 backend 做什么FilesystemMiddleware文件操作ls,read,write,edit,grep,globSkillsMiddleware从 backend 加载 skill 文件SKILL.mdMemoryMiddleware从 backend 读取记忆文件AGENTS.mdSummarizationMiddleware将消息摘要存储到 backendSubAgentMiddleware传递给子代理子代理也使用相同的 backend一句话总结backend被注入到所有需要文件系统能力的中间件中Agent 运行时通过这些中间件调用 backend 的方法来实现文件操作、技能加载、记忆读取等功能。参考[1]. deepagents-0.4.4.dist-info