一、簡(jiǎn)介

• 隨著人機(jī)交互越來(lái)越普遍，設(shè)備需要理解用戶(hù)下達(dá)的各種指令，方便用戶(hù)的操作。
• 助手類(lèi)意圖識(shí)別能夠利用機(jī)器學(xué)習(xí)技術(shù)，對(duì)用戶(hù)發(fā)送給設(shè)備的文本消息進(jìn)行語(yǔ)義分析和意圖識(shí)別，進(jìn)而衍生出各種智能的應(yīng)用場(chǎng)景，使設(shè)備更智慧、更智能。
• 助手類(lèi)意圖識(shí)別當(dāng)前只支持中文語(yǔ)境。
• 助手類(lèi)意圖識(shí)別文本限制在 50 個(gè)字符以?xún)?nèi)，超過(guò)字?jǐn)?shù)將返回參數(shù)錯(cuò)誤。文本要求 UTF-8 格式，如果格式錯(cuò)誤不會(huì)引發(fā)報(bào)錯(cuò)，但將導(dǎo)致分析結(jié)果不正確。
• Engine 支持多用戶(hù)同時(shí)接入，但是不支持同一用戶(hù)并發(fā)調(diào)用同一特性。若同一特性被同一進(jìn)程同一時(shí)間多次調(diào)用，則返回系統(tǒng)忙錯(cuò)誤；不同進(jìn)程調(diào)用同一特性，則同一時(shí)間只能處理一個(gè)進(jìn)程業(yè)務(wù)，其他進(jìn)程進(jìn)入隊(duì)列排隊(duì)。

二、應(yīng)用場(chǎng)景

• 可以應(yīng)用于語(yǔ)音助手，通過(guò)智能對(duì)話與即時(shí)問(wèn)答的智能交互，幫助用戶(hù)快速解決問(wèn)題。比如，在駕駛時(shí)無(wú)法騰出雙手來(lái)使用手機(jī)，但可以通過(guò)語(yǔ)音助手交互來(lái)操控手機(jī)，完成機(jī)票訂購(gòu)等操作。
• 在家庭設(shè)備上可以做到聲控設(shè)備的各種操作，比如家庭智能設(shè)備的打開(kāi)和關(guān)閉等。

三、API 說(shuō)明

• 助手類(lèi)意圖識(shí)別提供了一個(gè)函數(shù)接口 getAssistantIntention()，該接口主要針對(duì)助手場(chǎng)景下的意圖識(shí)別，分析用戶(hù)的意圖。

① 主要接口

功能描述接口原型

助手類(lèi)意圖（同步接口）	ResponseResult getAssistantIntention(String requestData, int requestType)
助手類(lèi)意圖（異步接口）	ResponseResult getAssistantIntention(final String requestData, final int requestType, final OnResultListener listener)
初始化	void init(Context context, OnResultListener listener, boolean isLoadModel)
銷(xiāo)毀接口	void destroy(Context context)

② 接口輸入值說(shuō)明

• requestType 表示請(qǐng)求類(lèi)型，通過(guò) NluRequestType 類(lèi)定義了以下請(qǐng)求類(lèi)型：

類(lèi)型說(shuō)明

static int	REQUEST_TYPE_LOCAL = 0 本地請(qǐng)求

• requestData 表示輸入的文本信息，為 json 格式，如下：

參數(shù)名是否必選值類(lèi)型說(shuō)明

text	是	String	待分析的文本，格式要求為“utf-8”，文本長(zhǎng)度不超過(guò)50個(gè)字符
category	否	String	需要分析的意圖類(lèi)別，默認(rèn)分析所有類(lèi)別，多個(gè)類(lèi)別用半角逗號(hào)隔開(kāi)。例如，需要系統(tǒng)設(shè)置類(lèi)和出行類(lèi)，取值為“systemSetting,trip”
module	否	String	用來(lái)指定具體分析哪些意圖模塊，默認(rèn)分析所有模塊，多個(gè)意圖模塊用半角逗號(hào)“,”隔開(kāi)。例如分析訂火車(chē)票和訂機(jī)票意圖，取值為“bookTrainTicket,bookAirTicket”。 備注：分析時(shí)category與module取并集，如category為“systemSetting”，module為“bookTrainTicket”，將會(huì)分析系統(tǒng)設(shè)置類(lèi)的所有意圖、以及訂火車(chē)票“bookTrainTicket”意圖
callPkg	否	String	調(diào)用者名稱(chēng)
callType	否	int	調(diào)用者類(lèi)型，取值如下： 0：普通應(yīng)用（默認(rèn)） 1：快應(yīng)用
callVersion	否	String	調(diào)用者版本號(hào)
callState	否	int	調(diào)用者狀態(tài)，取值如下： -1：未知（默認(rèn)） 0：前臺(tái) 1：后臺(tái)

• category 與 module 取值說(shuō)明：

意圖類(lèi)別（category）包含意圖具體的意圖模塊（module）

trip	訂機(jī)票、訂火車(chē)票、導(dǎo)航、查詢(xún)地點(diǎn)	bookTripTicket、bookAirTicket、queryTrain、navigation、queryPosition
contact	打電話	call
systemSetting	打開(kāi)4g、關(guān)閉4g、設(shè)置4g、打開(kāi)wifi、關(guān)閉wifi等	open4G、close4G、set4G、openWlan、closeWlan

③ 接口返回值說(shuō)明

參數(shù)名子參數(shù)是否必選值類(lèi)型說(shuō)明code-是int0：成功
1：系統(tǒng)正在初始化
2：參數(shù)錯(cuò)誤
3：系統(tǒng)忙
4：系統(tǒng)異常
5：任務(wù)超時(shí)
6：其它錯(cuò)誤message-是String異常信息intentions-否JSONArray意圖列表，數(shù)組里的類(lèi)型為JSONObjectname否String意圖名attributes否JSONArray意圖對(duì)應(yīng)的屬性

四、開(kāi)發(fā)流程

• 在使用助手類(lèi)意圖識(shí)別 API 時(shí)，將實(shí)現(xiàn)助手類(lèi)意圖識(shí)別的相關(guān)的類(lèi)添加至工程：

import ohos.ai.nlu.NluRequestType;import ohos.ai.nlu.NluClient;import ohos.ai.nlu.OnResultListener;import ohos.ai.nlu.ResponseResult;

• 使用 NluClient 靜態(tài)類(lèi)進(jìn)行初始化，通過(guò)異步方式獲取服務(wù)的連接。
• • context：應(yīng)用上下文信息，應(yīng)為 ohos.aafwk.ability.Ability 或 ohos.aafwk.ability.AbilitySlice 的實(shí)例或子類(lèi)實(shí)例。
• • listener：初始化結(jié)果的回調(diào)，可以傳 null。
• • isLoadModel：是否加載模型，如果傳 true，則在初始化時(shí)加載模型；如果傳 false，則在初始化時(shí)不加載模型。

NluClient.getInstance().init(context, new OnResultListener<Integer>(){@Overridepublic void onResult(Integer result){// 初始化成功回調(diào)，在服務(wù)初始化成功調(diào)用該函數(shù)}}, true);

• 調(diào)用助手類(lèi)意圖識(shí)別接口：

/** Constructing input parameters for testing getAssistantIntention method. */String requestData = "{\"text\":\"關(guān)閉wlan\"}";/** Start analyzing intention based on assistant tool */ ResponseResult responseResult = NluClient.getInstance().getAssistantIntention(requestData, NluRequestType.REQUEST_TYPE_LOCAL);

• 或者調(diào)用助手類(lèi)意圖識(shí)別的異步接口：

NluClient.getInstance().getAssistantIntention(requestData, NluRequestType.REQUEST_TYPE_LOCAL, new OnResultListener<ResponseResult>() {@Overridepublic void onResult(ResponseResult result) {// 異步返回結(jié)果處理}});

• 解綁服務(wù)：

/** release resource*/NluClient.getInstance().destroy(context); 與50位技術(shù)專(zhuān)家面對(duì)面20年技術(shù)見(jiàn)證，附贈(zèng)技術(shù)全景圖

總結(jié)

以上是生活随笔為你收集整理的HarmonyOS之AI能力·助手类意图识别的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。