logo
积分中心
不只是给 Agent 加个入口:FunctionComponent 如何实现上下文智能交互
头像 ​​泡面加蛋哲学 2026-11-10 17:29:10    发布
15 浏览 1 收藏

很多 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 能够把智能体能力嵌入具体业务页面,开发者需要进一步设计页面上下文、初始任务和智能体实际可访问的数据。

©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS
头像

​​泡面加蛋哲学

我还没有写个人简介......

3

帖子

1

提问

0

粉丝

关注
地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255