# Intents Kit简介

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

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

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

#### Intents Kit优势

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

#### 智慧分发

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

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

为了满足更细粒度的分发诉求，每类特性类别下提供多个具体特性，具体特性的分发系统入口、开发依赖见各垂域的智慧分发特性列表。具体特性开发依赖的意图相关字段见各垂域意图Schema。

#### 意图的运行逻辑

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

| “意图”运行方式 | 发起者 | 定义 |
| --- | --- | --- |
| 意图共享 | 应用/元服务 | 指应用/元服务主动向HarmonyOS共享意图，可用于HarmonyOS构建本地内容索引、学习用户的行为规律，以支持本地搜索和主动建议。 意图共享包含动作和实体两个部分，动作支持完成时和将来时两种机制。 - 完成时：用户意图已执行，共享的数据可用于本地搜索和系统建议。 - 将来时：意图是基于用户行为预测的，共享的数据可用于本地搜索。 意图框架还支持开发者向系统进行辅助实体共享，例如位置信息等，用于场景推荐和其他智慧分发功能的增强。 |
| 意图调用 | HarmonyOS | 指HarmonyOS主动调用应用/元服务的功能。 用户在系统入口输入信息或者系统主动推荐后，系统可向应用/元服务发起意图调用，例如播放音乐、查看旅游攻略、搜索视频等。 |

#### 约束与限制

#### 设备限制

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

#### 地区限制

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

#### 操作系统限制

HarmonyOS 5.0及以上。

#### 模拟器支持情况

本Kit暂不支持模拟器。