logo
积分中心
让小艺不只会打开页面,还能执行查询:@InsightIntentFunctionMethod 实战
头像 ​​泡面加蛋哲学 2026-11-10 17:30:24    发布
22 浏览 3 收藏

打开 APP 的某个页面,是智能交互的第一步。

但对于很多应用来说,用户更希望直接完成任务。例如,打开运动 APP 后,用户不需要再进入运动记录页面、选择日期、点击查询,而是希望直接问:“我上周跑了多少公里?”

这就需要应用提供可被系统调用的业务能力。

HarmonyOS 从 API version 20 开始支持通过 @InsightIntentFunctionMethod 将函数调用转换为系统意图。它适合将现有函数能力以意图形式开放出来。

先把业务函数独立出来

假设运动 APP 已经有一套运动数据服务:

class RunningService {

static async getWeeklyDistance(

week: string

): Promise<number> {

// 实际项目中从本地数据库或业务服务读取数据

return 32.5;

}

}

这里先把查询逻辑独立在业务层,而不是直接写在页面组件中。

这样做的好处是,无论用户从 APP 页面进入,还是通过意图触发,都可以复用同一套业务逻辑。

再研究函数意图的定义

官方装饰器体系提供了 @InsightIntentFunctionMethod,可以将函数方法转换为意图。开发者需要根据 API 参考配置意图描述、参数和执行方式。

工程实现时,建议先明确函数的输入输出契约:

interface WeeklyRunningResult {

week: string;

distanceKm: number;

runCount: number;

}

例如,用户请求“查询上周跑步记录”,应用需要确定“上周”的时间范围,再调用数据服务,最终返回距离和次数。

这段接口定义是业务层示意,不是官方意图参数 Schema。

参数设计决定了意图是否好用

如果用户说“查一下上周跑步情况”,应用至少需要处理:

  • 时间范围:上周。
  • 查询对象:跑步记录。
  • 返回内容:距离、次数等指标。

如果用户只说“查一下我的运动”,就需要结合应用业务设计默认查询范围,或者进一步澄清。

参数不能全部设计为必填项,也不能把所有缺失值都当作空字符串处理。

查询和修改要采用不同策略

查询类函数通常可以在身份校验通过后执行。

但如果用户说“把上周跑步记录删除”,就涉及数据修改,需要增加权限校验和确认流程。

不要因为使用了意图调用,就让原本的业务安全机制失效。

验证重点

测试时不要只用一个固定表达方式。

至少准备以下几组请求:

  • 查询上周跑步距离。
  • 查一下最近七天跑了多少公里。
  • 看看我这周运动了几次。
  • 查询一个没有运动记录的时间段。

重点观察系统是否能够正确匹配意图、传递参数,以及应用是否能够返回真实业务结果。

技术价值: @InsightIntentFunctionMethod 的意义在于让应用已有的业务函数拥有新的系统级调用入口。开发者应优先选择边界清晰、参数明确、结果可验证的函数进行接入。

©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS
地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255