重塑应用搜索体验，系统级入口功能一步直达

面对设备上多个应用，用户常常面临搜索入口分散、结果精准度不足及操作步骤繁琐的问题。

传统模式下，用户需要在不同应用间频繁切换才能找到目标内容，例如搜索一首歌曲可能需要先打开音乐应用再手动输入关键词，而无法通过系统级统一入口直接触达。同时，搜索结果往往依赖关键词匹配，缺乏对用户行为数据的深度挖掘，导致推荐内容与真实需求脱节。从搜索到最终触达目标内容往往需要多次跳转，例如点击结果后需等待应用加载、页面切换等，体验割裂且效率低下。

对于开发者而言，连接第三方服务（如导航、支付）需逐一对接API，适配不同接口规范的开发工作量大，且难以调用系统级能力，导致开发效率低、维护成本高。

HarmonyOS SDK 意图框架服务（Intents Kit）提供技能调用方案中的功能一步达能力和功能搜索方案；技能调用是意图框架依托系统AI多模态大模型能力做深度用户输入理解，并通过解析的用户意图对接应用或元服务内的功能和内容。其中功能一步达可通过小艺帮助用户快捷打开应用内功能，实现一步直达，功能可由开发者自定义批量声明。开发者将应用/元服务内的功能和内容通过意图框架注册到HarmonyOS，即可实现"一步搜索，内容直达"。

开发者接入功能一步达和功能搜索方案后，可以降低开发成本，复用系统提供的卡片模板，无需重复开发搜索界面；提升应用曝光率，通过系统级搜索入口扩大应用内容的可见性。

典型场景

功能一步达

用户通过对小艺对话进行自然语言输入实现内容查询，知识问答，以及通过对图片选定识别问答进行服务获取。端侧意图调用直接进入应用功能页面，无需其他业务参数，可批量声明接入。开发者将应用内的功能声明接入意图框架后，用户可以通过小艺直接打开相应功能页面，比如"打开xx地图的查路线"，实现一步直达。

功能搜索

开发者将应用内的功能声明接入意图框架后，在小艺搜索入口，搜索对应功能名或者应用名，可以将应用内功能直接搜出，比如地图应用声明"查路线"功能后，可通过搜索应用名或功能名搜出具体功能，点击后直接拉起应用中的功能页面。

接入方案

功能一步达方案概述

若应用中有"查找路线"和"扫一扫"两个功能想要注册到意图框架中，让用户通过小艺快速打开对应功能页面，比如"帮我打开XXX的查找路线"、"帮我打开XXX的扫一扫"或"帮我打开XXX的扫码"，则需要在意图声明文件中声明JumpFunctionPage意图，以及上述两个功能，并实现对应意图调用。

意图注册

开发者需要编辑对应的意图配置insight_intent.json文件实现意图注册。insight_intent.json文件需要放置在module下面的指定目录：/src/main/resources/base/profile/insight_intent.json，并且整个工程中只能出现一个insight_intent.json文件。

{"insightIntents": [{"intentName": "JumpFunctionPage",    // 意图名称"domain": "ToolsDomain","intentVersion": "1.0.1", // 意图本身的版本号// 意图调用逻辑入口"srcEntry": "./ets/entryability/InsightIntentExecutorImpl.ets","uiAbility": {
// 意图所在module、ability，以及代码相对路径入口"ability": "EntryAbility",// UIAbility支持前后台两种执行模式"executeMode": ["foreground"]},"inputParams": [{ // 部分意图开放意图参数定义，格式整体参考JSON-Schema。 "properties": { // 描述参数列表，后续可以同级别增加其他描述节点"pageId": { // 具体功能的标识的key值"type": "string", // 参数类型"enum": [ {"value": "1", // 具体功能的标识的value值"displayName": "查找路线", // 功能名，用于匹配用户query"keywords": ["查路线"], // 参数枚举值别名，可以用于索引、过滤"displayDescription": "查找到达目的的路线", // 功能描述"icon": "https://abc.xx" // 功能图标},{"value": "2", // 具体功能的标识的value值"displayName": "扫一扫", // 功能名，用于匹配用户query"keywords": ["扫码"], // 参数枚举值别名，可以用于索引、过滤"displayDescription": "用于扫码", // 功能描述"icon": "https://abc.xx" // 功能图标}]}}}]}]
}

端侧前台意图调用

开发者需自己实现InsightIntentExecutor，并在对应回调实现打开落地页的能力。

步骤如下：

1）继承InsightIntentExecutor；

2）重写对应方法，例如目标拉起前台页面，则可重写onExecuteInUIAbilityForegroundMode方法；

3）通过意图名称，识别跳转功能页面意图(JumpFunctionPage)，在对应的方法中传递意图参数（param），并拉起对应落地页。

import { insightIntent, InsightIntentExecutor } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';
/*** 意图调用样例 */
export default class InsightIntentExecutorImpl extends InsightIntentExecutor {private static readonly JUMP_FUCTION_PAGE = 'JumpFunctionPage';/*** override 执行前台UIAbility意图** @param name 意图名称* @param param 意图参数* @param pageLoader 窗口* @returns 意图调用结果*/onExecuteInUIAbilityForegroundMode(name: string, param: Record<string, Object>, pageLoader: window.WindowStage):Promise<insightIntent.ExecuteResult> {// 根据意图名称分发处理逻辑。接入方可根据实际业务实现页面跳转switch (name) {case InsightIntentExecutorImpl.JUMP_FUNCTION_PAGE:return this.jumpFunctionPage(param, pageLoader);default:break;}return Promise.resolve({code: -1,result: {message: 'unknown intent'}} as insightIntent.ExecuteResult)}/*** 实现跳转目标页面的功能** @param param 意图参数* @param pageLoader 窗口*/private jumpFunctionPage(param: Record<string, Object>, pageLoader: window.WindowStage): Promise<insightIntent.ExecuteResult> {return new Promise((resolve, reject) => {let pageId: string = param?.pageId as string;pageLoader.loadContent('pages/'+ pageId).then(() => {resolve({code: 0,result: {message: 'Intent execute success'}});}).catch((err: BusinessError) => {// TODO 调用失败的情况resolve({code: -1,result: {message: 'Intent execute failed'}})});})}
}

功能搜索方案概述

开发者将应用内的功能在意图声明文件中声明接入，并实现对应的意图调用，即可实现用户在小艺搜索入口直接搜索到应用内功能，点击后可直接拉起应用，直达功能页面。

意图注册

开发者需要编辑对应的意图配置insight_intent.json文件实现意图注册。insight_intent.json文件需要放置在module下面的指定目
录：/src/main/resources/base/profile/insight_intent.json，并且整个工程中只能存在一个insight_intent.json文件。

{"insightIntents": [{"intentName": "JumpFunctionPage",    // 功能搜意图"domain": "ToolsDomain","intentVersion": "1.0.1", // 意图本身的版本号// 意图调用逻辑入口"srcEntry": "./ets/entryability/InsightIntentExecutorImpl.ets","uiAbility": {
// 意图所在module、ability，以及代码相对路径入口"ability": "EntryAbility",// UIAbility仅支持前台执行模式"executeMode": ["foreground"]},"inputParams": [{ // 部分意图开放意图参数定义，格式整体参考JSON-Schema。 "properties": { // 描述参数列表，后续可以同级别增加其他描述节点"pageId": { // 具体功能的标识的key值"type": "string", // 参数类型"enum": [ {"value": "1", // 具体功能的标识的value值"displayName": "查找路线", // 功能名，小艺搜索展示"keywords": ["查路线"], // 参数枚举值别名，可以用于索引、过滤"displayDescription": "查找到达目的的路线", // 功能描述，小艺搜索展示"icon": "https://abc.xx" // 功能图标，小艺搜索展示},{"value": "2", // 具体功能的标识的value值"displayName": "扫一扫", // 功能名，小艺搜索展示"keywords": ["扫码"], // 参数枚举值别名，可以用于索引、过滤"displayDescription": "用于扫码", // 功能描述，小艺搜索展示"icon": "https://abc.xx" // 功能图标，小艺搜索展示}]}}}]}]
}

端侧前台意图调用

开发者需自己实现InsightIntentExecutor，并在对应回调实现打开落地页的能力。步骤如下：

1）继承InsightIntentExecutor；

2）重写对应方法，例如目标拉起前台页面，则可重写onExecuteInUIAbilityForegroundMode方法；

3）通过意图名称，识别跳转功能页面意图(JumpFuctionPage)，在对应的方法中传递意图参数（param），并拉起对应落地页。

import { insightIntent, InsightIntentExecutor } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';
/*** 意图调用样例 */
export default class InsightIntentExecutorImpl extends InsightIntentExecutor {private static readonly JUMP_FUCTION_PAGE = 'JumpFuctionPage';/*** override 执行前台UIAbility意图** @param intent name 意图名称* @param param 意图参数* @param pageLoader 窗口* @returns 意图调用结果*/onExecuteInUIAbilityForegroundMode(name: string, param: Record<string, Object>, pageLoader: window.WindowStage):Promise<insightIntent.ExecuteResult> {// 根据意图名称分发处理逻辑。接入方可根据实际业务实现页面跳转switch (name) {case InsightIntentExecutorImpl.JUMP_FUCTION_PAGE:return this.jumpFuctionPage(param, pageLoader);default:break;}return Promise.resolve({code: -1,result: {message: 'unknown intent'}} as insightIntent.ExecuteResult)}/*** 实现跳转目标页面的功能** @param param 意图参数* @param pageLoader 窗口*/private jumpFuctionPage(param: Record<string, Object>, pageLoader: window.WindowStage): Promise<insightIntent.ExecuteResult> {return new Promise((resolve, reject) => {let pageId: string = param?.pageId as string;pageLoader.loadContent('pages/'+ pageId).then(() => {resolve({code: 0,result: {message: 'Intent execute success'}});}).catch((err: BusinessError) => {// TODO 调用失败的情况resolve({code: -1,result: {message: 'Intent execute failed'}})});})}

了解更多详情>>

访问意图框架服务联盟官网

获取功能一步达开发指导文档

获取功能搜索开发指导文档