logo
积分中心
API 26 新能力实战:把 APP 内的 ArkTS 业务函数封装成 Skill
头像 ​​泡面加蛋哲学 2026-11-10 17:10:25    发布
28 浏览 5 收藏

通过 SKILL.md、ArkTS 脚本和 skillProfiles,让系统智能体直接调用应用业务能力

如果一个 HarmonyOS APP 已经拥有成熟的业务服务,开发者是否可以不重新搭建一个完整 Agent,而是把已有功能开放给系统智能体调用?

API version 26.0.0 开始提供了基于 ArkTS 脚本的应用 Skill 开发能力。

这项能力非常值得 APP 开发者关注:应用可以通过描述文件和 ArkTS 入口脚本,将内部业务能力封装为 Skill,供系统智能体调用。

工程目录先搭起来

官方开发指导以音乐助手为例,给出了类似下面的工程结构:

entry/

├── skills/

│ └── example-org-music-assistant/

│ ├── scripts/

│ │ └── MusicSkill.ets

│ └── SKILL.md

└── src/

└── main/

├── ets/

│ ├── entryability/

│ │ └── EntryAbility.ets

│ └── service/

│ └── MusicPlayer.ets

└── module.json5

其中:

  • SKILL.md:描述 Skill 的名称、能力、触发场景和使用约束。
  • MusicSkill.ets:Skill 的 ArkTS 脚本入口。
  • MusicPlayer.ets:应用原有业务服务。
  • module.json5:将 Skill 和对应 Ability 运行环境绑定。

这些目录和文件名称需要遵循官方规范,不能随意替换固定目录名称。

先把业务能力保留在原有服务层

例如,音乐 APP 已经有播放服务:

export class MusicPlayer {

static async playByName(

name: string

): Promise<boolean> {

// 这里调用 APP 已有的音乐搜索和播放逻辑

return true;

}

}

这个服务不需要为了 Skill 再复制一套。

Skill 的职责是接收系统智能体传递的请求,并将其桥接到应用原有业务能力。

Skill 脚本负责连接外部请求和内部业务

官方脚本管理接口提供 ArkTSScriptInfo、ExecuteResult 和 completeArkTSScriptInApp() 等能力。脚本入口通过 export default class 导出,第一个参数固定为 ArkTSScriptInfo。

开发者需要按照官方示例中的入口参数、脚本上下文和结果上报规范实现脚本,而不是自行定义一套系统无法识别的函数签名。

结果必须按规范回传

应用 Skill 执行完成后,需要通过:

scriptManager.completeArkTSScriptInApp(

context,

requestCode,

result

);

上报执行结果。该接口使用 Promise 异步完成结果上报。

这里的 context、requestCode 和 result 都应来自真实脚本运行上下文,并按照官方类型要求构造。

这项能力适合什么应用?

例如:

  • 音乐 APP:按名称播放音乐、控制播放。
  • 资讯 APP:查询收藏文章、生成阅读清单。
  • 运动 APP:查询运动记录、查看训练计划。
  • 笔记 APP:搜索笔记、创建待办事项。

不过,涉及个人数据或写入操作时,仍然需要遵循应用本身的权限和业务规则。

技术价值: API 26 的应用 Skill 能力为已有 HarmonyOS APP 提供了一种新的业务能力开放方式。它的关键不是重新造一个智能体,而是用声明式能力描述和 ArkTS 脚本,把原有业务能力以标准化方式开放出去。


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

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255