Intents Kit简介
=============

Intents Kit（意图框架服务）是HarmonyOS级的意图标准体系 ，意图连接了应用/元服务内的业务功能。

意图框架能帮开发者将应用/元服务内的业务功能，智能分发到各系统入口，这个过程即智慧分发。其中系统入口包括：小艺对话、小艺搜索、小艺建议。

系统入口、意图框架、鸿蒙生态的关系如下：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f8/v3/6byg7Gi4QnK3XT5TGe12mQ/zh-cn_image_0000002625109125.png?HW-CC-KV=V1&HW-CC-Date=20260612T073759Z&HW-CC-Expire=86400&HW-CC-Sign=F0367A1E2569389221DA9B2BD9B4CD942EF62EDEE13E2CD5F36FB0015F3CE8C6)

#### Intents Kit优势

利用HarmonyOS的大模型、多维设备感知等AI能力，准确且及时地获取到用户显性、潜在意图，从而实现个性化、多模态、精准的智慧分发。

#### 智慧分发

为方便开发者接入，智慧分发提供了多种特性类别，当前已开放习惯推荐、事件推荐、技能调用-语音、本地搜索，后续会陆续开放其他特性类别。每种特性类型支持的典型系统入口、分发逻辑见下表：

| **特性类型** | **系统入口** | **分发逻辑** |
| :-- | :-- | :-- |
| 习惯推荐 | 小艺建议 | 应用或元服务向系统共享意图，系统学习意图规律，在合适的时机推荐服务。比如向系统共享用户浏览资讯意图的数据，经过习惯规律性学习后，小艺建议会在合适的时机给用户推荐合适的浏览资讯服务与内容。 |
| 事件推荐 | 小艺建议 | 应用或元服务向系统共享意图，系统提取意图内容中的事件，结合时间、位置等信息向用户推荐提醒服务。比如向系统共享用户购买的电影票订单数据，由系统提取订单数据中的关键特征如时间、位置等，小艺建议会在合适的时机给用户推荐观影提醒服务。 |
| 位置推荐 | 小艺建议 | 位置感知推荐能力基于华为意图框架与花瓣地图定位识别能力，通过小艺建议等智慧入口，适时、适需地将服务内容以卡片形式推荐给用户。位置感知基于GNSS、WLAN和基站等融合定位技术，设置圆形、多边形等地理围栏，提供室内外高精度定位能力。 |
| 技能调用-语音 | 小艺对话 | 系统基于AI大模型对理解用户显性或隐性的输入，帮用户完成应用或元服务的功能调用。比如用户在小艺对话中询问“从深圳去北京的飞机要多少钱”，可以理解用户搜索机票的意图，调用应用或元服务提供的搜索机票意图获取机票数据并向用户呈现。 |
| 本地搜索 | 小艺搜索 | 应用或元服务向系统共享意图，系统对意图的实体内容构建本地索引，满足用户搜索的需求。比如向系统共享“华为开发者大会”相关报道资讯后，用户在该入口输入相关关键词，即可将应用或元服务内的资讯内容检索出来。 |

为了满足更细粒度的分发诉求，每类特性类别下提供多个具体特性，具体特性的分发系统入口、开发依赖见[各垂域的智慧分发特性列表](https://developer.huawei.com/consumer/cn/doc/service/intents-ai-distribution-characteristic-0000001901922213#section2656133582215)。具体特性开发依赖的意图相关字段见[各垂域意图Schema](https://developer.huawei.com/consumer/cn/doc/service/intents-schema-0000001901962713)。

#### 意图的运行逻辑

HarmonyOS、应用/元服务的交互中，意图运行方式分为意图调用和意图共享：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/28/v3/YH7tEgAyTfGVd-RRgQCKqw/zh-cn_image_0000002594669608.png?HW-CC-KV=V1&HW-CC-Date=20260612T073759Z&HW-CC-Expire=86400&HW-CC-Sign=9F22969B6ABDDAD9C324839C68B212B7FA4395A3544DF41CC885D6F12801F873)

| “**意图”运行方式** | **发起者** | **定义** |
| :-- | :-- | :-- |
| **意图共享** | 应用/元服务 | 
指应用/元服务主动向HarmonyOS共享意图，可用于HarmonyOS构建本地内容索引、学习用户的行为规律，以支持本地搜索和主动建议。

意图共享包含动作和实体两个部分，动作支持完成时和将来时两种机制。

\- 完成时：用户意图已执行，共享的数据可用于本地搜索和系统建议。

\- 将来时：意图是基于用户行为预测的，共享的数据可用于本地搜索。

意图框架还支持开发者向系统进行辅助实体共享，例如位置信息等，用于场景推荐和其他智慧分发功能的增强。

 |
| **意图调用** | HarmonyOS | 

指HarmonyOS主动调用应用/元服务的功能。

用户在系统入口输入信息或者系统主动推荐后，系统可向应用/元服务发起意图调用，例如播放音乐、查看旅游攻略、搜索视频等。

 |

#### 约束与限制

#### \[h2\]设备限制

本Kit仅适用于Phone、Tablet、PC/2in1。

#### \[h2\]地区限制

本Kit仅支持中国境内（香港特别行政区、澳门特别行政区、中国台湾除外）提供服务。

#### \[h2\]操作系统限制

HarmonyOS 5.0及以上。

#### 模拟器支持情况

本Kit暂不支持模拟器。