專案接入
提供兩種接入方式:由程式設計助手依需求將 Jev 接入專案;或在已有 TypeSafe 程式碼的專案中,僅修改兩個環境變數。
透過程式設計助手接入
使用 Claude Code、Cursor、Codex 等程式設計助手時,複製以下提示詞並將 【】 中的內容替換為實際需求,程式設計助手將在專案中完成接入。
把 Jev 接進我的專案
複製後,將第二步中【】內的內容替換為實際的判斷需求。
我想在目前的專案中接入 OfoxAI 的 Jev 判斷模型。我已經在 OfoxAI 控制台建立好 API Key。請一步一步帶我做,每一步先告訴我你在做什麼、下一步是什麼。 【第一步:安全地保存 Key】 1. 在專案中建立 .env 檔案,寫入一行 OFOX_API_KEY=,等號後面留空;把 .env 加進 .gitignore。 2. 告訴我這個檔案在哪裡,讓我自己把 Key 貼上並儲存。不要讓我把 Key 傳在對話中,也不要把 Key 寫進程式碼或印出來。 3. 等我告訴你「填好了」再繼續。 【第二步:我要做的判斷】 - 要判斷的內容:【例如:使用者提交的客服工單文字】 - 要回答的問題:【例如:應該分派給哪個團隊(扣款與退款 / 技術故障 / 售前諮詢);是否緊急】 - 拿到結果後要做什麼:【例如:置信度夠高就自動分派,否則轉交人工】 【第三步:撰寫程式碼】 4. 使用 OpenAI 官方 SDK(先執行 pip install -U openai,舊版本沒有 client.decisions),base_url 為 https://api.ofox.ai/v1,Key 從 .env 的 OFOX_API_KEY 讀取,呼叫 client.decisions.create(),模型使用 typesafe/jev-latest。 5. 依我的需求選擇問題型別:是或否用 predicate;從幾個選項中選一個用 choice;程度高低用 score。所有問題放在同一個請求的 questions 陣列中,每個問題都寫 name。 6. choice 的選項必須涵蓋所有情況,並加上一個「以上皆非」的選項;每個選項都寫 description。 7. 結果依 name 讀取。choice 與 score 用 confidence 判斷是否自動執行,predicate 用 probability;門檻先設為 0.7,寫成設定項,方便日後調整。低於門檻的轉交人工或走備援流程。 8. 欄位與錯誤以 https://ofox.ai/zh-TW/docs/api/decisions 為準,用法參考 https://ofox.ai/zh-TW/docs/develop/models/jev 。 【第四步:測試】 9. 用 3 筆明確的樣本與 2 筆模稜兩可的樣本各跑一次,把每筆的答案、機率與置信度列給我看。 10. 出錯時印出 HTTP 狀態碼、error.message 與 request_id,對照文件的錯誤表只改一處再試;同一個錯誤改兩次仍未解決,就停下來把錯誤原文與 request_id 給我。
從 TypeSafe 遷移
已使用 TypeSafe 官方 SDK,或參照 TypeSafe 官方文件撰寫程式碼的專案,僅需將 base URL 改為 https://api.ofox.ai/typesafe,並將 API Key 替換為 OfoxAI 的 Key:
Terminal
export TYPESAFE_BASE_URL="https://api.ofox.ai/typesafe"
export TYPESAFE_API_KEY="$OFOX_API_KEY"請求將傳送至 /typesafe/v1/systemone,格式與 TypeSafe 官方一致(state 與以問題 ID 為鍵的 questions,是非問題類型為 noul)。兩種格式的對照與 SDK 範例請見 Decisions API · TypeSafe 原生格式。新專案建議直接使用 /v1/decisions。
最後更新於