一、鸿蒙7 Agent双路线总览鸿蒙7 API26 构建两条完全独立、定位互补的智能体开发路线分别收敛于两大kit套件本地离线技能智能体端侧私有A2A依托kit.AbilityKit下AgentExtensionAbility应用内独立后台服务纯本地离线运行、自研技能、跨应用A2A通信、企业权限管控面向政企、门店、离线自助终端私有技能场景。通用大模型对话智能体系统生态互通依托kit.AgentFrameworkKitHMAF 2.0对接系统盘古端侧大模型、小艺生态、自然语言意图拆解、自动任务编排面向C端消费应用、全域语音交互、多步骤自动化任务场景。两条路线底层基于同一套HMAF智能体内核但开发范式、运行形态、安全模型、适用场景、接入成本完全割裂存量项目选型错误会导致架构返工、合规不达标、性能隐患。本文全方位对比两条路线给出标准化选型、开发、迁移落地方案。二、双路线核心维度全方位对比对比维度路线1AgentExtensionAbility本地私有离线Agent路线2AgentFrameworkKit系统通用对话Agent所属Kitkit.AbilityKit应用基础套件kit.AgentFrameworkKit独立AI智能体套件运行载体ExtensionAbility独立后台进程与UI进程隔离应用内UI线程嵌入Function组件无独立后台大模型依赖不依赖系统盘古纯业务代码逻辑无LLM强制依赖原生绑定端侧盘古大模型意图识别/任务编排由系统模型驱动网络要求完全离线可用断网无任何功能降级基础意图识别本地可用复杂长任务/联网工具需网络技能形态硬编码业务技能四则运算、文件解密、设备管控、表单处理自然语言意图工具Function调用支持多步骤自动编排跨应用A2A通信原生onAuth鉴权、白名单、分级技能拦截完整A2A通信链路仅支持系统小艺统一调度无原生跨应用第三方互通能力权限管控应用自主管控白名单、高风险技能拦截、握手Token校验系统统一权限弹窗应用无法自定义第三方调用白名单UI交互方式无内置对话UI页面自行封装交互面板内置FunctionComponent标准对话弹窗/嵌入组件零UI开发分布式MultiKit联动可后台持续同步分布式数据长驻后台页面销毁即会话销毁无法后台持续执行同步任务Kiosk商用锁机适配锁机模式独立后台保活7×24小时稳定运行依赖页面存活切后台会话中断不适合自助终端安全合规搭配SecurityKit HUKS硬件加密握手密钥TEE托管满足等保2.0系统统一安全策略应用无法自定义分级技能拦截开发侵入度新增独立ExtensionAbility少量配置文件页面无侵入页面直接嵌入Function组件无需新增后台服务上线分发纯本地应用能力无需平台审核随HAP包分发需上架小艺开放平台审核后纳入系统小艺生态调度内存开销独立进程常驻空闲可主动销毁释放内存页面销毁自动释放无后台常驻内存占用典型场景政务多应用协同、门店Kiosk自助终端、本地文件加密、企业私有工具、离线报表处理资讯语音问答、出行规划、办公文档摘要、生活服务自动化、全域语音交互三、两条智能体路线底层架构深度解读路线1AgentExtensionAbility 本地私有离线智能体端侧服务型Agent核心架构独立后台进程AgentExtensionAbility作为独立扩展能力与UIAbility进程隔离页面销毁后台仍可持续运行A2A双向通信通道wantAgent.connectAgent建立跨进程长连接onAuth唯一鉴权入口实现三层安全管控包名白名单、握手Token、技能风险分级纯业务代码技能无内置大模型技能完全由开发者硬编码实现逻辑可控、无模型幻觉离线闭环不依赖任何云端、系统大模型仅读取本地文件、系统硬件能力长驻后台能力适配Kiosk自助终端、分布式数据同步、定时日志导出等后台持续任务。核心生命周期onCreate智能体服务启动初始化缓存、共享内存、分布式同步会话onAuth(proxy, handshakeData)第三方应用连接鉴权核心入口onData(proxy, inputRaw)接收客户端指令分发技能、分级拦截高风险操作onDestroy销毁全部通信代理、释放共享内存、断开分布式连接。路线2AgentFrameworkKit 系统对话智能体交互型Agent核心架构页面嵌入式组件FunctionComponent直接嵌入ArkUI页面无独立后台进程页面销毁会话立即终止盘古端侧大模型驱动系统内置盘古6.0负责自然语言意图解析、多步骤任务自动编排、上下文记忆标准化工具注册应用注册业务Function工具大模型自动判断何时调用对应接口无需手动解析指令系统统一调度可被系统小艺全局唤起跨设备协同由软总线2.0统一调度开箱即用对话UI内置对话气泡、输入框、加载动画无需自行封装交互页面。核心开发流程页面引入FunctionComponent配置智能体标识注册业务工具函数查询商品、导出报表、设置亮度系统大模型自动解析用户自然语言调用对应工具并返回结构化结果支持流式输出、长上下文记忆、多步骤自动串联执行。四、代码直观对比两条路线最简Demo1AgentExtensionAbility 本地私有智能体服务端// ets/agentserver/AgentExtService.etsexportdefaultclassAgentExtServiceextendsAgentExtensionAbility{// 可信第三方应用白名单privateALLOW_LIST[com.enterprise.merchant];privateTOKENSECURE_A2A_2026;privateHIGH_RISK[pwd_decrypt,brightness_set];onCreate():void{}// A2A鉴权入口onAuth(proxy:common.AgentHostProxy,handshake:string):void{constpkgproxy.getCallerBundleName();if(!this.ALLOW_LIST.includes(pkg)||handshake!this.TOKEN){proxy.authorize(deny);return;}proxy.authorize(success);}// 接收第三方指令分级拦截高风险技能onData(proxy:common.AgentHostProxy,raw:string):void{constreqJSON.parse(raw);if(this.HIGH_RISK.includes(req.skillId)){proxy.sendData(JSON.stringify({code:403,msg:禁止第三方调用高风险技能}));return;}// 安全技能执行if(req.skillIdcalc){constreseval(req.params.expr);proxy.sendData(JSON.stringify({code:0,data:结果${res}}));}}}客户端跨应用调用consttargetWant:Want{bundleName:com.agent.server,abilityName:AgentExtService};constproxyawaitwantAgent.connectAgent(targetWant,{handshakeData:SECURE_A2A_2026});proxy.sendData(JSON.stringify({skillId:calc,params:{expr:12*30}}));2AgentFrameworkKit 通用对话智能体页面嵌入式import{ComponentV2,Local}fromkit.ArkUI;import{FunctionComponent,AgentController}fromkit.AgentFrameworkKit;EntryComponentV2struct ChatAgentPage{Localcontroller:AgentControllernewAgentController();// 注册业务工具大模型自动调用registerTools(){this.controller.registerTool({name:calc,desc:四则运算计算,run:async(params)eval(params.expr)});}build(){Column(){Text(系统大模型对话智能体);// 内置标准对话UI零开发FunctionComponent({agentId:news_agent_001,controller:this.controller}).width(100%).height(480);}.padding(16);}}五、四大业务场景选型标准核心落地指南场景1政企多应用协同、第三方技能互通政务/门店首选AgentExtensionAbility核心理由完整A2A鉴权体系包名白名单、握手Token、高风险技能分级拦截满足等保2.0最小权限独立后台进程Kiosk锁机7×24小时保活断电重启自动恢复通信会话纯离线运行政务地下大厅、无网络门店不依赖云端可联动DistributedMultiKit后台持续同步跨设备业务数据。场景2C端资讯、生活服务、语音自然交互App首选AgentFrameworkKit核心理由盘古大模型原生集成自然语言、多步骤任务自动编排大幅降低意图解析开发成本内置Function对话UI无需自行封装聊天面板接入小艺生态支持全局语音唤起智能体提升用户触达页面销毁自动释放资源无后台常驻内存消耗适合手机消费应用。场景3本地文件处理、国密加密、硬件管控私有工具首选AgentExtensionAbility核心理由数据全程本地闭环可搭配SecurityKit HUKS硬件加密敏感文件不上传第三方应用仅能调用低风险查询技能解密、硬件修改等高风险操作拦截独立进程读写文件不阻塞UI主线程百MB日志流式导出稳定。场景4办公文档摘要、出行规划、多步骤自动化任务首选AgentFrameworkKit核心理由大模型自动拆解复杂任务一句话完成多步骤串联查天气→生成行程→创建日程长上下文记忆支持多轮对话连续追问端云协同本地处理隐私文本复杂联网任务自动分流云端。六、两条路线核心优劣势总结AgentExtensionAbility本地私有Agent✅ 优势100%离线可用无网络依赖完整A2A跨应用通信多层安全鉴权政企合规独立后台进程支持Kiosk锁机长驻、后台同步无大模型幻觉风险技能逻辑完全由开发者控制无需上架开放平台随HAP包直接分发。❌ 劣势无内置NLP大模型自然语言交互需自行开发意图解析需额外配置agent_config.json、扩展Ability新增工程配置无标准对话UI交互面板需要自行封装ArkUI页面。AgentFrameworkKit系统对话Agent✅ 优势盘古端侧大模型原生内置自然语言、任务编排零开发FunctionComponent内置对话界面无需自研UI页面嵌入式无独立后台内存占用更低可被系统小艺全局唤起全域语音交互端云协同自动分流复杂推理任务。❌ 劣势无原生A2A第三方互通能力无法管控外部应用调用权限依赖页面存活切后台会话中断不适合7×24小时自助终端复杂技能需上架小艺平台审核分发流程更长高敏感数据会送入系统大模型隐私合规成本更高。七、高频开发踩坑与解决方案坑1政企项目选用AgentFrameworkKit第三方应用可随意调用隐私能力根因FrameworkKit无A2A白名单鉴权机制修复私有技能、多应用协同场景强制使用AgentExtensionAbility依靠onAuth做多层权限拦截。坑2Kiosk自助终端使用FrameworkKit切后台智能体失效根因页面销毁Function会话同步销毁无独立后台修复自助终端、后台持续同步场景统一选用AgentExtensionAbility独立进程。坑3离线无网络环境FrameworkKit无法解析指令根因复杂意图依赖云端模型能力修复纯离线业务切换至AgentExtensionAbility纯硬编码技能。坑4ExtensionAbility跨应用连接被拒绝鉴权失败AgentExtensionAbility未配置exported:true握手Token、应用包名大小写不匹配两端未声明ohos.permission.INTERACT_WITH_AGENT权限修复核对module.json5扩展能力导出开关、权限、白名单字符串。坑5FrameworkKit无法自定义第三方调用权限系统统一弹窗授权无法区分低/高风险技能合规场景改用ExtensionAbility在onData内拦截高风险指令。坑6模拟器无法复现A2A跨应用通信、后台保活模拟器裁剪Agent进程路由独立后台、跨应用通信必须真机测试。八、生产级选型规范团队标准化编码规则离线/政企/多应用协同 → AgentExtensionAbility判定标准存在第三方应用调用、数据隐私等级S3/S4、需要7×24小时后台运行、无网络使用场景C端语音对话、自动化任务、自然语言交互 → AgentFrameworkKit判定标准面向普通用户、依赖大模型意图理解、不需要跨第三方应用互通、页面内短时交互混合场景最佳实践页面对话使用FrameworkKit提升交互体验底层私有文件/加密技能由ExtensionAbility提供A2A通信统一走ExtensionAbility鉴权通道安全强制规范涉及管理员密码、病历、政务涉密文件等高敏数据禁止使用FrameworkKit送入大模型统一本地ExtensionAbilityHUKS加密闭环资源生命周期规范ExtensionAbility在Ability onDestroy统一销毁全部通信代理、共享内存FrameworkKit页面销毁自动释放控制器无需手动销毁。九、方案总结鸿蒙7双路线智能体架构形成本地私有离线服务与系统大模型对话交互互补的完整AI开发体系AgentExtensionAbility依托kit.AbilityKit主打离线、跨应用A2A通信、政企权限管控、后台长驻是政务、门店Kiosk、企业多应用协同的私有技能标准化方案kit.AgentFrameworkKit主打盘古端侧大模型、自然语言意图、零代码对话UI、系统全域语音唤起面向C端消费应用轻量化交互开发。两条路线不存在替代关系而是按业务场景分层选型混合场景可二者搭配使用同时可与DistributedMultiKit、SecurityKit、SharedMemoryKit、EasyGo平行视界、GridRow栅格无缝联动覆盖鸿蒙全场景AI智能体开发需求。