很多 APP 已经接入了智能体,但入口设计比较简单:页面上放一个“AI 助手”按钮,用户点击后进入对话,再重新描述自己的需求。
这种交互有一个问题:用户明明正在浏览某个商品、某篇文章或某项服务,却还要重新告诉智能体自己正在看什么。
HarmonyOS Agent Framework Kit 提供的 FunctionComponent,可以帮助开发者拉起指定智能体。除了 agentId 和错误回调,组件还提供 FunctionOptions 等配置能力。
一个组件解决智能体拉起
基础导入方式:
import {
FunctionComponent
} from '@kit.AgentFrameworkKit';
import {
BusinessError
} from '@kit.BasicServicesKit';
例如,在文章详情页面增加智能体入口:
@Entry
@Component
struct ArticlePage {
private agentId: string = '替换为真实AgentID';
build() {
Column() {
Text('文章标题')
.fontSize(24)
Text('这里是文章正文……')
.fontSize(16)
FunctionComponent({
agentId: this.agentId,
onError: (err: BusinessError) => {
console.error(
`Agent启动失败:${err.code}, ${err.message}`
);
},
options: {
title: '总结这篇文章'
}
})
}
.padding(20)
}
}
需要注意,FunctionComponent 的 agentId 必须是已经创建并上线的智能体标识,不能随意填写。组件仅支持 Stage 模型,起始版本为 API 20。
让智能体入口更贴近当前页面
FunctionOptions 中还提供了 queryText,可以用于设置组件的初始查询文本。
例如,页面入口可以围绕当前任务设计:
options: {
title: '帮我分析这款商品',
queryText: '请帮我分析当前商品的特点'
}
这段配置展示的是组件参数的使用思路。要让智能体真正获得当前商品名称、价格和规格等信息,还需要结合智能体自身的上下文获取机制或业务能力开放方案。
不能把一句初始提示文本误认为已经完成了页面数据传递。
组件初始化有一个容易踩的坑
官方 API 明确说明,FunctionComponent 的参数属于初始化配置项,组件实例化后修改参数值,不能实现动态更新。
这意味着,如果页面从商品 A 切换到商品 B,开发者不能简单修改一个变量,就认为智能体入口会自动更新所有配置。
更合理的方式是根据页面业务状态设计组件生命周期,在需要变更初始化配置时重新初始化组件。
不要把智能体入口放得到处都是
入口设计也需要遵循业务场景。
例如:
- 文章详情页:总结文章、提炼观点。
- 商品详情页:分析参数、比较商品。
- 旅行行程页:优化行程。
- 健身记录页:分析运动数据。
技术价值: FunctionComponent 不只是一个 UI 组件。它让 APP 能够把智能体能力嵌入具体业务页面,开发者需要进一步设计页面上下文、初始任务和智能体实际可访问的数据。
相关推荐
32
0
19
0
34
0泡面加蛋哲学
我还没有写个人简介......
帖子
提问
粉丝
API 26 新能力实战:把 APP 内的 ArkTS 业务函数封装成 Skill
2026-11-10 17:10:25 发布长安汽车申请基于鸿蒙系统的远程车控方法专利,降低了远程控车应用的开发成本和维护难度
2026-08-20 11:35:19 发布



京公网安备:11010502051901号