新四季網

天貓精靈操作法(十分鐘用FAAS給你的天貓精靈增加自定義功能)

2023-05-22 04:11:56 1

背景

雖然天貓精靈目前功能已很豐富,但還有些定製化高的服務無法滿足,比如查詢學校課表,考研信息,公交狀態,特定網站狀態等。不過天貓精靈提供了開放平臺能力,使得我們可以輕鬆給天貓精靈添加這些自定義能力。本文做個簡單示例,和天貓精靈說小愛同學,天貓精靈回復"小愛同學,我是天貓精靈" 來展示一下如何通過天貓精靈調用我們的自定義服務。查閱文檔,可知要實現這個功能,關鍵有兩步,一是讓天貓精靈識別,二是搭建自定義服務進行回復

實現

註冊技能

天貓精靈接入還是比較簡單的,註冊完成開發者後,就直接在平臺添加自定義技能就可以了。open.aligenie.com/console

1. 添加自定義技能『小愛同學』

2. 在側邊欄"意圖" tab 中添加意圖

因為我們只做一個簡單的呼喚,所以就用個簡單的默認意圖就好了,注意默認意圖並不是兜底意圖,而是當只說 調用詞 時觸發的意圖如果有多種功能,可以使用例句來教會天貓精靈怎麼區分不同意圖,文檔連結

3. 在側邊欄"回復邏輯"中配置回調

可以看到此處需要填寫 webhook url,也就是我們實際自定義服務的地址.目前還沒搭建,下面我們將用 faas 搭建需要注意的是這邊有個校驗文件,開放平臺為了驗證服務的有權性,會要檢驗服務根目錄下有沒有這個文件。我們先把文件下載下來,後續使用 文檔連結

服務搭建

服務搭建的方式有很多,此處我們選擇採用 aliyun 的 faas 服務, 也就是函數計算進行搭建。函數計算有個好處在於不用關心真實伺服器,只需要編寫自定義邏輯即可。而且關鍵每月還有100萬次的免費調用額度,約等於不要錢 . fc.console.aliyun.com函數計算為三層結構 1個服務 -> n個函數-> m個觸發器。每個服務可以有多個函數;每個函數為一個工程,裡面有一個入口函數;然後由觸發器去調用這個函數, 常用的有 http 觸發器,定時觸發器等可見我們需要的就是創建一個服務,然後兩個函數,一個用於應答天貓精靈,一個用於天貓精靈的驗權。新建一個服務,名字隨意新建兩個函數,分別叫 xiaoai 和 auth ,對應的觸發器名字分別為 xiaoai_http, auth_http,用於應答和校驗

應答服務

應答服務很簡單,就是返回 "小愛同學,我是天貓精靈"因此我們只需要收到請求直接返回就好,代碼如下, 複製到代碼執行的在線編輯器中,點擊保存即可

var getjsonBody = require('div/json');exports.handler = (req, resp, context) => { getJsonBody(req, function (err, data) { if (!data || !data.utterance) { resp.send("post div wrong! " data); } resp.setStatusCode(200); resp.setHeader('content-type', 'application/json'); resp.send(JSON.stringify( { "returnCode": "0", "returnErrorSolution": "", "returnMessage": "", "returnValue": { "reply": `小愛同學,我是天貓精靈`, "resultType": "RESULT", "executeCode": "SUCCESS", "msgInfo": "" } })); });}

在下方的測試中,便可以輸入上面的 div,測試一下結果至此,應答服務完成

校驗服務

校驗服務就更簡單了,就是模仿一個文件讀取,返回文件內容即可.因此打開上面下載的校驗文件,將文件內容替換到下面的 xxx 中, 粘貼到代碼執行的編輯框中,點擊保存即可。

exports.handler = (req, resp, context) => { resp.setHeader('content-type', 'text/plain'); resp.send("xxx")}

在下方的測試驗證處直接 get 便可看到返回 div 即為上面的 xxx

路徑註冊

完成了上面兩個服務後,雖然可以直接用各個函數的觸發器對應的網址直接訪問,但是由於驗權文件必須要在根目錄的 /aligenie/ 下,因此還需通過 自定義域名 來統一域名打開自定義域名,可以看到有一個默認域名,我們就直接編輯這個域名, 添加兩個路徑,一個為 /aligenie/aaa.txt, 將 aaa 替換為上面下載的驗權文件的文件名, 一個為 /xiaoai/*

大功告成

獲得地址後,將天貓精靈 webhook 地址改成我們上面的自定義域名即可在測試驗證便可進行測試了,打開真機測試則可在 taobao 帳號綁定的天貓精靈上進行測試

Tips

本文僅演示了簡單的 faas 服務,因此採用了直接頁面編輯的方式,對於複雜的業務邏輯,比如要安裝依賴包,debug 的測試的,建議是用 aliyun 的 funcraft 提供了一種在本地可以測試服務和快速發布的方法。 不過需要注意的是其 template.yml 生成的配置一般不含日誌部分,日誌部分手工配置比較難寫,建議通過導出功能,直接導出在界面上配置好的參數對於線上運行情況可以通過 函數計算 的日誌查詢進行查看, 首次配置需要開通下 aliyun 的日誌服務。

參考資料

天貓精靈文檔函數計算,
同类文章
貓咪多久需要擠肛門腺(貓咪肛門腺到底要不要擠)

貓咪多久需要擠肛門腺(貓咪肛門腺到底要不要擠)

鏟屎官最近聞到自家的貓咪散發出一股臭味,久久揮散不去,走哪帶哪。 貓咪也開始頻繁在地上摩擦自己的屁股,這是貓咪需要擠肛門腺了嘛? 鏟屎官立刻就某度了一下,結果有人說要擠!有人說不要擠!這給人整暈乎了,到底是擠還是不擠啊! 本篇文章就幫鏟屎官們理理清楚,先出結論:不用擠!
寧波流浪狗愛心救助直播(寧波最暖心物業)

寧波流浪狗愛心救助直播(寧波最暖心物業)

救人一命 勝造七級浮屠 那救狗一命呢? 天熱了 小動物們都很愛折騰啊 論壇上剛來了一隻最不要臉的邊牧犬 現在又有了一隻錯估自己頭型 伸進欄杆卻出不來的流浪狗 …… (拍的略糊,可這小眼神看著又慘又想笑) 東論網友@quyd拍攝 終於,這副慘狀引來好心
蜘蛛俠新角色首曝(蜘蛛俠新女友黑貓)

蜘蛛俠新角色首曝(蜘蛛俠新女友黑貓)

2021年還剩下幾天就將成為過去式,而未來式的2022年也是站在了接力點前,而伴隨著2022年虎年的到來,關於漫威這段時間的很多消息傳聞也是不斷湧現出來,有關於後續的項目作品的,也有關於之前漫威項目新消息的。 所以,今天咱們就來看看,漫威這段時間都有哪些新消息曝光: 【1】8個漫威秘
狗突然的對主人叫心臟都要嚇壞了(主人以為狗狗躺在血泊中)

狗突然的對主人叫心臟都要嚇壞了(主人以為狗狗躺在血泊中)

家裡養了狗,那真就是隨時準備迎接新驚喜,尤其是柯基這種渾身上下散發著「智慧」氣質的狗狗。 這隻超可愛的柯基叫作Cartier,它的主人在泰國大城經營著一家咖啡館兒,平時它就跟主人在店裡呆著,四處遛遛什麼的。 前幾天主人像往常一樣讓Cartier出門自己上廁所然後等它回來。結果等了好久
貓超卡划算嗎(10元貓超卡又來了)

貓超卡划算嗎(10元貓超卡又來了)

前言:收到顯示器,黑色背景下全是彩色亮點,換貨; 不過27寸4K的屏幕,用電腦真的爽,比筆記本爽多了,雖然我這個筆記本是16寸的。01 10元貓超卡又來? 一、活動概覽 活動地址:https://developer.aliyun.com/adc/series/activity/serv
戰神貓熊滿級(娜貓的雙子指令形態登場)

戰神貓熊滿級(娜貓的雙子指令形態登場)

在最新的特攝雜誌上,出現了比較有趣的劇照,首先就是關於女騎假面騎士娜貓的新形態。雖然是女騎,但其實她的新形態比較少,目前一直都是在使用這個節拍形態,終於有了新的形態了。另外就是之前因為基洛利而下線的假面騎士棕熊,似乎並沒有死亡,然後再度歸來。然後就是假面騎士極狐和邪魔徒的立場了,似乎是合作了?因為
世界排名前10最聰明的狗貴賓(能記住一千多個單詞)

世界排名前10最聰明的狗貴賓(能記住一千多個單詞)

2021年5月10日,Hub City Animal Project宣布展出一座銅像,以紀念「世界上最聰明的狗狗」——Chaser。 她有多聰明呢?她在1歲時就能記住約4百個單詞,在三歲時,她的詞彙量已經超過了一千個! Chaser飼主的女兒Bianchi還說道,除了知道哪個單詞對應
淘寶目前暢銷的玩具(天貓618四大類玩具熱賣榜)

淘寶目前暢銷的玩具(天貓618四大類玩具熱賣榜)

截止6月20日23:59,天貓「618年中大促」落下帷幕。與往年鋪天蓋地的宣傳相比,今年整個活動周期都顯得有些安靜,平臺方甚至沒在活動結束第一時間發布最終成交額數據。這不免讓人忐忑:今年的行情是否很差? 從玩具業來看,不是很樂觀。中外玩具全媒體中心記者從部分廠商處獲悉,由於疫情對經濟造成的
愛養貓的女生什麼性格(養女兒如養貓)

愛養貓的女生什麼性格(養女兒如養貓)

在眾多想生兒子的家庭中,不全是因為重男輕女,而是有些夫妻感覺養女兒後經歷失望和傷心,許多方面要比養男孩更操心。 可女兒不是一直被稱為爸爸媽媽的貼心小棉襖嗎?為何會有人這樣比喻女兒呢?這不得不提有些女孩總在感情中犯傻的情況。 不久前的假期我參加了多場婚禮,現場有許多新娘新郎的長輩,在一聲聲祝
已滅絕的金剛鸚鵡(最高可賣上萬歐元)

已滅絕的金剛鸚鵡(最高可賣上萬歐元)

金剛鸚鵡原產於巴西的亞馬遜熱帶雨林地區。圖據《國家地理》網站 金剛鸚鵡是色彩豔麗的大型鸚鵡,羽毛五彩斑斕,像彩虹一樣漂亮。平均體長在90-100釐米左右。它們智商很高,模仿能力超強,平均壽命有65年之久。由於廣受喜歡,金剛鸚鵡長期以來成為不法分子走私的對象。據美國《國家地理》雜誌報導,隨