智能体作为一个由用户通过角色指令精心设计的具有明确身份和目标的虚拟实体,其核心价值在于能够像人一样使用自然语言对话,理解用户需求,运用预设的知识、能力和逻辑进行思考与推理,并主动生成恰当的响应或执行相应操作(任务完成、信息提供、服务实施),以满足用户需求或实现预设目标。通过用户友好的交互界面、简便的接入方式及广泛的应用场景,满足消费者在日常生活中对智能助手、信息检索、推荐等功能的需求。同时,智能体还可服务于多个垂直行业和业务场景,有效拓展市场覆盖面与增强用户粘性,用户亦可直接与智能体独立对话,以获得场景化的连贯知识与服务。
小艺开放平台是小艺结合了意图框架与华为AI大模型能力面向开发者的能力开放平台。基于该平台的小艺智能体平台允许开发者构建智能体,为用户提供大模型时代的智能新体验,同时实现业务增长。开发者可以基于小艺智能体平台开发专属智能体。
本文主要介绍如何基于智能问答场景和音频播放场景,在小艺智能体平台上快速搭建智能体并适配相应需求场景。
智能体从创建到上架主要包含以下五个步骤:
登录小艺开放平台,点击【立即体验】按钮,进入小艺智能体平台页面。点击左上角【+创建智能体】按钮,即可进入智能体创建流程。可自行设定智能体的相关信息,包括它的名称、头像、智能体描述、智能体分类和运行设备等信息。
准备条件:真机调试及端插件开发需在HarmonyOS 5.1.0 Release及以上版本的设备上进行。

智能体分为LLM模式、工作流模式和A2A模式三种,对于不同的场景,适配的智能体模式也会有所不同。
LLM模式智能体主要依靠大语言模型的能力,如语言理解、生成、推理等,来处理任务和回答问题。它通常直接根据用户输入,利用大语言模型内部的知识和算法生成响应。
工作流模式智能体是通过预定义的代码路径,协调智能体与工具的交互。它将任务按照特定顺序或规则分解为多个步骤,每个步骤有明确的输入和输出,智能体按照预设流程依次执行,以实现任务目标。这种模式强调可预测性和一致性,适合任务明确、流程固定的场景。
A2A模式是一种三方智能体接入小艺开放平台的高效编排方式。开发者可通过该模式基于鸿蒙Agent通信协议快速、便捷地将成熟的第三方智能体对接至小艺开放平台,实现分发与调用,提升平台的场景覆盖能力。该模式适用于同时具备鸿蒙端应用与云侧智能体能力的企业开发者。
模式 | LLM模式(Agent) | 工作流模式(Workflow) | A2A模式 |
|---|---|---|---|
核心逻辑 | 基于内部知识直接生成回答,由大模型决策进行工具调用 | 按预设流程分步执行(如数据查询→格式转换→结果整合) | 通过标准化通信协议,实现鸿蒙生态中智能体跨设备协作与端云协同。 |
智能问答场景适用性 | 适合知识型、交互型问答(如常识咨询、客服答疑、教育辅导) | 适合多步骤流程化任务(如报销申请审批、物流跟踪) | 适合整合多源动态知识、融合多模态响应并跨服务生成连贯交互的场景(如医疗咨询) |
音频播放场景适用性 | 适合处理用户语音指令(如 “播放周杰伦的歌”),需调用外部工具处理音频解码、渲染等底层操作 | 适合音频播放的全链路处理(从资源获取到设备输出) | 通过协议扩展第三方播控能力、设备间播放状态同步及低时延优化策略,实现无缝跨端音频流转与场景化音质适配。 |
不同编排模式的智能体,能力拓展部分的功能点也会有所区别。各编排模式的区别可参考开发者指导文档快速开始,开发者可根据不同模式的区别,考虑使用场景应该适配何种编排模式的智能体,选择对应的编排模式,并设定智能体相关信息,便可创建对应模式的智能体。

智能体创建后,进入智能体的编排页面,开始智能体的编排,给智能体添加各种能力,优化完善智能体。其中,开场对话可以让用户快速了解你的智能体功能或场景设定故事背景,预置问题可以让用户通过点击快速体验智能体的能力,角色指令(prompt)直接决定你所创造的智能体的效果。
以下为LLM模式和工作流模式的编排页面:


在搭建完成智能体后,开发者可以在调试与预览区域与智能体进行对话,测试该智能体功能是否与预期相同,并根据智能体执行过程及响应信息对智能体配置进行优化与调整,具体调试过程可参考开发者指导文档调试与预览,包括真机测试与调试两种功能验证方式。
功能测试完成后,点击【保存】【上架】即可将智能体提交到上架审核阶段,具体流程可参考开发者指导文档入门指南。为了方便开发者的智能体能够顺利通过审核,可参考上架审核规范排查检视自开发的智能体。待通过审核上架后,即可在小艺平台使用完整的智能体。
智能问答系统凭借其高效、便捷的交互特性,已广泛应用于多个领域。依托知识库,智能问答能够精准匹配用户需求,提供准确且专业的回答。例如,医疗场景中,用户描述 “咳嗽 + 发热”,系统结合症状库推荐科室并提示 “可能的流感风险”。智能问答的核心价值在于通过自然语言交互解决信息获取效率问题,它通常直接根据用户输入,利用开发者上架的知识库或大语言模型内部的知识和算法生成响应,实现更精准、个性化的服务。具有准确与规范的答案(所有回答基于企业预设的知识库或官方数据,避免人工客服因理解偏差或记忆错误导致答案不一致)和服务质量的可控性(企业可随时更新知识库,保证答案同步最新政策,如税法调整、产品更新等)。
模式选择
智能问答场景主要为简单的语言交互(如闲聊、知识查询),无需外部工具调用,因此优先选择LLM模式,可基于内部知识直接生成回答。LLM 模式主要有自然语言处理能力、知识整合效率、交互体验等方面的核心优势,凭借这些原生优势,成为智能问答的主流选择,尤其适合知识型、交互型、跨领域的问答场景。
模式 | LLM 模式 | 工作流模式 |
|---|---|---|
核心逻辑 | 基于内部知识直接生成回答,由大模型决策进行工具调用 | 按预设流程分步执行(如数据查询→格式转换→结果整合) |
智能问答场景适用性 | 适合知识型、交互型问答(如常识咨询、客服答疑、教育辅导) | 适合多步骤流程化任务(如报销申请审批、物流跟踪) |
智能问答场景局限性 | 依赖训练数据时效性(需定期更新知识库);复杂计算任务需结合工具 | 流程固定,难以应对灵活的问答需求;需人工配置大量流程节点 |
问答智能体主要基于开发者提供的知识库,智能整合内部知识,生成所需回答。因此,除了需要选择LLM模式的智能体外,还需要自定义所需场景的知识库。
知识库创建上架
LLM模式智能体创建
功能验证
可调试测试或真机测试,真机测试需添加白名单,设置白名单手机或账号,发布至手机智能体,方可真机测试。

上架升级
功能测试完成后,点击【保存】【上架】即可将智能体提交到上架审核阶段,具体流程可参考开发者指导文档入门指南。
模式选择
音频播放场景APP一般包括跳转播放页、播放音频、获取歌曲名称等功能,对于涉及到存在音频播放场景的项目,想要通过语音、文字等操作智能化实现上述功能,则需使用端插件和工作流模式的智能体架构。该架构不仅解决了音频播放场景智能化交互(语音 / 文字指令),还提供了高效的本地执行载体,形成本地化处理与流程协同的高效架构。结合工作流模式,设置节点控制(如音频播放、页面跳转、信息获取),端插件可本地协调多模块交互,运行在设备本地的功能模块。
模式 | 工作流模式(Workflow) | LLM 模式 |
|---|---|---|
核心逻辑 | 按预设流程分步执行(如数据查询→格式转换→结果整合) | 基于内部知识直接生成回答,由大模型决策进行工具调用 |
音频播放场景适用性 | 适合音频播放的全链路处理(从资源获取到设备输出) | 适合处理用户语音指令(如 “播放周杰伦的歌”),但无法直接处理音频解码、渲染等底层操作 |
音频播放场景局限性 | 灵活性较低,需人工配置所有流程节点 | 不具备音频编解码、设备驱动等底层能力,需依赖外部工具支持 |
音频播放场景,主要基于音频编解码等功能,需要外部工具的支持,可在端插件实现音频播放功能。同时,音频播放场景一般涉及页面跳转、音频播放、获取信息等功能,通过设计流程节点,可搭建业务所需的整体流程。因此,除了需要选择工作流模式的智能体外,还需要实现适配流程节点的端插件。
端插件创建上架
本场景涉及三个功能,包括获取歌曲名称、跳转播放页、播放音频,因此配置了三个对应功能的工具。具体配置信息如下图所示:
获取信息 | 跳转页面 | 播放音频 |
|---|---|---|
|
|
|
端插件开发
端插件作为设备本地运行的功能模块,提供能力的服务在HarmonyOS设备侧,需要在端侧进行代码实现。对于音频播放场景的实现有以下几步:
intentName对应工具名称,intentVersion对应工具版本号,srcEntry为基于意图框架InsightIntentExecutor类方法的业务逻辑处理文件。
{
"insightIntents": [
{
"domain": "",
"intentName": "PlayHiddenAudio",
"intentVersion": "1.0.0",
"srcEntry": "./ets/entryability/InsightIntentExecutorImpl.ets",
"uiAbility": {
"ability": "EntryAbility",
"executeMode": [
"background"
]
}
},
{
"domain": "",
"intentName": "GetAudioName",
"intentVersion": "1.0.0",
"srcEntry": "./ets/entryability/InsightIntentExecutorImpl.ets",
"uiAbility": {
"ability": "EntryAbility",
"executeMode": [
"background"
]
}
},
{
"domain": "",
"intentName": "OpenSecondPage",
"intentVersion": "1.0.0",
"srcEntry": "./ets/entryability/InsightIntentExecutorImpl.ets",
"uiAbility": {
"ability": "EntryAbility",
"executeMode": [
"background",
"foreground"
]
}
}
]
} import { insightIntent, InsightIntentExecutor } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { window } from '@kit.ArkUI';
import AudioPlayHandler from './intentHandlers/AudioPlayHandler';
import TextGetHandler from './intentHandlers/TextGetHandler';
import PageNavigateHandler from './intentHandlers/PageNavigateHandler';
import { hilog } from '@kit.PerformanceAnalysisKit';
export default class InsightIntentExecutorImpl extends InsightIntentExecutor {
// Instruction implementation class.
private audioHandler = new AudioPlayHandler();
private textHandler = new TextGetHandler();
private pageHandler = new PageNavigateHandler();
// Intention execution method for backend execution.
async onExecuteInUIAbilityBackgroundMode(
intentName: string,
params: Record<string, object>
): Promise<insightIntent.ExecuteResult> {
try {
switch (intentName) {
// Play audio intention.
case 'PlayHiddenAudio':
const stringParam: Record<string, string> = this.convertToRecord(params);
return this.audioHandler.execute(stringParam);
// Obtain audio name intent.
case 'GetAudioName':
return this.textHandler.execute();
default:
return {
code: -1,
result: {
'status': 'failed',
'message': `not valid intent name, ${intentName}`
}
};
}
} catch (error) {
return {
code: -2,
result: {
'status': 'failed',
'message': `Intent execution failed: ${(error as BusinessError).message}`
}
};
}
}
private convertToRecord(origin: Record<string, object>): Record<string, string> {
const result: Record<string, string> = {};
Object.keys(origin).forEach(key => {
result[key] = String(origin[key]);
});
return result;
}
// Execution method of backend execution intention.
async onExecuteInUIAbilityForegroundMode(name: string, param: Record<string, Object>, pageLoader: window.WindowStage):
Promise<insightIntent.ExecuteResult> {
switch (name) {
// Open the second page intention.
case 'OpenSecondPage':
return this.pageHandler.execute();
default:
pageLoader.loadContent('pages/MainPage')
.catch((error: BusinessError) => {
hilog.error(0x000, 'testTag', `loadContent failed. code=${error.code}, message=${error.message}`);
})
break;
}
return Promise.resolve({
code: -1,
result: {
message: 'unknown intent'
}
} as insightIntent.ExecuteResult)
}
} import { insightIntent } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { MediaService } from '../../utils/audioplayer/MediaService';
export default class TextGetHandler {
async execute(): Promise<insightIntent.ExecuteResult> {
try {
// Execute the method of obtaining the name of the played audio.
const audioName: string = MediaService.getInstance().getAudioFileName();
// Return result.
return {
code: 0,
result: {
status:'success',
audioName: audioName,
message: 'get audio name success'
}
};
} catch (error) {
throw new Error(`get audio name failed: ${(error as BusinessError).message}`);
}
}
} 配置module.json5文件中的skills标签,标识跳转场景。
"skills": [
{
"entities": [
"entity.system.home",
"entity.system.browsable"
],
"actions": [
"ohos.want.action.home",
"ohos.want.action.viewData"
],
"uris": [
{
"scheme": "demo",
"host": "aiagentdemo.com",
"path": "SecondPage"
}
]
}
] 在EntryAbility.ets文件中的onNewWant()生命周期回调中,获取、解析拉起方传入的应用链接,开发者可自定义后续的业务处理。
onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {
hilog.info(DOMAIN, 'testTag', 'Received URI:', want.uri);
const uri = want.uri;
let pathname = '';
if (uri) {
try {
const urlObj = url.URL.parseURL(uri);
pathname = urlObj.pathname;
} catch (error) {
let err = error as BusinessError;
hilog.error(0x000, 'testTag', `getUIContext failed. code=${err.code}, message=${err.message}`);
}
uiContext?.getRouter().pushUrl({ url: 'pages' + pathname })
.catch((error: BusinessError) => {
hilog.error(0x000, 'testTag', `pushUrl failed. code=${error.code}, message=${error.message}`);
})
}
} 执行页面跳转并返回跳转结果。
import { insightIntent } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
export default class PageNavigateHandler {
async execute(): Promise<insightIntent.ExecuteResult> {
try {
// Execute page redirection.
let uiContext: UIContext | null | undefined = null;
uiContext = AppStorage.get('uiContext');
uiContext?.getRouter().pushUrl({ url: 'pages/SecondPage' })
.catch((err: BusinessError) => {
hilog.error(0x0000, 'testTag',`pushUrl failed, Code:${err.code}, message:${err.message}`);
})
return {
code: 0,
result: {
status: 'success',
message: 'Navigation successful',
targetPage: 'SecondPage'
}
};
} catch (error) {
throw new Error(`Page navigation failed: ${(error as BusinessError).message}`);
}
}
} import { insightIntent } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { MediaService } from '../../utils/audioplayer/MediaService';
export default class AudioPlayHandler {
async execute(param: Record<string, string>): Promise<insightIntent.ExecuteResult> {
try {
// Analyze the parameters passed in by the plugin on the parsing end.
const rawAudioName = param.audioName;
const audioName = rawAudioName.toString();
// The method of playing audio can be customized by developers according to their actual business needs.
MediaService.getInstance().initAudioPlayer(audioName);
// Return the result to the end plugin.
return {
code: 0,
result: {
status: 'success',
message: `play audio ${audioName} started`,
}
};
} catch (error) {
throw new Error(`Audio play failed: ${(error as BusinessError).message}`);
}
}
} 工作流创建上架
创建选择器 | 选择器条件分支 |
|---|---|
|
|


工作流模式智能体编排
音频播放场景所需的端插件、工作流都已经开发完成,并成功上架成功后,接下来就是智能体的搭建过程了。
功能验证
调试与预览 | 调试详情 |
|---|---|
|
|
上架升级
功能测试完成后,点击【保存】【上架】即可将智能体提交到上架审核阶段,具体流程可参考开发者指导文档入门指南。上架完成后,可在端侧小艺的智能体页面搜索查询到创建的智能体并使用。效果如下:

智能体具有拟人化交互与智能决策、多场景需求覆盖的特点,通过 “交互智能化 + 场景定制化” 满足用户与行业需求。小艺智能体平台依托华为技术生态,为开发者提供从创建到上架的全流程工具支持,助力专属智能体的快速落地与实现。