釘釘機器人集成智能對話機器人大模型問答。

效果展示

概覽

1. 調用ApplyForStreamAccessToken接口。參考文檔：ApplyForStreamAccessToken - 獲取流式調用的連接信息

2. ApplyForStreamAccessToken接口，返回的連接簽名信息有效期2小時，必須在到期前重新獲取

3. 監聽并接收釘釘機器人的消息（用戶問機器人的消息）：機器人接收消息

4. 發送AI卡片消息：創建并投放卡片

5. 計算會話接口簽名。會話接口簽名

6. SSE流式調用會話接口，監聽SSE事件，獲取大模型流式輸出。參考文檔：流式會話接口

7. 大模型流式接口會多次返回，每次返回都是全量的回復，渲染端應該考慮用新的覆蓋舊的。響應參數參考：3 響應參數說明

8. 更新AI卡片：AI卡片流式更新

示例

示例工程代碼

dingtalk-example.zip

如何運行

1. 本示例工程的運行環境要求為JDK 8，參考文檔：在Windows安裝JDK

2. 根據智能對話機器人配置操作完成后，獲取示例工程中的參數中智能對話機器人部分的參數

3. 根據釘釘應用和機器人配置操作完成后，獲取示例工程中的參數中釘釘內部應用的參數

4. 將上面提到的參數填寫到示例工程中的com.aliyun.chatbot.channel.DingtalkRobotChatApp類的對應參數上

5. 運行com.aliyun.chatbot.channel.DingtalkRobotChatApp這個類的主方法

6. 打開釘釘，通過機器人名稱搜索并打開對應的機器人，即可進行問答。或者把機器人添加到企業內部群中，@機器人進行提問

示例工程中的參數

智能對話機器人配置

1. 進入智能對話機器人控制臺，https://chatbot.console.aliyun.com

2. 機器人創建，獲取機器人id，發布機器人（如無發布按鈕則跳過）

   

3. 獲取業務空間AgentKey，地址：業務空間管理

   

4. 阿里云賬號AKSK獲取，地址：AccessKey

釘釘應用和機器人配置

1. 開發流程概述

2. 創建應用

3. 機器人配置，填寫機器人名稱等必填項后，配置消息接收模式為 Stream 模式

   

4. 為應用申請釘釘開放接口權限，在開發配置>權限管理菜單中需要申請三個權限

   1. 企業內機器人發送消息權限

   2. 互動卡片實例寫權限

   3. AI卡片流式更新權限

5. 在基礎信息>憑證與基礎信息菜單中獲取應用的 Client ID 和 Client Secert

6. 發布機器人后再發布釘釘應用

7. 搭建卡片模板，獲取卡片模板id

FAQ

1. 發問題給機器人后，機器人無回復

   1. 檢查權限是否配置完全。請參考為應用申請釘釘開放接口權限，在開發配置>權限管理菜單中需要申請三個權限

   2. 創建AI卡片后，請確保卡片已保存并發布。

      

2. 機器人無法搜索到，請確認機器人已發布，且所在應用也已發布并可見性配置正確