本文將介紹使用開放平台實現智能體相關能力集成的大致流程,各開放能力間可能有些許差異,請以具體的接口文檔為準。
流程概覽
操作步驟
步驟一:
創建及發佈應用在開放平台,智能體應用是除模型效果盲測能力外,各項能力的必要載體,在使用 API 或 SDK 進行能力集成前,請先完成智能體應用的創建以及發佈,並獲取對應應用 ID。
1、創建應用
2、發佈應用
發佈應用並開啓 SDK 授權:完成應用發佈,並在發佈過程中,開啓 SDK 服務下,目標能力的授權。
其中:WebSDK:開啓後才可使用百寶箱的 WebSDK 服務將智能體集成至網頁端。
智能體 SDK:除 WebSDK 外,其他開放能力(包括 API 及 SDK)均需開啓該授權。
IOT 設備:開啓後,可通過 IOT 設備實現智能體與硬件設備的集成,從而為硬件添加對話能力。
2、獲取應用 ID:在發佈應用頁面的應用狀態欄可快速獲取當前應用的 AppID。
步驟二:獲取授權令牌
在開放平台,授權令牌(token)是用於驗證開放身份的憑證,需要您在調用開放能力時,在請求參數中進行配置。為保證您的數據安全,請妥善保管您的令牌信息。
步驟三:調用開放能力
開放平台通過 API 接口與 SDK 的開放,支持智能體調用、模型效果盲測以及 WebSDK 等場景,簡單幾步即可完成服務的集成。在進行接口調用前,請點擊下方附錄中的鏈接,快速閲讀對應的説明文檔,以保證調用流程的順暢與準確。
附錄:開放能力速覽
API 列表
| 功能模塊 | 能力名稱 | 説明 |
| 智能體調用 | 使用對話型智能體
POST https://api.tbox.cn/api/chat |
通過調用本接口,可以向指定智能體發起對話,支持在對話時添加上下文消息,便於智能體做出合理的回覆。 |
| 智能體調用 | 使用生成型智能體
POST https://api.tbox.cn/api/completion |
通過調用本接口,可以在自有系統中使用生成型智能體,例如生成古詩、文章以及圖片等內容。 |
| 智能體調用 | 文件上傳
POST https://api.tbox.cn/api/file/upload |
通過調用本接口,可以實現文件上傳功能,上傳後的文件可以用於創建知識庫或作為多模態數據輸入給應用。 |
| 智能體調用 | 文件查詢
GET https://api.tbox.cn/api/file/retrieve?fileId={fileId} |
調用本接口,開發者可以查詢通過文件上傳接口上傳的文件詳情信息。 |
| 智能體調用 | 發起會話
POST https://api.tbox.cn/api/conversation/create |
通過調用本接口,開發者可以發起一個新的會話行為。 |
| 智能體調用 | 查詢會話列表
GET https://api.tbox.cn/api/conversation/conversations |
通過調用本接口,開發者可以查詢由開放平台 API 或 SDK 發起的智能體會話列表。 |
| 智能體調用 | 查詢消息列表
GET https://api.tbox.cn/api/conversation/messages |
通過調用本接口,開發者可以查詢由開放平台 API 或 SDK 發起的,指定會話過程中的消息列表。 |
| 模型效果測評 | 獲取模型測評結果
● POST https://api.tbox.cn/api/model/responses
● POST https://api.tbox.cn/api/model/completions |
通過調用模型效果盲測接口,開發者可以實現一次調用過程中,使用多種不同的模型進行內容生成。適用於在實際業務場景下,做用户對不同模型底座的智能體的喜好對比。 |
| 模型效果測評 | 盲測效果反饋
POST https://api.tbox.cn/model/api/feedback |
通過調用本接口,可以將模型效果盲測的結果反饋給百寶箱。百寶箱會將收集到的反饋數據進行計分排行,用於展示在不同業務場景下,底層模型適配排行。 |
SDK 能力
Java SDK。
Python SDK。
Node.js SDK
Web SDK。