HarmonyOS-6.0-AI全栈能力解析-Data-Augmentation-Kit到智能体开发实战

HarmonyOS 6.0 AI全栈能力解析：从Data Augmentation Kit到智能体开发实战（附源码）

摘要：HarmonyOS 6.0正式将AI能力从"工具调用"推升到"操作系统级智能体框架"。本文从API 12到API 21的演进脉络出发，全景拆解HMAF（鸿蒙智能体框架）三层架构、小艺开放平台四种编排模式、Agent Framework Kit的FunctionComponent集成方案，以及云插件/端插件/MCP插件三大插件开发体系。附带完整可运行的ArkTS源码与3个真实踩坑记录，帮你快速从"看懂"到"用上"。

---

一、为什么说HarmonyOS 6.0是AI操作系统的分水岭？

2025年10月22日，HDC 2025上华为正式发布了HMAF------这不是又一个AI SDK，而是操作系统级的智能体框架。 在此之前，开发者想在鸿蒙应用里集成AI能力，需要自己对接LLM API、自己写聊天气泡UI、自己管理对话上下文、自己处理流式输出断线重连------一套流程下来代码量动辄上千行。

HMAF彻底改变了这个范式：应用只需要40行声明式代码，就能接入系统级智能体。 对话框UI、流式渲染、上下文管理、网络通信------全部由操作系统底层接管。

但HMAF只是HarmonyOS 6.0 AI全栈能力的一部分。从API 12到API 21，鸿蒙的AI能力经历了三个阶段：

阶段	API版本	核心能力	开发模式
基础能力	API 12-14	文本/图像Embedding、ASR/TTS、NLU、Intents Kit	单步工具调用
能力增强	API 15-17	多模态、Data Augmentation Kit（端侧RAG）	管道式串联
智能体时代	API 18-21	HMAF、Agent Framework Kit、小艺开放平台	智能体自主编排

本文的目标：带你从上到下走一遍HarmonyOS 6.0的AI全栈能力，让你清楚每一层能做什么、怎么用、有什么坑。

---

二、HMAF三层架构：系统级智能体框架的底层设计

2.1 架构全景

HMAF的架构分为三层，每一层解决一个核心问题：

┌──────────────────────────────────────────────────────┐
│              应用层 (App Layer)                         │
│    开发者通过 Agent Framework Kit 接入智能体              │
│    FunctionComponent / AgentController                 │
├──────────────────────────────────────────────────────┤
│            框架层 (HMAF Framework)                      │
│  ┌──────────┐ ┌──────────┐ ┌────────────────────┐   │
│  │ 意图识别  │ │ 工具调度  │ │ 多智能体协同引擎    │   │
│  │ Intent   │ │ Tool     │ │ Multi-Agent        │   │
│  │ Resolve  │ │ Dispatch │ │ Orchestration      │   │
│  └──────────┘ └──────────┘ └────────────────────┘   │
│  ┌──────────┐ ┌──────────┐ ┌────────────────────┐   │
│  │ 对话管理  │ │ 知识检索  │ │ 分布式软总线        │   │
│  │ Context  │ │ RAG      │ │ Distributed Bus    │   │
│  │ Manager  │ │ Engine   │ │                    │   │
│  └──────────┘ └──────────┘ └────────────────────┘   │
├──────────────────────────────────────────────────────┤
│              能力层 (Capability Layer)                  │
│  ┌────────┐ ┌────────┐ ┌────────┐ ┌────────────┐   │
│  │端侧LLM │ │语音识别 │ │视觉理解 │ │ Intents Kit│   │
│  │On-device│ │ASR/TTS │ │CV/OCR  │ │ 意图框架   │   │
│  └────────┘ └────────┘ └────────┘ └────────────┘   │
└──────────────────────────────────────────────────────┘

关键理解 ：HMAF不是跑在应用进程里的SDK，而是嵌入在操作系统内核层的框架。这意味着：

1. 天然打通小艺系统意图框架------你创建的智能体可以直接调用系统级能力（打电话、发短信、设置闹钟等）
2. 硬件级渲染加速------流式打字机效果、气泡动效基于OS底层硬件加速，不占用应用CPU
3. 后台挂起不吃内存------对话框关闭后，系统自动回收资源

2.2 从"工具调用"到"智能体编排"的范式跃迁

API 12-14 时代（预定义、单向）：
  用户 → 语音输入 → Intents Kit意图识别 → 调用App特定功能 → 返回结果

API 18-21 时代（自主规划、多步协同）：
  用户 → 自然语言 → HMAF意图理解 → 多Agent协同调度 → 工具链式调用 → 自主决策

这个变化对开发者意味着什么？你不再需要预定义用户可能的每条指令。用户说"帮我查一下明天北京的天气，顺便定一张去北京的机票"，HMAF会自动拆解为两个子任务，分别调度天气Agent和出行Agent完成。

---

三、AI Kit子集演进：11个Kit覆盖完整AI链路

HarmonyOS 6.0的AI能力不是单一的"AI Kit"，而是由11个Kit组成的矩阵：

Kit	起始API	核心能力	典型应用场景
Agent Framework Kit	API 20	智能体框架服务，拉起指定Agent	应用内AI助手入口
Intents Kit	API 12	系统级意图理解与调度	语音指令、系统功能调用
Data Augmentation Kit	API 15	端侧RAG（知识库+检索+本地推理）	企业私域知识问答
Core Speech Kit	API 12	基础ASR/TTS	语音转文字、文字转语音
Core Vision Kit	API 12	基础图像识别	OCR、物体识别
Natural Language Kit	API 12	NLU能力	分词、实体识别、情感分析
Speech Kit	API 12	场景化语音交互	语音助手、实时翻译
Vision Kit	API 12	场景化视觉处理	人脸识别、文档增强
CANN Kit	API 12	AI推理加速	端侧模型加速推理
MindSpore Lite Kit	API 12	昇思推理框架	自定义模型端侧部署
Neural Network Runtime Kit	API 12	神经网络运行时	模型执行底层引擎

演进路线图：

API 12 (NEXT 5.0) --- AI Kit 基础框架
│   ├── 端侧文本推理、基础NLU、Intents Kit
│   └── Core Speech/Vision Kit
│
API 15 (NEXT 5.x) --- 能力增强
│   ├── 多模态支持、Data Augmentation Kit（端侧RAG）
│   └── ArkTS AI API标准化
│
API 18-20 (6.0.0) --- HMAF正式发布
│   ├── Agent Framework Kit、小艺智能体开放平台
│   ├── Intents Kit完整版（多智能体调度）
│   └── 分布式AI协同、全模态交互
│
API 21 (6.0.1) --- 元服务AI能力
│   ├── Agent Framework Kit支持元服务
│   └── FunctionComponent新增ICON_ABOVE_TITLE按钮类型
│
API 23 (6.0 Beta) --- 生态扩展
    └── 开发者Beta全面开放（2026年2月）

---

四、小艺智能体开放平台：四种编排模式选择指南

4.1 平台概述

小艺智能体开放平台是华为为开发者提供的一站式智能体创建、配置、调试、上架平台。核心卖点：

• 50+鸿蒙系统插件：官方预置，开发者直接调用（天气、日历、邮件、文件管理等）
• 兼容MCP工具：通过意图框架升级兼容Model Context Protocol
• 全场景多智能体协同：跨设备、跨应用Agent通信
• 4种编排模式：覆盖从简单到复杂的全部场景

4.2 四种编排模式详解

模式一：LLM模式（单Agent）

适合场景：知识问答、内容生成、简单对话

核心机制：以大语言模型为理解中枢，结合意图识别、工具调用、对话上下文，动态选择插件和工作流。

完整能力矩阵：

• 模型选择 & 参数调优
• 角色指令（Prompt工程）
• 插件绑定（调用50+系统插件）
• 工作流配置
• 知识库（Data Augmentation Kit端侧RAG）
• 长期记忆（多轮对话上下文）
• 触发器（定时、条件触发）
• 关联应用（绑定鸿蒙应用包名）

模式二：工作流模式

适合场景：需要多步骤协同、逻辑确定、业务流程复杂的场景

核心机制：可视化画布编排，将复杂任务拆解为有序的规则化步骤，串联插件、大模型、条件分支、代码块等组件。

与LLM模式的本质区别：

• LLM模式：Agent自主决策调用什么工具
• 工作流模式：开发者预定义执行流程，Agent按规则执行

示例场景：订单处理流程------接收订单 → 查询库存 → 扣减库存 → 生成物流单 → 通知用户。每一步都需要精确控制，适合工作流模式。

模式三：A2A模式（Agent-to-Agent）

适合场景：企业已有成熟智能体，需要接入小艺生态

核心机制：通过鸿蒙Agent通信协议，将第三方智能体对接至小艺开放平台。

前置条件：

• 必须同时具备鸿蒙端应用和云侧智能体
• 面向企业开发者

模式四：OpenClaw模式（2026年3月新增）

适合场景：个性化助手、自动化服务、快速接入第三方工具链

核心机制 ：接入OpenClaw工具，快速创建个性化智能体。注意：这是四种模式中能力最轻量的，不支持插件绑定、工作流、触发器等高级功能。

4.3 编排模式选型决策树

你的需求是什么？
├── 简单问答/内容生成 → LLM模式
├── 多步骤确定流程 → 工作流模式
├── 已有云侧智能体要接入 → A2A模式
└── 快速个性化工具 → OpenClaw模式

需要插件绑定吗？
├── 需要 → LLM模式 或 A2A模式
└── 不需要 → 任意模式

需要长期记忆吗？
├── 需要 → LLM模式 或 工作流模式
└── 不需要 → 任意模式

4.4 四种模式能力差异对照

能力维度	LLM模式	工作流模式	A2A模式	OpenClaw模式
模型选择	YES	-	-	-
知识库(RAG)	YES	-	-	-
长期记忆	YES	YES	-	-
插件绑定	YES	-	YES	-
工作流	YES	YES	-	-
触发器	YES	YES	YES	-
关联应用	YES	YES	YES	-
付费智能体	-	YES	YES	-
账号绑定	-	YES	YES	-
用户问题建议	YES	YES	-	-

---

五、Agent Framework Kit：40行代码接入系统级智能体

5.1 核心概念

Agent Framework Kit是应用与智能体之间的桥梁。当你在小艺开放平台创建并上架了智能体后，通过Agent Framework Kit提供的标准化UI控件，用户可以在应用内直接拉起该智能体进行对话。

核心优势：你不需要写对话框UI、不需要管理流式渲染、不需要处理网络通信------系统全部接管。

5.2 开发约束（踩坑必看）

约束项	说明
不支持模拟器	必须使用真机调试
仅限中国境内	港、澳、台地区不支持
系统版本	HarmonyOS 6.0.0(API 20) 及以上
元服务支持	API 21(6.0.1) 开始支持
华为账号	设备必须已登录华为账号
网络要求	智能体配置在云端，必须联网

5.3 基础集成示例

// 导入智能体框架核心组件
import { FunctionComponent, FunctionController } from '@kit.AgentFrameworkKit';
import { BusinessError } from "@kit.BasicServicesKit";
import { hilog } from "@kit.PerformanceAnalysisKit";
import { common } from '@kit.AbilityKit';

@Entry
@Component
export struct AgentServicePage {
  private controller: FunctionController = new FunctionController();
  // 从小艺开放平台获取的真实Agent ID
  private agentId: string = 'agentproxy65481da1fa2293a8482d45';
  @State isAgentSupport: boolean = false;

  // 检查当前环境是否支持该智能体
  async checkAgentSupport() {
    try {
      let context = this.getUIContext()?.getHostContext() as common.UIAbilityContext;
      this.isAgentSupport = await this.controller.isAgentSupport(context, this.agentId);
    } catch (err) {
      let errorCode = err.code;
      let errorMsg = err.message;
      hilog.error(0x0001, 'AgentDevLog', `检查失败 错误码:${errorCode} 消息:${errorMsg}`);
    }
  }

  aboutToAppear() {
    this.initListeners();
    this.checkAgentSupport();
  }

  // 监听对话框生命周期
  initListeners() {
    // 对话框打开时（例如：暂停背景音乐）
    this.controller?.on('agentDialogOpened', () => {
      hilog.info(0x0001, 'AgentDevLog', '智能体对话框已打开');
    });
    // 对话框关闭时（例如：恢复背景音乐）
    this.controller?.on('agentDialogClosed', () => {
      hilog.info(0x0001, 'AgentDevLog', '智能体对话框已关闭');
    });
  }

  aboutToDisappear() {
    this.controller?.off('agentDialogOpened');
    this.controller?.off('agentDialogClosed');
  }

  build() {
    Column({ space: 20 }) {
      // 形态一：圆形图标入口（无title，适合角落放置）
      FunctionComponent({
        agentId: this.agentId,
        onError: (err: BusinessError) => {
          hilog.error(0x0001, 'AgentDevLog', `出错 ${err.code}`);
        },
        controller: this.controller
      })

      // 形态二：胶囊按钮（有title + queryText，一键触发）
      FunctionComponent({
        agentId: this.agentId,
        onError: (err: BusinessError) => {
          hilog.error(0x0001, 'AgentDevLog', `出错 ${err.code}`);
        },
        options: {
          title: '智能助手',
          queryText: '帮我制定本周运动计划', // 预填指令，点击直接发送
          isShowShadow: true
        },
        controller: this.controller
      })
    }
    .width('100%')
    .padding(20)
  }
}

5.4 三种按钮形态对比

形态	ButtonType	适用场景	特点
圆形按钮	CIRCLE (0)	全局智能助手入口	不显示title，占用空间小
胶囊按钮	CAPSULE (1)	功能性入口（如"生成周报"）	显示title，引导性强
图标上置按钮	ICON_ABOVE_TITLE (2)	API 21+元服务场景	图标与标题上下排列

胶囊按钮的特殊行为：当系统字体倍数 < 1.75时显示为胶囊形状，>= 1.75时显示为矩形圆角按钮。这是因为大字体模式下胶囊高度会超出触摸区域。

5.5 queryText：一键触发的杀手级功能

queryText是FunctionOptions中最实用的参数。它允许你预填用户指令，用户点击按钮后直接发送，无需手动输入：

// 场景：电商App的商品详情页
FunctionComponent({
  agentId: 'shopping_agent_id',
  options: {
    title: 'AI导购',
    queryText: '这款产品的详细参数和用户评价如何？', // 直接发送
    buttonType: 1 // CAPSULE
  }
})

// 场景：办公App的项目管理页
FunctionComponent({
  agentId: 'project_agent_id',
  options: {
    title: '项目助手',
    queryText: '帮我汇总本周项目进展', // 一键生成周报
    buttonType: 1
  }
})

这个设计的巧妙之处在于：开发者可以在用户到达特定页面时，通过queryText注入上下文信息，实现"场景化AI触发"。

5.6 isAgentSupport的错误码处理

在实际开发中，isAgentSupport()可能返回多种错误码，需要逐一处理：

错误码	含义	处理建议
1022400010	参数错误	检查agentId格式
1022400011	用户未同意隐私协议	引导用户同意
1022400012	未登录华为账号	提示登录
1022400013	网络错误	提示检查网络
1022400014	系统内部错误	重试或降级处理

---

六、插件开发实战：云插件 / 端插件 / MCP插件

6.1 三大插件体系概览

小艺开放平台的插件体系是智能体能力的核心扩展机制。三种插件类型各有适用场景：

插件类型	数据位置	通信协议	适用场景
云插件	云端	RESTful / SSE / WebSocket	调用外部API服务
端插件	设备端	Intents Kit	操控鸿蒙设备侧应用
MCP插件	云端/混合	MCP协议	兼容第三方MCP生态

6.2 云插件开发

云插件是最常用的插件类型，通过HTTP协议调用你的后端API服务。

三种通信协议对比：

协议	方向	延迟	适用场景
RESTful	单向请求-响应	低	不需要实时更新。注意：时延必须控制在2.2s内
SSE	服务端→客户端推送	中	接收服务器推送通知
WebSocket	双向实时	最低	需要实时双向通信

认证方式一：AK/SK签名认证

// AK/SK签名计算伪代码（服务端实现）
// sign = Base64(HMAC-SHA256(secretKey, timestamp))
// 请求Header携带：accessKey, sign, ts(毫秒时间戳)
// 服务端校验：ts与当前时间差 < 15分钟（防重放攻击）

// 请求参数示例
const headers = {
  'accessKey': 'your_access_key_64chars',     // String(64)
  'sign': 'your_hmac_sha256_signature',         // String(256)
  'ts': '1714000000000'                         // String(16) 毫秒时间戳
};

认证方式二：OAuth 2.0（Client模式）

// OAuth配置项
const oauthConfig = {
  tokenUrl: 'https://your-server.com/oauth/token',  // Token地址
  clientId: 'your_client_id',                         // 客户端ID
  clientSecret: 'your_client_secret',                 // 客户端密钥
  scope: 'read write'                                 // 授权范围
};

// 流程：先调用tokenUrl换取access_token → 携带token请求业务接口

6.3 端插件开发

端插件是最独特的鸿蒙特色能力------让智能体直接操控设备侧的鸿蒙应用。

核心流程：

1. 在鸿蒙应用中通过 Intents Kit 实现意图能力
   └── 定义Schema（输入参数、输出格式、执行逻辑）

2. 在小艺开放平台创建端插件
   └── 关联步骤1中定义的意图

3. 创建工具模拟集
   └── 帮助LLM理解端插件的能力描述

4. 配置端插件权限管控
   └── 控制哪些智能体可以调用

5. 在智能体中绑定端插件
   └── 智能体即可通过自然语言操控你的应用

端插件 vs 云插件的核心区别：

云插件：智能体 → 云端API → 你的服务器 → 返回数据
端插件：智能体 → 鸿蒙Intents Kit → 你的App本地功能 → 返回数据

端插件的优势：数据不离开设备，适合涉及用户隐私的操作（如访问本地文件、通讯录、相册等）。

6.4 MCP插件开发

MCP（Model Context Protocol）插件兼容行业标准协议，适合已有MCP生态的开发者。

两种创建方式：

1. 标准注册：在小艺开放平台手动填写插件信息，注册发布
2. 外部平台导入：从魔搭（ModelScope）平台批量导入已部署的MCP插件

限制 ：通过外部平台导入的MCP插件，仅支持发布到智能体渠道供本账号调试，无法发布到插件市场和主对话渠道公开使用。

---

七、实战案例：旅游App接入"伴游"智能体

7.1 需求场景

用户在旅游App浏览"上海迪士尼"攻略页面时，点击AI按钮，自动触发"帮我规划上海迪士尼两日游行程"，由智能体生成个性化行程方案。

7.2 完整实现

import { FunctionComponent, FunctionController } from '@kit.AgentFrameworkKit';
import { BusinessError } from "@kit.BasicServicesKit";
import { hilog } from "@kit.PerformanceAnalysisKit";
import { common } from '@kit.AbilityKit';

@Entry
@Component
struct TravelStrategyPage {
  private controller: FunctionController = new FunctionController();
  // 从小艺开放平台获取的伴游Agent ID
  private agentId: string = 'app_travel_agent_1024';
  @State isReady: boolean = false;

  async aboutToAppear() {
    try {
      let context = this.getUIContext()?.getHostContext() as common.UIAbilityContext;
      let supported = await this.controller.isAgentSupport(context, this.agentId);
      this.isReady = supported;
      hilog.info(0x0001, 'TravelAgent', `伴游智能体状态: ${supported ? '可用' : '不可用'}`);
    } catch (err) {
      hilog.error(0x0001, 'TravelAgent', `初始化失败: ${err.code}`);
    }
  }

  build() {
    Column({ space: 16 }) {
      // 页面标题
      Text('上海迪士尼深度游攻略')
        .fontSize(24)
        .fontWeight(FontWeight.Bold)
        .margin({ top: 30 })

      // 核心接入：Agent Framework Kit
      // 不需要写底层网络请求、流式拼接和对话框UI
      // 系统自动拉起小艺对话框，传入queryText一键触发
      if (this.isReady) {
        FunctionComponent({
          agentId: this.agentId,
          onError: (err: BusinessError) => {
            hilog.error(0x0001, 'TravelAgent', `伴游出错: ${err.code}`);
          },
          options: {
            title: '伴游助手',
            queryText: '帮我规划上海迪士尼两日游行程，包含门票购买建议、游玩路线和餐饮推荐',
            buttonType: 1, // CAPSULE
            isShowShadow: true,
            controlSize: 0  // NORMAL
          },
          controller: this.controller
        })
        .width('100%')
        .height(80)
        .borderRadius(12)
        .backgroundColor('#F5F5F5')
      } else {
        // 降级处理：智能体不可用时显示普通提示
        Text('AI伴游功能暂不可用，请检查网络和账号状态')
          .fontSize(14)
          .fontColor('#999999')
      }
    }
    .padding(16)
    .width('100%')
    .height('100%')
  }
}

7.3 小艺平台端配置

在创建"伴游"智能体时，建议配置以下能力：

配置项	建议值	说明
编排模式	LLM模式	自主理解用户需求
插件	天气查询 + 酒店预订 + 地图导航	50+系统插件中选择
知识库	迪士尼攻略文档	Data Augmentation Kit端侧RAG
长期记忆	开启	记住用户偏好（如：喜欢刺激项目）
触发器	位置触发	到达景区附近自动推荐

---

八、3个真实踩坑记录

踩坑1：模拟器上FunctionComponent直接崩溃

现象：在DevEco Studio的模拟器上运行包含FunctionComponent的页面，应用直接闪退，无错误日志。

原因 ：Agent Framework Kit 不支持模拟器，必须在真机上运行。

解决方案：

// 在使用前先检查设备环境
async aboutToAppear() {
  try {
    let context = this.getUIContext()?.getHostContext() as common.UIAbilityContext;
    let supported = await this.controller.isAgentSupport(context, this.agentId);
    if (!supported) {
      // 模拟器或不符合条件的环境，降级处理
      this.showFallbackUI();
      return;
    }
    this.initAgentComponent();
  } catch (err) {
    this.showFallbackUI();
  }
}

教训：官方文档的约束说明一定要仔细看，不要假设"模拟器能跑就是真机能跑"。

---

踩坑2：云插件RESTful接口2.2秒超时

现象：云插件在本地测试一切正常，但接入小艺平台后经常返回"调用超时"。

原因 ：小艺平台对云插件RESTful接口的时延限制为2.2秒（官方文档明确标注），超出即超时。本地测试时网络延迟低所以正常，线上环境经过平台中转后延迟增加。

解决方案：

优化前：查询数据库 + 调用外部API + 数据处理 = 3.5s ❌

优化方案：
1. 数据库查询增加索引 → 0.3s
2. 外部API结果缓存（Redis，TTL=5min）→ 0.05s
3. 数据处理异步化 → 0.2s
总延迟：0.55s ✅

如果确实无法降到2.2s内：
→ 改用SSE或WebSocket协议（无硬性时延限制）

教训：接入平台能力时，必须了解平台的性能约束，并在架构设计阶段就考虑进去。

---

踩坑3：agentId错误码1022400011（隐私协议未同意）

现象 ：真机调试时，isAgentSupport()返回Promise reject，错误码1022400011。

原因：设备上的华为账号未同意AI功能的隐私协议。这是一个运行时状态问题，不是代码问题。

解决方案：

async checkAgentWithRecovery() {
  try {
    let context = this.getUIContext()?.getHostContext() as common.UIAbilityContext;
    let supported = await this.controller.isAgentSupport(context, this.agentId);
    if (!supported) return false;
    return true;
  } catch (err) {
    let code = err.code;
    if (code === 1022400011) {
      // 隐私协议未同意 → 引导用户到设置页面
      // 实际项目中应使用AlertDialog或跳转设置页
      hilog.warn(0x0001, 'AgentDevLog', '请先在设置中同意AI隐私协议');
      return false;
    } else if (code === 1022400012) {
      // 未登录华为账号
      hilog.warn(0x0001, 'AgentDevLog', '请先登录华为账号');
      return false;
    }
    return false;
  }
}

教训：系统级能力的依赖链很长（账号→隐私协议→网络→系统版本），必须做好每一层的降级处理。

---

九、与传统方案的性能对比

9.1 开发效率对比

维度	传统方案（自建AI集成）	Agent Framework Kit	提升
代码量	800-1500行	40-80行	10-20倍
对话框UI	自行实现（2-3天）	系统内置（0行）	100%
流式渲染	WebSocket + Handler	系统自动处理	100%
上下文管理	手动维护Token窗口	系统自动管理	100%
异常处理	断线重连+降级	系统级容错	显著

9.2 运行时性能对比

维度	传统方案	Agent Framework Kit
对话框渲染帧率	30-45fps（JS线程）	60fps（硬件加速）
内存占用	30-80MB（应用进程）	~0MB（系统进程）
后台挂起	需手动管理	系统自动回收
冷启动	1-2s（加载模型）	<500ms（系统预热）

---

十、开发者行动指南

10.1 如何选择接入方式？

你的需求是什么？
├── 只需要在应用里加个AI对话入口
│   └── Agent Framework Kit + FunctionComponent（40行代码搞定）
│
├── 需要端侧RAG，数据不出设备
│   └── Data Augmentation Kit（@kit.DataAugmentationKit）
│
├── 需要智能体调用你的后端服务
│   └── 小艺开放平台 + 云插件（RESTful/SSE/WebSocket）
│
├── 需要智能体操控你的鸿蒙App
│   └── 小艺开放平台 + 端插件（Intents Kit）
│
└── 已有MCP工具链，想复用
    └── 小艺开放平台 + MCP插件

10.2 开发环境准备清单

• 注册华为开发者账号
• 准备HarmonyOS 6.0真机（必须真机，不支持模拟器）
• DevEco Studio 6.0+
• 设备登录华为账号
• 确保网络连通（中国境内）
• 小艺开放平台注册并创建智能体
• 获取Agent ID
• 在module.json5中配置相关权限

10.3 推荐学习路径

第1步：在小艺开放平台创建一个LLM模式智能体（最简单，30分钟搞定）
   ↓
第2步：用FunctionComponent在App中拉起该智能体（验证基础集成）
   ↓
第3步：为智能体绑定2-3个系统插件（体验插件生态）
   ↓
第4步：开发一个云插件对接你的后端服务（扩展能力）
   ↓
第5步：尝试工作流模式编排复杂场景（进阶）
   ↓
第6步：结合Data Augmentation Kit做端侧RAG（数据不出端）

---

总结与互动

HarmonyOS 6.0的AI全栈能力可以用一句话概括：从API 12的基础工具调用，到API 21的操作系统级智能体框架，鸿蒙已经完成了从"AI工具箱"到"AI操作系统"的蜕变。

对开发者而言，这意味着三个关键机会：

1. 开发效率革命：40行代码替代1000行自建代码，系统级能力开箱即用
2. 生态红利期：小艺开放平台刚起步，50+系统插件+MCP兼容+端插件，现在入局有先发优势
3. 端侧AI差异化：Data Augmentation Kit提供的纯端侧RAG能力，是iOS和Android目前不具备的

下一篇预告：《鸿蒙小艺智能体开放平台实战：接入系统级AI Agent能力》------我们将深度实操小艺平台的智能体创建、插件开发、调试上架全流程。

---

💬 讨论话题：

1. 你觉得操作系统级智能体框架（HMAF）和第三方AI SDK（如LangChain）相比，哪个更适合移动端开发？
2. 四种编排模式中，你最看好哪一种的未来发展？
3. 端插件（Intents Kit桥接）这个能力，你觉得在哪些场景下最有价值？

👍 觉得有用请点赞收藏，关注我获取更多AI+鸿蒙实战内容！

❓ 思考题：为什么Agent Framework Kit的云插件RESTful接口要限制2.2秒超时，而不是像普通HTTP调用那样允许更长延迟？答案和系统UX设计有关，评论区聊聊~