AI 金鑰設定教學

AI API KEY SETUP

團爆的兩個 AI 功能 ——「AI 自動對帳建議」與「客服小幫手」—— 需要一把你自己的 AI 金鑰才能啟用（BYOK，Bring Your Own Key）。你可以選擇 Groq 或 Gemini，設一把即可。

★ 推薦 Groq

建議使用 Groq：速度極快（對帳與客服回應幾乎即時）、成本低、免費額度充足，中文與 JSON 結構化輸出的表現對這兩個功能都很夠用。

✓回應速度快 —— 客人問客服、你按對帳建議都不用等
✓有免費額度，小店幾乎用不完
✓申請只要 1 分鐘，不必綁信用卡

A申請 Groq 金鑰（推薦）

  1. 前往 console.groq.com，用 Google 帳號或 Email 註冊／登入。
  2. 登入後，點左側選單的 API Keys。
  3. 點 Create API Key，取個名字（例如 tuanbao），建立。
  4. 複製跳出來的金鑰（gsk_ 開頭）—— 只會顯示這一次，請先存好。
  5. 把這把金鑰交給我們設定（或自行設到 Netlify，見下方 步驟 C），環境變數名稱用 GROQ_API_KEY。
前往 Groq 申請 →

B替代方案：Gemini 金鑰

如果你比較習慣 Google 生態，也可以改用 Gemini，效果同樣良好。

  1. 前往 aistudio.google.com/apikey（Google AI Studio），用 Google 帳號登入。
  2. 點 Get API key → Create API key。
  3. 複製金鑰並存好。
  4. 設定時環境變數名稱用 GEMINI_API_KEY。
前往 Gemini 申請 →

C把金鑰設到系統（Netlify）

金鑰只會存在伺服器端的環境變數，不會出現在網頁或程式碼裡，安全無虞。

  1. 到 Netlify 後台 → 你的站台 → Site configuration → Environment variables。
  2. 點 Add a variable，依你申請的服務填入其中一個：
GROQ_API_KEY = gsk_你的金鑰  （推薦）
GEMINI_API_KEY = 你的金鑰  （替代）

Context 選 Production、建議勾選 Secret。「客服小幫手」要設在下單站、「AI 對帳建議」要設在後台站。設好後重新部署即生效。

想換成別的模型，可另設 LLM_MODEL（例如 Groq 的 llama-3.3-70b-versatile）；不設就用預設的推薦模型。

安全提醒：API 金鑰等同你的帳號密碼，請勿貼到公開的群組、截圖或程式碼裡。若不小心外洩，到該服務後台刪除舊金鑰、重新產生一把即可。

設定完成後，後台的「AI 對帳建議」與下單頁的「客服小幫手」就會自動啟用。有問題隨時找我們協助 🙌

← 回後台