文檔導覽
DEVELOPER DOCUMENTATION

整合現有應用程式

以可替換介面層與分階段驗收降低導入風險。

整理既有依賴

網站維護中。API 服務網域規劃為 api.ubtl.net,OpenAI 相容 Base URL 預定為 https://api.ubtl.net/v1。以下設定用於預先準備,請在導入正式流量前確認實際接口與模型。

先列出現有應用程式使用的協定、訊息角色、工具格式與錯誤處理。檢查資料是否經過其他代理或日誌系統,並辨識程式中寫死的連線設定。這份清單比直接替換某個網址更能顯示實際相容性風險。

規劃環境變數 · bash
export OPENAI_BASE_URL="https://api.ubtl.net/v1"
export OPENAI_API_KEY="YOUR_UBTL_API_KEY"
export OPENAI_MODEL="YOUR_MODEL_ID"

建立可切換的邊界

把連線設定、認證與回應轉換放在介面層,不要讓各個業務畫面自行處理秘密。只有在支援確認協定與模型能力後才設定目標服務。相容性需逐項驗證,不能從 SDK 名稱推定所有模型皆可使用。

逐步導入並保留回復路徑

先以非敏感資料完成最小測試,再加入真實任務與故障情境。保存先前設定,定義何時暫停切換及誰負責處理。觀察結果品質與失敗類型,避免只看請求有回應就認定整合成功。