購買與技術評估

Agent API 串接說明

了解金鑰、Agent ID 與知識範圍的關係，查看列出可用模型及指定助理的去敏請求範例與驗收清單。

金鑰辨認你是誰；請求指定哪一位助理。

API Key：身份與允許操作

使用核發給整合帳號的金鑰，不放前端、影片、Git 或公開文件。有效金鑰不代表能看到所有模型與知識。

Agent ID：這次交給誰

從該帳號可見清單取得完整 ID，放入請求的 model；不要用顯示名稱或猜測供應商模型 ID。

知識：跟隨助理設定與權限

兩位助理引用不同資料時，分別呼叫各自 ID。同一把金鑰不會自行猜測這次要哪個知識庫。

1. 列出這把金鑰能用的模型與助理。

以下是 Bash / WSL 範例。WEBUI_URL 設為管理員核定的 HTTPS 站台根網址；WEBUI_API_KEY 由安全的環境變數或秘密管理服務注入。本頁沒有真實金鑰。

curl --fail-with-body "$WEBUI_URL/api/models" \
  -H "Authorization: Bearer $WEBUI_API_KEY"

清單在回應的 data 陣列；保留項目的 id 供下一步使用。看得到不等於模型一定可用，仍須驗證底層連線、額度與助理設定。

2. 用指定助理回答一個測試問題。

curl --fail-with-body "$WEBUI_URL/api/chat/completions" \
  -H "Authorization: Bearer $WEBUI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "REPLACE_WITH_AUTHORIZED_AGENT_ID",
    "messages": [{"role": "user", "content": "請依示範 FAQ 說明產品用途；沒有依據請說明。"}],
    "stream": false
  }'

請先將 REPLACE_WITH_AUTHORIZED_AGENT_ID 換成上一步核定的助理 ID。回覆內容與用量欄位依模型及正式版本而異，不能把示例當固定回應格式或費率。

本地客製版外部金鑰只開放列模型與對話範圍（models:read／chat:write）。不開放任意上傳檔案、讀取知識庫清單或在請求附加 files、工具與工作流等瀏覽器欄位。知識需事先綁定至獲授權的助理；不可直接照搬上游的所有 API 範例。

3. 用兩位示範助理檢查範圍。

只用虛構、非機密資料，建立 A、B 各自不同的 FAQ 與識別答案。
以整合帳號列清單，確認只出現獲授權的項目。
分別指定 A、B ID；問相同問題，核對各自資料及回答依據。
詢問另一組的專屬資料、使用未授權 ID、撤銷金鑰後重試，確認拒絕或沒有越權資料。
另對照實際模型路由與用量紀錄，驗證是否走核定供應商；不能只看回答自稱使用哪個模型。

此為驗收任務，不是已完成的測試結果。對話呼叫可能消耗模型與企業額度；正式執行前須授權。

失敗時，記錄狀態，不要反覆盲打。

401：檢查金鑰是否有效或已撤銷；不要把完整金鑰貼進工單。
403：核對帳號、金鑰 scope、站台端點限制與模型授權。
找不到模型：重新取得授權清單；底層模型、助理設定與正式版本也要核對，不假定固定 HTTP 狀態。
額度不足、429 或供應商錯誤：保留去敏的狀態與錯誤內容，依正式環境的限流／額度規則處理。未核定每秒配額與重試策略前，不承諾固定數值。
逾時：設定客戶端逾時並停止無上限重試；帶工具的任務須另外確認副作用與重複執行風險。

上游參考，不等於本站開放範圍。

Open WebUI 官方端點文件可用於理解協定；本站採客製權限，正式可用介面與版本須以核定文件為準。