10分鐘在釘釘上增加一個(gè)AI機(jī)器人
在阿里云上，您只需 10 分鐘，無(wú)需任何編碼，即可為您的組織在釘釘平臺(tái)上創(chuàng)建一個(gè)有大模型能力加成的 AI 機(jī)器人。這個(gè)機(jī)器人可以全天候（7x24）響應(yīng)用戶(hù)咨詢(xún)，還能解答私域問(wèn)題，成為您業(yè)務(wù)的專(zhuān)屬機(jī)器人，提升用戶(hù)體驗(yàn)，增強(qiáng)業(yè)務(wù)競(jìng)爭(zhēng)力。
方案概覽
在釘釘中添加一個(gè) AI 機(jī)器人，只需幾步：
|
|
1. 創(chuàng)建大模型問(wèn)答應(yīng)用
首先我們可以通過(guò)創(chuàng)建一個(gè)百煉應(yīng)用，來(lái)獲取大模型的推理 API 服務(wù)，用于實(shí)現(xiàn) AI 助手。
百煉提供的新用戶(hù)免費(fèi)額度可以完全覆蓋本教程所需資源消耗。額度消耗完后按 token 計(jì)費(fèi)，相比自行部署大模型可以顯著降低初期投入成本。
1.1 創(chuàng)建應(yīng)用
進(jìn)入百煉控制臺(tái)的我的應(yīng)用，在頁(yè)面右側(cè)點(diǎn)擊新增應(yīng)用。在對(duì)話(huà)框，選擇智能體應(yīng)用并創(chuàng)建。
在應(yīng)用設(shè)置頁(yè)面，模型選擇通義千問(wèn)-Plus，其他參數(shù)保持默認(rèn)。
您也可以選擇輸入一些 Prompt，比如設(shè)置一些人設(shè)以引導(dǎo)大模型更好的應(yīng)對(duì)客戶(hù)咨詢(xún)。
你叫小助，可以幫助用戶(hù)解答產(chǎn)品選購(gòu)、使用等方面的問(wèn)題。
在頁(yè)面右側(cè)可以提問(wèn)驗(yàn)證模型效果。不過(guò)您會(huì)發(fā)現(xiàn)，目前它還無(wú)法準(zhǔn)確回答你們公司的商品信息。點(diǎn)擊右上角的發(fā)布，我們將在后面的步驟中去解決這一問(wèn)題。
1.2 獲取調(diào)用 API 所需的憑證
為了在后續(xù)通過(guò) API 調(diào)用大模型應(yīng)用的能力，我們需要獲取一個(gè)百煉應(yīng)用的 API-KEY 和應(yīng)用 ID：
在應(yīng)用列表中可以查看所有百煉應(yīng)用 ID。保存應(yīng)用 ID 到本地用于后續(xù)配置。
在頂部導(dǎo)航欄右側(cè)，點(diǎn)擊人型圖標(biāo)，點(diǎn)擊API-KEY進(jìn)入我的API-KEY頁(yè)面。在頁(yè)面右側(cè)，點(diǎn)擊創(chuàng)建我的API-KEY，在彈出窗口中創(chuàng)建一個(gè)新 API-KEY。保存 API-KEY 到本地用于后續(xù)配置。
2 創(chuàng)建釘釘應(yīng)用
接下來(lái)您需要在您的組織中創(chuàng)建釘釘應(yīng)用，作為 AI 助手回答用戶(hù)問(wèn)題。
創(chuàng)建釘釘應(yīng)用需要您的釘釘賬號(hào)有開(kāi)發(fā)者權(quán)限。您可以聯(lián)系您的組織管理員獲取釘釘開(kāi)放平臺(tái)的開(kāi)發(fā)權(quán)限，具體操作請(qǐng)參見(jiàn)成為釘釘開(kāi)發(fā)者。
2.1 創(chuàng)建應(yīng)用
訪(fǎng)問(wèn)釘釘開(kāi)放平臺(tái)，點(diǎn)擊創(chuàng)建。如果創(chuàng)建過(guò)應(yīng)用未展示應(yīng)用開(kāi)發(fā)指引，點(diǎn)擊立即開(kāi)始進(jìn)入釘釘應(yīng)用頁(yè)面。
在應(yīng)用開(kāi)發(fā)的左側(cè)導(dǎo)航欄中，點(diǎn)擊釘釘應(yīng)用，在釘釘應(yīng)用頁(yè)面右上角點(diǎn)擊創(chuàng)建應(yīng)用。
在創(chuàng)建應(yīng)用面板，填寫(xiě)應(yīng)用名稱(chēng)和應(yīng)用描述，上傳應(yīng)用圖標(biāo)，完成后點(diǎn)擊保存。
2.2 查看應(yīng)用 Client ID 和 Client Secret
在左側(cè)菜單選擇憑證與基礎(chǔ)信息，復(fù)制 Client ID 和 Client Secret，用于下一步創(chuàng)建連接流。
2.3 創(chuàng)建消息卡片
釘釘機(jī)器人通過(guò)卡片消息支持流式返回結(jié)果，您需要?jiǎng)?chuàng)建卡片模板供消息發(fā)送使用。
訪(fǎng)問(wèn)卡片平臺(tái)，點(diǎn)擊新建模板。
在創(chuàng)建模板輸入框，填入模板信息。
在模擬編輯頁(yè)面，保存并發(fā)布模板。然后點(diǎn)擊返回模板列表頁(yè)面。
復(fù)制模板ID，用于創(chuàng)建釘釘連接流使用。
2.4 授予應(yīng)用發(fā)送卡片消息權(quán)限
創(chuàng)建卡片后，您需要給應(yīng)用授予發(fā)送卡片消息的權(quán)限。
訪(fǎng)問(wèn)釘釘應(yīng)用列表。找到剛剛創(chuàng)建的應(yīng)用，點(diǎn)擊應(yīng)用名稱(chēng)進(jìn)入詳情頁(yè)面。
在左側(cè)菜單選擇，在左側(cè)搜索框分別輸入
Card.Streaming.Write和Card.Instance.Write，并在操作列點(diǎn)擊申請(qǐng)權(quán)限。
3. 創(chuàng)建釘釘連接流
AppFlow 可以讓您在不寫(xiě)代碼的情況下，通過(guò)界面配置就可以將大模型應(yīng)用和釘釘連接起來(lái)。您可以通過(guò)預(yù)置的 AppFlow 模板創(chuàng)建一個(gè)釘釘機(jī)器人連接流。
使用AppFlow模板創(chuàng)建連接流，點(diǎn)擊立即使用進(jìn)入創(chuàng)建流程。
在連接流的賬戶(hù)授權(quán)配置向?qū)ы?yè)，點(diǎn)擊前往授權(quán)。在創(chuàng)建憑證對(duì)話(huà)框中，填入之前獲取的釘釘應(yīng)用的 Client ID 和 Client Secret，并設(shè)置一個(gè)自定義憑證名稱(chēng)。
在連接流的賬戶(hù)授權(quán)配置向?qū)ы?yè)，點(diǎn)擊前往授權(quán)。在創(chuàng)建憑證對(duì)話(huà)框中，填入之前獲取的 API-KEY，并設(shè)置一個(gè)自定義憑證名稱(chēng)。
在執(zhí)行動(dòng)作配置向?qū)ы?yè)，填寫(xiě)應(yīng)用Id和模版ID，完成后點(diǎn)擊下一步。
在基本信息配置向?qū)ы?yè)，填寫(xiě)連接流名稱(chēng)和連接流描述（建議保持默認(rèn)），完成后點(diǎn)擊下一步。
界面提示流程配置成功，復(fù)制 WebhookUrl，點(diǎn)擊發(fā)布。
4. 配置釘釘機(jī)器人
有了webhook地址后，接下來(lái)您可以在釘釘應(yīng)用中配置機(jī)器人來(lái)回答用戶(hù)問(wèn)題了。
4.1 配置釘釘機(jī)器人
訪(fǎng)問(wèn)釘釘應(yīng)用列表。找到剛剛創(chuàng)建的應(yīng)用，點(diǎn)擊應(yīng)用名稱(chēng)進(jìn)入詳情頁(yè)面。
在添加應(yīng)用能力頁(yè)面，找到機(jī)器人卡片，點(diǎn)擊添加。
在機(jī)器人配置頁(yè)面，打開(kāi)機(jī)器人配置開(kāi)關(guān)，您可以參考下圖完成配置。消息接收模式請(qǐng)選擇HTTP模式，消息接收地址為剛剛的 WebhookUrl。然后點(diǎn)擊發(fā)布。
重要消息接收模式請(qǐng)選擇HTTP模式，目前AppFlow僅支持HTTP模式，選擇Stream模式會(huì)導(dǎo)致無(wú)法返回消息。
4.2 發(fā)布應(yīng)用版本
應(yīng)用創(chuàng)建完成后，如果需要將應(yīng)用供企業(yè)內(nèi)其他用戶(hù)使用，需要發(fā)布一個(gè)版本。
點(diǎn)擊應(yīng)用開(kāi)發(fā)，在釘釘應(yīng)用頁(yè)面，點(diǎn)擊目標(biāo)應(yīng)用（百煉手機(jī)答疑）。
在目標(biāo)應(yīng)用開(kāi)發(fā)導(dǎo)航欄，點(diǎn)擊版本管理與發(fā)布，在版本管理與發(fā)布頁(yè)面，點(diǎn)擊創(chuàng)建新版本。進(jìn)入版本詳情頁(yè)面，輸入應(yīng)用版本號(hào)和版本描述信息，選擇合適的應(yīng)用可見(jiàn)范圍，完成后點(diǎn)擊保存。并在彈窗中點(diǎn)擊直接發(fā)布。
4.3 測(cè)試機(jī)器人
你可以創(chuàng)建群聊或在已有群聊中添加機(jī)器人，并與機(jī)器人對(duì)話(huà)，查看效果。
在釘釘群管理中添加機(jī)器人?。進(jìn)入釘釘群群設(shè)置頁(yè)面，點(diǎn)擊機(jī)器人卡片區(qū)域，在機(jī)器人管理頁(yè)面，點(diǎn)擊添加機(jī)器人。在添加機(jī)器人的搜索文本框中輸入目標(biāo)機(jī)器人名稱(chēng)，并選中要添加的機(jī)器人。點(diǎn)擊添加，完成后再點(diǎn)擊完成添加。
在釘釘群中@機(jī)器人，進(jìn)行交流互動(dòng)。
5. 為大模型問(wèn)答應(yīng)用增加私有知識(shí)
5.1 配置知識(shí)庫(kù)
接下來(lái)，我們可以嘗試讓大模型在面對(duì)客戶(hù)問(wèn)題時(shí)參考這份文檔，以產(chǎn)出一個(gè)更準(zhǔn)確的回答和建議。
假設(shè)您在一家售賣(mài)智能手機(jī)的公司工作。您的釘釘用戶(hù)群上會(huì)有很多涉及智能手機(jī)相關(guān)的問(wèn)題，如支持雙卡雙待、屏幕、電池容量、內(nèi)存等信息。不同機(jī)型的詳細(xì)配置清單參考：百煉系列手機(jī)產(chǎn)品介紹.docx。
上傳文件：在百煉控制臺(tái)的數(shù)據(jù)管理中點(diǎn)擊導(dǎo)入數(shù)據(jù)，根據(jù)引導(dǎo)上傳我們虛構(gòu)的百煉系列手機(jī)產(chǎn)品介紹：
根據(jù)您上傳的文檔大小，百煉需要一定時(shí)間解析，通常占用1~6分鐘，請(qǐng)您耐心等待。
建立索引：進(jìn)入知識(shí)索引，根據(jù)引導(dǎo)創(chuàng)建一個(gè)新的知識(shí)庫(kù)，并選擇剛才上傳的文件，其他參數(shù)保持默認(rèn)即可。知識(shí)庫(kù)將為上一步驟中準(zhǔn)備的文檔建立索引，以便后續(xù)大模型回答時(shí)檢索參考。
選擇向量存儲(chǔ)類(lèi)型時(shí)，如果您希望集中存儲(chǔ)、靈活管理多個(gè)應(yīng)用的向量數(shù)據(jù)，可選擇ADB-PG。
引用知識(shí)：完成知識(shí)庫(kù)的創(chuàng)建后，可以返回我的應(yīng)用進(jìn)入到剛才創(chuàng)建的應(yīng)用設(shè)置界面，打開(kāi)知識(shí)檢索增強(qiáng)開(kāi)關(guān)、選擇知識(shí)庫(kù)，測(cè)試驗(yàn)證符合預(yù)期后點(diǎn)擊發(fā)布。Prompt 中會(huì)被自動(dòng)添加一段信息，以便大模型在后續(xù)回答時(shí)參考檢索出來(lái)的信息。
5.2 檢驗(yàn)效果
有了參考知識(shí)，AI 機(jī)器人就能準(zhǔn)確回答您關(guān)于百煉手機(jī)的問(wèn)題了。
總結(jié)
通過(guò)前面的學(xué)習(xí)，您已經(jīng)能搭建一個(gè)大模型 RAG 應(yīng)用，并且將其以 AI 機(jī)器人的形式添加到釘釘群中來(lái)應(yīng)對(duì)客戶(hù)咨詢(xún)，過(guò)程僅需 0 元（免費(fèi)試用額度內(nèi)）10分鐘。
應(yīng)用評(píng)測(cè)
建議您在正式上線(xiàn) AI 機(jī)器人前，組織業(yè)務(wù)人員一起參與應(yīng)用評(píng)測(cè)，確保大模型應(yīng)用的回答效果符合預(yù)期。如果不符合預(yù)期，可以通過(guò)優(yōu)化提示詞、完善補(bǔ)充私有知識(shí)、調(diào)整文檔切分策略等方法來(lái)改進(jìn)回答效果。
持續(xù)改進(jìn)
大模型課程
系統(tǒng)體驗(yàn)的改進(jìn)優(yōu)化永遠(yuǎn)沒(méi)有終點(diǎn)，您可以考慮學(xué)習(xí)并通過(guò)阿里云大模型ACA認(rèn)證，該認(rèn)證配套的免費(fèi)課程能幫助您進(jìn)一步了解大模型的能力和應(yīng)用場(chǎng)景，以及如何優(yōu)化通過(guò)大模型的應(yīng)用效果。
常見(jiàn)問(wèn)題
記錄 AI 助理對(duì)話(huà)日志
如果您想要記錄 AI 助理對(duì)話(huà)日志并進(jìn)行分析，您可以參考如下內(nèi)容在 Appflow 中添加日志節(jié)點(diǎn)，將對(duì)話(huà)內(nèi)容記錄在阿里云日志服務(wù)中。
訪(fǎng)問(wèn)AppFlow控制臺(tái)，在表格操作列點(diǎn)擊詳情，在詳情頁(yè)面右上角點(diǎn)擊創(chuàng)建新版本。
在編輯頁(yè)面阿里云百煉步驟之后，點(diǎn)擊+添加新的步驟。行業(yè)類(lèi)型選擇阿里云，公共連接器選擇SLS日志云服務(wù)。
選擇執(zhí)行動(dòng)作寫(xiě)入日志，點(diǎn)擊保存，進(jìn)入下一步。
點(diǎn)擊添加新憑證。在創(chuàng)建憑證對(duì)話(huà)框，根據(jù)表單填入信息，完成角色創(chuàng)建和授權(quán)。創(chuàng)建完成后，選擇憑證，并點(diǎn)擊保存，進(jìn)入下一步。
選擇地域、Project 和 Logstore。填入所需的日志信息，左側(cè)輸入框是日志Key，直接輸入，右側(cè)是日志Value，通過(guò)插入變量獲取上下文中信息。
如果您已經(jīng)創(chuàng)建過(guò)用于存儲(chǔ) AI 助手日志的阿里云日志服務(wù)的Project和Logstore，則可以直接使用，如果沒(méi)有創(chuàng)建過(guò)，可以參考創(chuàng)建Project和Logstore創(chuàng)建。創(chuàng)建完成后無(wú)需接入日志，進(jìn)入Logstore詳情頁(yè)面，在頁(yè)面右上角點(diǎn)擊開(kāi)啟索引，使用默認(rèn)的全文索引即可。開(kāi)啟索引后才可以在日志服務(wù)進(jìn)行在線(xiàn)日志查詢(xún)和分析。
選擇地域、Project 和 Logstore。填入所需的日志信息，左側(cè)輸入框是日志Key，直接輸入，右側(cè)是日志Value，通過(guò)插入變量獲取上下文中信息。
保存并發(fā)布連接流版本。
進(jìn)行對(duì)話(huà)測(cè)試，并查看日志。
