【ArkUI进阶练中学】第18课：Agent亲和架构与应用智能化改造

本节目标

• 理解HarmonyOS 7从"App亲和"到"Agent亲和"的底层架构跃迁，掌握系统智能体小艺作为终端AI入口的运作机制
• 掌握HMAF 2.0（鸿蒙智能体框架）的核心能力：90%+复杂任务成功率、20+AI能力开放、GUI操控权限释放
• 掌握ArkAF（方舟智能开发框架）的三种能力开放机制------意图框架、Skill框架、端侧A2A框架的选型边界与开发方法
• 掌握意图框架的两种定义方式（标准意图与自定义意图），能够通过配置文件或装饰器完成意图注册
• 掌握Skill框架的开发流程，能够通过SKILL.md声明契约与ArkTS入口脚本将应用能力封装为可被系统调度的Skill
• 理解端侧A2A框架的适用场景，能够评估应用是否需要构建端侧智能体
• 掌握应用Agent化改造的四阶段演进路线，能够为存量应用制定智能化升级方案

一、从App亲和到Agent亲和------操作系统的底层跃迁

1.1 Agent亲和架构的三大核心

HarmonyOS 7的核心变化不在于版本号，而在于底层逻辑从"App亲和"全面转向"Agent亲和"。这一转变由三大核心支撑：系统智能体小艺 作为终端AI入口，具备意图理解、服务编排、跨任务流转能力，端侧模型负责本地感知与隐私保护，云侧模型处理复杂推理，端云协同实现"说一句，办一整套"。HMAF 2.0智能体框架 实现90%以上复杂任务成功率，开放20+AI能力，首次释放GUI操控权限，开发者接入门槛大幅降低，应用可以Skill化，被系统智能体按需调度。Agent亲和系统架构则从系统层面为智能体协同提供原生支持。

1.2 小艺作为系统智慧大脑

小艺已不再是简单的语音助手，而是深度融入鸿蒙系统的智慧大脑。在用户授权下，小艺可调用200多项系统级数据，涵盖日程、运动健康、兴趣爱好等；系统应用实现全面Skill化，2100多项鸿蒙系统能力、超500个伙伴精选Skills、2000多个鸿蒙智能体接入。日均唤醒超30亿次，日均Agent分发量过去一年提升4.5倍。

1.3 应用分发逻辑的重构

在App亲和时代，应用争夺的是"信息入口"------决定用户看到什么。在Agent亲和时代，应用争夺的是"行动入口"------决定替用户做什么。HarmonyOS 7通过意图框架将应用功能智能分发到小艺对话、小艺搜索、小艺建议等系统入口，应用不再只能等待用户打开图标，而是可以把经过授权、边界清晰的业务能力交给系统智能入口调度。

二、ArkAF三大能力开放机制

2.1 ArkAF概述

ArkAF（Ark Agentic Framework，方舟智能开发框架）是面向智能体时代的应用能力开发框架，提供意图框架、Skill框架和端侧A2A框架三种能力开放机制，帮助开发者将应用能力外化给系统智能体调用，实现应用与智能体的无缝协同。

ArkAF的工作流程分为四个阶段：开发接入 （开发者选择合适框架将能力标准化封装）、系统注册 （能力注册到ArkAF供系统智能体发现和索引）、智能匹配 （用户通过自然语言发出请求，系统智能体解析意图并匹配最佳应用能力）、能力执行（系统智能体调用应用能力执行任务并返回结果）。

2.2 三种框架的选型边界

意图框架提供标准化意图接入能力和意图调度管理能力，适用于单一明确的能力调用（如播放音乐、导航到某地），由系统智能体唤醒执行。

Skill框架提供标准化Skill接入的能力和管理能力，适用于复杂场景功能（如"导航回家"这类需要多步骤协同的任务），开发者上架Skill后可被系统智能体识别并调用。

端侧A2A框架提供标准化智能体接入能力和智能体调度管理能力，适用于应用端侧智能体的开发（如跟踪股票信息的智能体），应用智能体与系统智能体双向通信协商完成复杂任务。

2.3 开发辅助工具

ArkAF引入了AI编码辅助，将自身丰富的意图开发经验封装为多个意图Skill，帮助开发者实现一句话自动生成意图。开发者可以在DevEco Studio中通过View > Tool Windows > Application Agent打开内嵌的小艺智能平台，新建智能体和添加插件。

三、意图框架开发

3.1 意图定义方式

开发者可以通过两种方式定义意图。接入标准意图 ：当应用功能符合系统预定义的标准意图时（如播放音乐、导航），可直接接入标准意图，避免重复定义规范。系统根据装饰器的schema字段与intentVersion字段在标准意图列表中查询是否存在匹配。创建自定义意图：当标准意图无法覆盖应用功能时，开发者可自定义意图。自定义意图需要包含大语言模型描述（自然语言描述意图功能，供系统入口解析语义）、参数类型定义（符合Json Schema规范）和结果类型定义。

3.2 配置文件开发意图

从API version 11开始，支持通过配置文件开发意图。主要包含两个环节：通过insight_intent.json配置文件定义意图，声明意图执行器的代码路径、绑定的Ability组件等意图信息；实现InsightIntentExecutor继承类并实现对应的意图执行逻辑。

{
  "insightIntents": [
    {
      "domain": "MusicDomain",
      "intentName": "PlayMusic",
      "intentVersion": "1.0.1",
      "srcEntry": "./ets/insightintentexecutor/PlayMusicExecutor.ets",
      "uiAbility": {
        "ability": "EntryAbility",
        "executeMode": ["background", "foreground"]
      }
    }
  ]
}

3.3 装饰器快速接入

从DevEco Studio 6.0.0 Beta2开始，CodeGenie新增通过装饰器开发意图的功能，支持生成五类意图装饰器：@InsightIntentLink（应用链接跳转）、@InsightIntentPage（基于Navigation的子页面）、@InsightIntentFunction（函数调用）、@InsightIntentForm（卡片扩展）、@InsightIntentEntry（直接继承InsightIntentEntryExecutor）。

开发者框选想要接入意图框架功能的代码，右键选择CodeGenie > Insight Intent，即可选择适合的装饰器进行快速生成。

四、Skill框架开发

4.1 Skill的本质

Skill是将特定领域的知识、流程和最佳实践以结构化和标准化的方式组织起来的能力单元，使AI Agent能够按需、稳定地执行专业任务。通过Skill，开发者得以在不改造既有业务实现的前提下，以薄封装将应用能力开放给系统智能体；系统智能体无需理解各应用的内部实现，仅依赖统一的声明契约即可完成调度。

4.2 Skill的组成结构

每个Skill由两个核心部分组成：一份描述文件 （SKILL.md或等效的声明文件，声明触发场景、入参约束与返回值契约）和一份ArkTS入口脚本（将外部调用桥接到应用内既有业务实现），并通过模块配置绑定到指定Ability的运行上下文。

4.3 Skill开发流程

Step 1：注册与配置 。在小艺开放平台完成开发者账号注册和Skill创建，填写SKILL.md文件描述Skill的名称、触发意图、参数、执行逻辑。Step 2：实现ArkTS入口脚本 。编写一个薄适配层，把AI传进来的参数转交给App内部已有的业务代码。Step 3：调试与上架。在小艺开放平台完成调试，确认无误后提交上架申请。平台会进行审核（包括隐私风险检查、必要配置完成情况），审核通过后Skill将出现在小艺Skill市场中供用户搜索和使用。

五、端侧A2A框架

5.1 适用场景

端侧A2A框架适用于已具备鸿蒙端应用能力、希望将应用智能体部署于本地设备以充分利用端侧算力与系统级API的开发者。通过端A2A协议实现端到端的轻量化对接，获得低延迟、高隐私的智能交互体验。

5.2 平台配置

使用端侧A2A模式需要在小艺开放平台完成开发态配置：新建"端A2A模式"的Agent，关联对应的应用/元服务，按平台提示填写应用、模块及服务信息。

5.3 协同模式

小艺Client Agent负责理解用户意图与服务分发，应用端侧Agent负责专业服务执行，通过A2A协议实现智能体间通信与协作。例如支付宝阿宝与小艺的协同实践：小艺理解用户意图与服务分发，阿宝负责专业服务执行，通过支付宝智能体跨端互联AHA协议体系实现A2A协同，缩短跨应用操作路径。

六、AgentCard与动态脚本引擎

6.1 AgentCard的核心设计

HarmonyOS 7.0在Ability Kit中引入了与智能体深度绑定的AgentCard，区别于传统的桌面卡片，它更像是一个"轻量级的微服务UI端点"，拥有独立的解析和状态持久化机制。系统提供了对卡片节点状态树的序列化存储接口，当卡片被销毁或宿主退出时，AgentCard可以自我保存操作上下文，下次被唤醒时能够瞬间恢复之前的操作状态（例如输入框里的半截文字，或翻到的第二页商品列表）。

6.2 动态脚本引擎

系统新增了专用于脚本管理的模块（如ScriptManager API），应用可以不再将所有功能绑定在预编译的UIAbility或ExtensionAbility中，而是通过脚本的形式注册Skill。系统层支持获取指定包名和分身索引的应用名称，从而将意图精准路由到对应的独立沙箱环境中执行脚本。这套机制允许将核心功能解耦为可动态加载的脚本，并通过AgentCard直接在多宿主环境中完成渲染和交互。

6.3 工程目录结构

entry/src/main/
├── ets/
│   ├── entryability/
│   │   └── EntryAbility.ets
│   ├── agentcards/              // AgentCard核心目录
│   │   ├── OrderAgentCard.ets
│   │   └── CardStateConfig.ts
│   ├── scripts/                 // ArkTS动态脚本池
│   │   └── queryOrderSkill.ts
│   └── pages/
└── resources/

当系统向后台脚本引擎发送"查询最近订单"的Skill意图时，系统不会拉起全屏UIAbility，而是通过底层脚本执行流直接在AgentCard上渲染出高保真的订单数据，并支持双向数据持久化。

七、应用Agent化改造路线

7.1 四阶段演进路径

第一阶段：能力原子化。将应用核心功能封装为意图或Skill，从最高频、最明确的功能开始（如"播放音乐""查询订单状态"）。优先做增量，不推翻存量：现有App主体保留，挑选高频、独立的业务封装成可被Agent调用的原子能力。

第二阶段：Skill化封装。将复杂场景功能封装为Skill，编写SKILL.md声明文件和ArkTS入口脚本，在小艺开放平台完成注册与上架。

第三阶段：端侧Agent构建。将应用智能体能力注册到端侧A2A框架，与系统智能体建立双向通信，支持复杂任务的协同完成。做好边界防护，确保所有Agent工具入口经过权限校验和安全审核。

第四阶段：动态UI适配。采用AgentCard + 动态脚本引擎架构，将功能解耦为可动态加载的脚本，实现多宿主环境下的卡片级渲染和状态持久化。

7.2 改造原则

优先增量，不推翻存量 ：现有App主体保留，挑选高频、独立的业务封装为可被Agent调用的原子能力。薄封装优先 ：Skill作为薄适配层，将外部调用桥接到应用内既有业务实现，避免大规模重构。安全边界清晰：所有Agent工具入口需要做好权限校验和安全审核，确保用户数据安全。

八、多元化习题

习题1（判断题）

题目：在HarmonyOS 7的Agent亲和架构中，应用只能被动等待用户打开图标后才能提供服务。

答案：错误

解读：HarmonyOS 7的Agent亲和架构使应用不再只能等待用户打开图标，而是可以把经过授权、边界清晰的业务能力交给系统智能入口调度。通过ArkAF框架，应用能力可被系统智能体智能调度，在合适场景为用户提供便捷的智能化服务体验。

习题2（单选题）

题目：以下哪种ArkAF能力开放机制适用于"导航回家"这类需要多步骤协同的复杂场景功能？

A. 意图框架

B. Skill框架

C. 端侧A2A框架

D. MindSpore Lite Kit

答案：B

解读：Skill框架提供标准化Skill接入的能力和管理能力，应用开发者通过上架Skill可被系统智能体识别并调用，适合复杂场景功能。意图框架适用于单一明确的能力调用（如播放音乐、导航），端侧A2A框架适用于应用端侧智能体的开发。

习题3（多选题）

题目：关于AgentCard的核心特性，以下说法正确的有（多选）：

A. AgentCard是轻量级的微服务UI端点，拥有独立的解析和状态持久化机制

B. 系统提供了对卡片节点状态树的序列化存储接口

C. AgentCard被销毁后无法恢复操作上下文

D. AgentCard可以通过动态脚本引擎在多宿主环境中完成渲染和交互

答案：A、B、D

解读：AgentCard是轻量级的微服务UI端点，拥有独立的解析和状态持久化机制，选项A正确。系统提供了对卡片节点状态树的序列化存储接口，选项B正确。AgentCard被销毁或宿主退出时可以自我保存操作上下文，下次被唤醒时能够瞬间恢复之前的操作状态，选项C错误。动态脚本引擎允许将核心功能解耦为可动态加载的脚本，并通过AgentCard直接在多宿主环境中完成渲染和交互，选项D正确。

习题4（代码填空题）

题目：请补全以下意图配置文件，声明一个名为"ViewRepayment"的还款待办意图。

{
  "insightIntents": [
    {
      "______________": "ViewRepayment",
      "domain": "BankingDomain",
      "intentVersion": "1.0.1",
      "srcEntry": "./ets/entryability/InsightIntentExecutorImpl.ets",
      "uiAbility": {
        "ability": "EntryAbility",
        "executeMode": ["background", "foreground"]
      }
    }
  ]
}

答案 ：intentName

解读 ：intentName字段声明意图名称，应当遵循意图框架规范，当前仅支持预置垂域意图，不允许自定义。应用内意图名称唯一，不允许出现相同的名称定义。

习题5（代码改错题）

题目：以下关于Skill开发的描述存在错误，请指出问题并修正。

Skill开发需要将应用的全部业务逻辑都重写到Skill中，并且修改原有App的代码架构以适配Skill的调用方式。

答案：错误有两处。第一，Skill不需要将应用的全部业务逻辑重写，而是作为"薄适配层"将外部调用桥接到应用内既有业务实现。第二，Skill开发不需要修改原有App的代码架构，通过统一的声明契约即可完成调度，系统智能体无需理解各应用的内部实现。

解读：Skill的核心设计理念是"薄封装"。开发者将应用内可被外部调用的业务能力组织为若干能力单元，每个单元由一份描述文件和一份ArkTS入口脚本组成，通过模块配置绑定到指定Ability的运行上下文。这种设计使开发者能够在不改造既有业务实现的前提下，以极低的成本将应用能力开放给系统智能体。

习题6（简答题）

题目：简述ArkAF三种能力开放机制的选型边界，以及各自的适用场景。

答案：ArkAF提供三种能力开放机制。意图框架提供标准化意图接入能力和意图调度管理能力，适用于单一明确的能力调用，如播放音乐、导航到某地，由系统智能体唤醒执行。Skill框架提供标准化Skill接入的能力和管理能力，适用于复杂场景功能，如"导航回家"这类需要多步骤协同的任务，开发者上架Skill后可被系统智能体识别并调用。端侧A2A框架提供标准化智能体接入能力和智能体调度管理能力，适用于应用端侧智能体的开发，如跟踪股票信息的智能体，应用智能体与系统智能体双向通信协商完成复杂任务。

习题7（简答题）

题目：简述应用Agent化改造的四阶段演进路线，以及各阶段的核心任务。

答案：应用Agent化改造分为四个阶段。第一阶段，能力原子化：将应用核心功能封装为意图或Skill，从最高频、最明确的功能开始，现有App主体保留，挑选高频、独立的业务封装为可被Agent调用的原子能力。第二阶段，Skill化封装：将复杂场景功能封装为Skill，编写SKILL.md声明文件和ArkTS入口脚本，在小艺开放平台完成注册与上架。第三阶段，端侧Agent构建：将应用智能体能力注册到端侧A2A框架，与系统智能体建立双向通信，支持复杂任务的协同完成。第四阶段，动态UI适配：采用AgentCard + 动态脚本引擎架构，将功能解耦为可动态加载的脚本，实现多宿主环境下的卡片级渲染和状态持久化。

九、本节知识点总结

Agent亲和架构

HarmonyOS 7从"App亲和"全面转向"Agent亲和"。系统智能体小艺作为终端AI入口，具备意图理解、服务编排、跨任务流转能力。HMAF 2.0实现90%+复杂任务成功率，开放20+AI能力，首次释放GUI操控权限。

ArkAF三大框架

意图框架适用于单一明确的能力调用，Skill框架适用于复杂场景功能，端侧A2A框架适用于应用端侧智能体的开发。ArkAF工作流程分为开发接入、系统注册、智能匹配、能力执行四个阶段。

意图框架

支持标准意图和自定义意图两种定义方式。通过insight_intent.json配置文件定义意图，实现InsightIntentExecutor执行逻辑。支持通过装饰器（@InsightIntentLink、@InsightIntentPage等）快速接入。

Skill框架

Skill由声明文件和ArkTS入口脚本组成，通过统一的声明契约即可完成调度。开发流程包括注册配置、实现入口脚本、调试上架三个步骤。

AgentCard与动态脚本引擎

AgentCard是具备状态持久化能力的轻量级微服务UI端点。动态脚本引擎将功能解耦为可动态加载的脚本，通过AgentCard在多宿主环境中渲染和交互，避免包体积膨胀和频繁发版。

应用改造路线

四阶段演进：能力原子化 → Skill化封装 → 端侧Agent构建 → 动态UI适配。核心原则：优先增量不推翻存量，薄封装优先，安全边界清晰。