通过 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 脚本,把原有业务能力以标准化方式开放出去。
相关推荐
泡面加蛋哲学
我还没有写个人简介......
帖子
提问
粉丝
长安汽车申请基于鸿蒙系统的远程车控方法专利,降低了远程控车应用的开发成本和维护难度
2026-08-20 11:35:19 发布



0
京公网安备:11010502051901号