版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
基于AgentScope2.0Harness构建企业级、分布式智能体CONTENT目录01AgentScope2.0介绍02AgentScopeHarness核心设计03AgentScopeRoadmap01AgentScope2.0介绍AgentScope概览AgentScope是阿里巴巴推出的一款面向企业级、分布式场景的智能体开发框架,覆盖Python、Java、Typescript、Golang(建设中)语言实现。AgnetScope生态核心目标:提供一套覆盖“开发、部署、调优”全生命周期的生产级解决方案,让智能体应用的开发更简单、运行更稳定、效果更卓越。A2APostgreSQL1Qdrantmem0MySQL.TableStoreEventBridgeORACLEA2UIredismongoDB!OCEANBASE)>MilvusSQLServerOSSSQLiteAG-UIAgentScope-SamplesResponseAPICustomizableAgentsQwenPawTool&SkillSafetyBrowser-UseData-JuicerAgentDeepResearchHigressAlGatewayMulti-AgentMemorylawEvoTraderSmall-LargeModelCollaborationMore...Manager-WorkersArchitectureSparkDesignAgentScope2.0TSAgentServiceData-Juicer*ClaudeSessionManagementBackgroundTaskManagementUserAuthentication&AuthorizationdeepseekCronJobManagementStorage/DBManagementWorkspacePool✦GeminiOpenJudgeAgentEngineWorkspaceEventSystemGLMLocalFileSystemReasoningMessage&EventDockerPermissionSystemEventStreamingToolkitOpenAISReMeHuman-in-the-LoopBatchActingCloudSandboxQwenAgentMiddlewareModelContextManagementAzureActingTrinity-RFTReasoningRetriesStructuredCompressionChatModelSystemPromptTTS/RealtimeReplyModelStudioFallbackContextOffloadOllamaLoongSuiteARMS010ligressLangfuseDockervLLMZEROSLSRocketMQOpenTelemetryLangSmithPhoenixNACOS.SGLE2B02AgentScopeHarness核心设计AgentScopeHarness总体架构在ReActAgent之上,把长期运行agent必备的工程能力打包应用·用户请求HarnessAgent薄包装·能力叠加在ReAct循环的关键时机·内部middleware顺序固定WorkspaceMemoryCompactionSubagentsFilesystemSkills人格/知识双层长期记忆上下文压缩子agent编排技能装配本机/KV/沙箱Channel/GatewayPermissionPlanMode只读思考+HITL会话·路由·SSE工具白名单ReActAgent·推理循环(core)·Harness不改写此层,只叠加钩子共享对象(能力间零耦合,只通过这三者通信)RuntimeContextWorkspaceAgentStateStoreuserId·sessionId·extra跨请求恢复运行时状态AGENTS.md·MEMORY·skillsAgentScopeHarness快速体验`<dependency>``<groupId>`’io.agentscope</groupId>`<artifactId>`’agentscope-harness</artifactId><version></$)';>';dependency>publicclassFirstAgent{publicstaticvoidmain(String[]args){HarnessAgentagent=HarnessAgent.builder().name("note-taker").sysPrompt("你是一个帮助用户做笔记的助手。")//字符串形式由ModelRegistry解析—自动读取DASHSCOPE_API_KEY;//切换其他厂商时改用"openai:gpt-5.5"、"anthropic:claude-sonnet-4-5"、//"gemini:gemini-2.0-flash"或"ollama:llama3"。.model("dashscope:qwen-plus").workspace(Paths.get(").(agentscope/workspace"))..compaction(CompactionConfig.builder()triggerMessages(30).keepMessages(10).build().build();.();RuntimeContextctx=RuntimeContext.builder().sessionId("demo-session")).userId("alice")).build();//第一轮:自我介绍+当天的事agent.call(newUserMessage("我叫天宇,今天准备一个关于ReAct的技术分享。"),ctx).block();//第二轮:同sessionId,自动恢复上一轮状态后回答agent.call(newUserMessage("我叫什么?我今天要干什么?"),ctx).block();Workspace--智能体进化的SourceofTruth「智能体是什么」+「学到了什么」都是文件内容按生命周期分三类四条设计线索静态资产工程师编辑定义与进化都是文件不散落代码、不绑数据库;一个目录拷走=完整agentAGENTS.md·knowledge/·skills/·subagents/·tools.json运行时文件框架/agent写生命周期三分静态/运行时/长期记忆·走不同读写路径agents/`<id>`/sessions/·agents/`<id>`/tasks/·plans/原生多租户隔离IsolationScope:SESSION/USER/AGENT/GLOBAL长期记忆agent+后台任务MEMORY.md·memory/YYYY-MM-DD.mdWorkspace⊥';-:;:(,,);-:">Filesystem同一份目录布局→三种物理后端可切换抽象文件系统-Workspace的物理载体同一份逻辑目录,三种物理后端,agent代码零改动Workspace·逻辑目录布局AbstractFilesystem接口・WorkspaceManager路由默认多副本隔离SandboxLocal+ShellRemoteKV提供ShellX不提供Shell容器内ShellDocker·K8s·E2B·Daytona·AgentRunOverlay:workspace+projectRedis·JDBC·OSS·Nacos路径策略ROOTED/SANDBOXED本机模板+远端覆盖(两层读)WorkspaceProjection(SHA-256增量)单进程·本机开发·信任环境多副本共享MEMORY/sessions快照恢复pip/npminstall状态生产跑不可信代码首选快、简单、无外部依赖管理台改文件下轮生效内置上下文压缩策略-四道防线让对话保持在token预算内,同时不丢关键信息压缩流水线(按触发时机排布)Tool执行ResultEvictionTruncateArgsSummaryLLMOverflowRecover产生工具结果单条>80K落盘上下文留首尾+指针大参数字符串截断零LLM成本前缀→结构化摘要尾部保留原文真的撞墙→极端压缩自动重试一次可调节的杠杆压缩不会触碰的内容触发阈值triggerMessages·triggerTokensPlanMode状态AgentState.planModeContext保留窗口keepMessages·keepTokens子agent后台任务agents/`<id>`/tasks/`<sid>`.jsonFlush时机ALWAYS·NEVER·THROTTLEDtodo_write清单AgentState.t-="-a:'';-sk:;:(,,)">-s="-:'C';ont-e:;:(,,)">xt独立小模型compaction.model/memory.model权限规则AgentState.request卸载排除read_file·grep_files默认排除永不压缩对话日志sessions/`<';-si:;:(,,)">`<d>`.log.jsonl双层长期记忆-事实自动沉淀让agent记住跨会话的事实,同时避免上下文无限膨胀对话messagesFlushLLM第一层·日流水账当前上下文memory//YYYY-MM-DD.md・追加・未去重每次call结束ConsolidationLLM后台节流·最少30min/次每轮注入第二层·MEMORY.mdSystemPrompt合并去重·策划后的长期记忆<memory_context>agent主动查询工具session_searchmemory_searchmemory_get见到MEMORY..md截断提示时会自动调用管线里的三次独立LLM调用(定制入口)FlushConsolidationCompactionSummaryMemoryConfig.';f-:;l:(,,);-:">ushPromptMemoryConfig.consolidationPromptCompactionConfig.summaryPrompt把每日流水账合并去重到MEMORY.md从对话窗口抽取长期事实到日流水账把对话前缀压成一条摘要(当下上下文)子智能体编排、委派、并行、异步通知把独立、上下文重、可并行的任务交给专家型子agentParentAgentagent_spa-wn:/agent_send后台任务远程子agent暴露给用户同步子agenttimeout=0timeout>0expose_to_user=trueurl+headers阻塞等结果·流式转发返回task_id·反向通知AgentProtocolHTTP用户可直连子agentsystem-reminder自动反向注入关键能力ISOLATED/SHAREDpersistSession复用实例递归3层硬上限DENY权限自动继承PlanMode自动只读流式事件带source路径workspaceE2BSandbox:隔离执行与跨调用恢复Harness通过统一Filesystem/Workspace接口接入E2B,隔离文件与Shell,并支撑快照恢复。统一接口隔离执行,快照能力支撑跨调用恢复E2BRemoteSandboxE2BSandboxE2bFilesystemSpecHarnessAgentapiKey!·templateIdIsolatedFilesystemShellRuntimetimeout·cpu·memoryFilesystem/Workspace/ShellToolsIsolationScope/Workspace命令执行业务逻辑不感知执行后端/workspaceProjection静态资产HydrateCPU/Memory/Timeout远程托管·与宿主隔离·可弹性创建运行生命周期AcquireHydrateSnapshotExecuteResume→→→创建或领取Sandbox投影Workspace静态资产文件+Shell隔离执行保留Workspace状态跨进程/跨调用恢复分布式隔离恢复宿主文件与命令边界清晰Workspace与状态跨调用延续配合共享StateStore多副本运行沙箱管理:隔离、恢复与分布式把危险操作关进容器,把安装状态存进快照Skills:四层注册中心&沙箱内执行SKILL.md+references/+scripts/=可复用的能力包注册中心·四层优先级(低→高)沙箱内执行·三步透明化物化Stager`<userId>`/skills/01市场skill从内存写到宿主.skills-cache/用户级隔离目录·覆盖共用版SHA-256文件级去重启发式恢复-:chm">-:">-:">-:">';od+x-:;:(,,)">•-:">-:">-:">-:">';-:;:(,,)">•-:">-:">-:">-:">';-:;:(,,)">•workspace/skills/WorkspaceProjection工作区共用·项目特有约定02把skills/+.skills-cache/打成tarhydrate进沙箱/workspace内容SHA-256整体比对增量skillRepository(...)L2市场后端·Git/Nacos/MySQL/Classpath容器内执行03<files-root>用容器内绝对路径agent不用猜路径projectGlobalSkillsDir低快照保留pip/npminstall副作用项目全局目录·~/.agentscope/skills/计划模式:想清楚->写下来->再动手只读思考阶段+计划文件+HITL退出工作流(明确固化四步:设计→写计划→人确认→执行)执行阶段plan_writeplan_exit用户请求只读调查HTL确认plan_enter工具解禁PLAN.md复用权限系统的ASKPlan阶段的白名单四种终态(别只看isPlanModeActive)只读文件工具read_file·grep_files·glob_files·list_files未进入模型直接build,任务与workspace不匹配内存查询工具memory_search·memory_get·session_search进入→plan_exit成功:规划完+获批→build模式Plan三件套plan_enter·plan_write·plan_exit仍plan·有PLAN已起草但未退出;后续消息可批准继续任务清单todo_writeShell(可选).allowShellInPlanMode()后放开为只读用途仍plan·无PLAN只说不做:文本像计划但没写出Channel:消息平台->Gateway->Agent一行接线,自动完成会话管理·并发·路由·流式消息平台Gateway·路由与治理HarnessAgent实例池HTTP/SSEGatewayBootstrapsalesmainWebSocket会话管理userId→稳定sess��ionId映射钉钉supportPer-session并发HarnessAgent同session消息公平排队飞书Agent路由企业微信billing多agent场景按agentId分发HarnessAgentGitHub子agent桥expose_to_user反向暴露给客户端GitLabreviewer流式转发exposedsubagentFlux`<AgentEvent>`→SSE直通3AgentScopeService企业级智能体控制面GoalPipeline:执行—验证—反馈闭环Executor产出,Verifier对照Goal验收;失败原因反馈执行端,直到通过、不可达或耗尽尝试。把“完成任务”升级为“通过目标验收”FixedLogic·OneEventStreamPass目标通过,结束VerifierExecutorInput/Goal执行工作并输出report对照Goal检查真实产物首条消息同时是执行任务产物写入共享Workspace返回result+messageresult→也是Verifier的验收标准→Impossible目标不可达,结束MaxIters尝试耗尽,结束Fail:message原样反馈执行—验证闭环的三个关键契约StructuredVerdictResumeafterHITLSharedWorkspaceVerifier读取实际产物而不是只相信reportpass/fail/impossible失败原因可直接行动reply_id路由回暂停Agent恢复不重置尝试预算适用:代码实现、文档交付、数据分析等可定义验收标准、可重复验证的复杂任务RAGService:从检索组件到可运营知识服务多租户知识库解耦API与索引Worker,以异步任务、共享存储和自愈机制支撑生产部署。从库内组件到可运营的多租户知识服务API与索引独立扩缩租户隔离N×IndexWorkersTenantARAGServiceAPIKB-1·KB-2KnowledgeBaseCRUDChunkEmbedInsertAsyncTaskQueueParseDocumentUpload/TenantBDeleteKB-3·KB-4Lease·HeartbeatSearch/BatchStatusRetry·Re-dispatchRESTAPI+UI重解析依赖与计算资源可独立部署TenantN独立Namespace水平扩展共享数据面BlobStoreVectorStoreCollectionperKBLocal/S3/Custom所有Worker共享文件源维度适配与隔离异步进度·多租户隔离·独立扩缩·故障自愈·开箱即用API/UIAgentTeams:多Agent团队协作状态机Lead、成员、TaskBoard与Mailbox共同形成任务分解、消息协作和结果收敛闭环。一个团队=独立Session+共享协作状态跨进程/跨节点TeamLead定义目标·组建团队·收敛结果SharedTaskBoard任务分解·Claim/AssignPlanApproval·进度与依赖BuilderReviewerResearcher独立Session独立Session独立Session检索与证据实现与验证评审与把关Mailbox+MessageBus+Wakeup单播/广播·异步唤醒·状态跨进程保留团队生命周期Create→Invite/Spawn→Collaborate→Observe→Dissolve/RecoverAgentTeamsvsSubAgent:团队协作与层级委派SubAgent强调父子委派与结果回传;AgentTeams强调多成员共享任务、状态与消息。SubAgentAgentTeams父Agent主导的层级委派多成员共享状态的团队协作Parent→ChildLead/Member关系拓扑一对多委派团队拓扑与动态成员父任务与子任务上下文共享TaskBoard/Mailbox状态归属结果回传父Agent跨Session持久化本地或远程并发独立Session运行方式同步等待/后台任务消息驱动+Wakeup子Agent主要向父Agent汇报成员可单播、广播与认领任务协作方式适合fan-out/fan-in适合持续协作边界清晰的拆分任务多角色长期配合典型场景研究、评审、并行执行共享计划、跨节点团队选择原则需要“父子委派”选SubAgent;需要“团队状态机”选AgentTeams二者可以组合:TeamMember仍可为局部任务继续SpawnSubAgent任务级
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 市政桥梁支座更换施工方案
- 装配式公共建筑拼装施工方案
- 职业健康知识进校园实施方案
- 污水处理厂围墙及大门施工方案
- 住宅小区电梯安装施工方案
- 小学英语自然拼读教学路径分析
- 中小学生心理健康普查工作实施指南
- 烟花爆竹零售安全培训方案
- 污水处理池混凝土施工方案
- 2027年拍卖师《拍卖法律知识》预测试卷二
- 老年髋部骨折患者围手术期管理专家共识
- 2026年养老院入职培训内容大纲
- 智慧渔业课件
- 电缆防火封堵施工安全交底
- 2027年国家公务员面试全攻略:题型梳理、答题模板与备考指南
- 户用光伏运维培训
- 2026年食品质量与安全基础知识解析题库
- 心肺功能评定课件
- 财务差旅费报销培训课件
- 反向开票培训课件
- DB32-T 4396-2022 勘察设计企业质量管理标准
评论
0/150
提交评论