這次要完成的流程
- 客戶提供商品編號,例如
1。 lookup_product工具向商品系統送出GET /products/1。- AI 取得商品名稱、價格與庫存,回答客戶的問題。
1. 建立共用連線
在「共用連線」點「新增連線」,填入以下內容並儲存。
連線負責 API 網址與認證。自己的系統若需要金鑰,依對方文件選擇「Bearer token」或「自訂認證 Header」,再填入憑證。
2. 定義查詢工具
點「新增查詢工具」,在「基本設定」完成以下設定。- 工具名稱:
lookup_product - 使用連線:剛建立的「商品 API」
- 使用範圍:選擇要處理商品問題的助理
- 啟用工具:開啟
3. 把商品編號帶入查詢
切到「查詢參數」,將「查詢路徑」設為/products/{product_id},再新增一個參數。
大括號內的名稱必須和參數名稱一致。客戶提供編號
1 時,查詢路徑就會變成 /products/1。
4. 選擇交給 AI 的欄位
在「回傳資料」新增以下三個欄位,並將三者設為必填。
左欄要和 API 實際回傳的 JSON 結構一致;右欄是回答規則中可引用的名稱。例如自己的 API 將名稱放在
data.title,左欄就填 data.title。
5. 設定回答方式
在「AI 如何使用查詢結果」填入服務規則,再按「儲存設定」。6. 執行一筆測試
切到「測試與預覽」,在「測試輸入(JSON)」填入:99,助理可回答「這項商品目前還有 99 件」。接著在助理的對話測試中確認:缺少編號時會先詢問,取得編號後會呼叫工具並依查詢結果回答。
換成自己的商品系統
向 API 串接人員取得基底網址、認證方式、查詢路徑與回傳 JSON 範例。通用查詢工具目前使用 HTTPS GET;將上述連線、參數與欄位替換後,重新測試一筆商品即可。
第一次設定助理,可先看建立外撥 AI 代理教學;線路與可用性條件請參考 AI 語音代理。