標籤: 成本優化

  • Claude Opus 5 實戰選型與架構攻略

    Claude Opus 5 實戰選型與架構攻略

    📌 本文重點

    • Opus 5 從 demo 模型躍升為可上線的 production 主力
    • 建議採「Opus 做腦、Sonnet 做手」的雙模型架構
    • 強化安全、RAG、tool 使用與多模型編排的最佳實務

    第一件事:Opus 5 把「最強模型只能當 demo」這個痛點,往「真的能丟進 production」推了一大步。在 ARC-AGI-3 這種新型問題解決基準上,Opus 5 拿到 30.2% 分數,同等級模型(例如 Fable 系列)大概一半 token 價格;同時又補上多模態、工具調用、安全控制等企業級能力。對開發者來說,最大的價值是:

    💡 關鍵: Opus 5 在 ARC-AGI-3 拿到 30.2%,以約半價 token 成本提供接近頂級旗艦的推理與企業級能力。

    • 編碼、RAG、Agent 這三大主流場景,可以更直接地拿來替換或混用現有 GPT / Claude 舊版
    • 一套 API 和安全機制,把合規、幻覺控制、tool 使用統一到一個模型族群
    • 成本 vs 能力 的拉扯中,有更清晰的「Opus / Sonnet / 本地模型」分工

    重點說明:模型能力、費率與企業級特性


    1. 模型族群與費率結構:怎麼排兵布陣

    Anthropic 典型組合是:

    • Claude 5 Opus:高推理、長上下文、多模態、最強工具使用能力。用在:複雜規劃、關鍵決策、Agent orchestrator、關鍵碼審查
    • Claude 5 Sonnet:中高性能、成本更低。用在:高頻次對話、一般程式生成、RAG 回答層
    • Claude 5 Haiku / 本地模型:超高頻、可接受誤差場景。用在:query rewrite、embedding 前處理、粗篩分類

    Opus 5 的定位:

    • 接近頂級旗艦(文中對標 Fable 5),但 token 價格約半價
    • 在 coding、知識工作和複雜推理上可當「主力高端模型」,不再只適合作為偶爾叫一次的 premium 模型

    💡 關鍵: Opus 5 的策略是用約半價的 token 成本,承擔高推理、高風險任務,讓旗艦模型能真正進入日常 production 流程。

    實務建議:

    • 新專案:直接採 「Opus 做腦、Sonnet 做手」 的雙模型架構
    • 既有 OpenAI / Claude 3 專案:先把高風險、高價值的步驟換成 Opus 5,再慢慢 rollout 其他部分

    2. 安全性與企業級:如何設計 prompt / 架構控風險

    Anthropic 的強項一直是 安全 / 合規 / 可控行為,Opus 5 延續這點並加強:

    • 更嚴格遵守系統層指令(system message)→ 適合用來實作公司級「行為政策」
    • 內建對 敏感話題、個資、濫用 的拒答與降階描述能力
    • 系統卡(system card)說明了其對安全邊界的設計與限制

    設計上建議:

    1. 系統層明確寫「允許做什麼、不允許做什麼」,而不是只寫風格
    2. 對於高風險 domain(醫療、財務、法律)採用 「模型 + 規則引擎/審核人」 的二階段架構
    3. RAG 場景強制:「只能根據提供的文件回答,無法回答就說不知道」,並在系統層寫死

    簡化示意:

    {
      "model": "claude-5-opus-2026-07-25",
      "messages": [
        {
          "role": "system",
          "content": [
            {
              "type": "text",
              "text": "你是企業內部助理,**所有回答必須符合以下規則**:\n1. 僅可根據提供的檔案與 tool 回傳資料作答。\n2. 若資訊不足,請明確回答『我無法根據現有資料回答』,不得自行推測。\n3. 涉及個資或敏感資料時,優先隱去或模糊處理。"
            }
          ]
        },
        {
          "role": "user",
          "content": [
            {
              "type": "text",
              "text": "說明這份合約的付款條款重點"
            }
          ]
        }
      ]
    }
    

    這樣可以大幅降低幻覺與合規風險,尤其在內部文件 RAG、決策輔助類應用。


    3. 接 Claude API 的多模態 / 長上下文 / function calling

    Opus 5 支援:

    • 多模態:文字 + 圖像輸入
    • 長上下文:適合大型文件 / 多輪 Agent 對話
    • tool / function calling:結構化叫用後端服務

    API 型式與 Claude 5 系列一致,用 /v1/messages,關鍵參數:

    • modelclaude-5-opus-2026-07-25(假設版號)
    • tools:宣告可用 tool schema
    • tool_choice:控制是否自動選工具
    • max_output_tokens:記得設上限避免爆成本

    實作範例:從簡單調用到多模型編排


    1. 多模態 + 長上下文基本調用

    以下用 Node.js 示意(Python 也幾乎同樣):

    import Anthropic from "@anthropic-ai/sdk";
    
    const client = new Anthropic({ apiKey: process.env.CLAUDE_API_KEY });
    
    const res = await client.messages.create({
      model: "claude-5-opus-2026-07-25",
      max_output_tokens: 800,
      messages: [
        {
          role: "user",
          content: [
            {
              type: "text",
              text: "看這張錯誤截圖,說明 build 為什麼失敗,並給出修正 steps"
            },
            {
              type: "image",
              source: {
                type: "base64",
                media_type: "image/png",
                data: screenshotBase64
              }
            },
            {
              type: "text",
              text: longBuildLog // 可是一整段 build log,利用長 context
            }
          ]
        }
      ]
    });
    
    console.log(res.content[0].text);
    

    實際好處

    • debug pipeline 時,不用自己剪 log + 截圖分別丟,Opus 5 能直接在圖 + log 裡找因果
    • 利用長上下文,把整段 build log 喂進去,少做複雜 chunking

    2. Function calling:由 Opus 5 當 orchestrator agent

    假設有兩個後端工具:查用戶資料、創建 Jira ticket,由 Opus 5 自動決定何時調用。

    const tools = [
      {
        name: "get_user_profile",
        description: "依 user_id 取得使用者資訊",
        input_schema: {
          type: "object",
          properties: { user_id: { type: "string" } },
          required: ["user_id"]
        }
      },
      {
        name: "create_jira_ticket",
        description: "建立 Jira bug ticket",
        input_schema: {
          type: "object",
          properties: {
            summary: { type: "string" },
            description: { type: "string" },
            priority: { type: "string", enum: ["Low", "Medium", "High"] }
          },
          required: ["summary", "description"]
        }
      }
    ];
    
    const res = await client.messages.create({
      model: "claude-5-opus-2026-07-25",
      tools,
      tool_choice: "auto", // 讓模型自行決定是否呼叫工具
      messages: [
        {
          role: "user",
          content: [
            {
              type: "text",
              text: "幫我檢查 user_123 的帳號狀態,如果真的有 bug 就開一張高優先的 Jira"
            }
          ]
        }
      ]
    });
    
    for (const block of res.content) {
      if (block.type === "tool_call") {
        const { name, input } = block;
        // 在這裡實際呼叫你的後端,再把結果做成新的 assistant/tool 回合
      }
    }
    

    實際好處

    • Opus 5 做決策與規劃,例如先查 user,再視需要開 ticket
    • 在多 step 任務中,比較能處理模糊指令(”如果真的有 bug 就…”)

    相較 Sonnet / 本地模型,Opus 5 在:

    • 正確選用對的 tool、傳對參數 的成功率明顯更高
    • 多步推理(先查再判斷再執行)時較少「跳步」或忘記驗證條件

    3. 多模型編排:Opus + Sonnet + 本地模型

    典型 production 架構可以長這樣:

    graph TD
      U[使用者] -->|query| R[Router]
      R -->|簡單 Q&A / 高頻| S[Claude 5 Sonnet]
      R -->|複雜規劃 / 新任務| O[Claude 5 Opus]
      R -->|極高頻前處理| L[本地模型]
      S --> B[Business Logic]
      O --> B
      L --> S
    

    簡易 routing 示意(Node + 手寫 rules):

    function routeModel(intent: "simple" | "complex" | "preprocess") {
      switch (intent) {
        case "preprocess":
          return "local";
        case "simple":
          return "claude-5-sonnet-2026-07-25";
        case "complex":
          return "claude-5-opus-2026-07-25";
      }
    }
    

    何時用 Opus、何時退回 Sonnet / 本地?

    • Opus
    • 要跨多文件 / 多步驟整合推理(合約比較、架構選型、長鏈式工具調用)
    • 產出錯誤成本高(法律、財務建議,CI/CD pipeline 生成、關鍵 infra IaC)
    • Sonnet
    • 常規 coding assistant、一般 RAG 問答、標準客服問答
    • 允許小錯但需要高吞吐
    • 本地模型
    • 簡單分類 / metadata 抽取 / prompt rewrite / query expansion

    建議與注意事項:遷移坑與最佳實踐


    1. 從舊 Claude / OpenAI 遷移的常見坑

    1. 上下文長度變長 ≠ 可以亂餵
    2. Opus 5 支援更長 context,但:
      • token 成本會線性上升
      • 太長反而容易導致模型抓錯重點
    3. 建議:保留 chunking + ranking,只是在「最終 candidate 合併」時可以放更多片段

    4. tool schema 的差異

    5. Claude 使用 tools + input_schema,與 OpenAI 的 functions + parameters 類似但格式略不同
    6. 遷移時要注意:

      • JSON Schema 的 typerequiredenum 要嚴格
      • 工具名稱 保持穩定且語義明確,模型會用名稱來推理用途
    7. 行為差異造成回歸

    8. Opus 5 對 system message 服從度較高,可能導致:
      • 原本模糊的 system 設計 → 在新模型下變成過度保守或拒答
    9. 建議:
      • 把原本的 system 重新整理成清楚的「允許 / 禁止列表」
      • 遷移前先在 staging 跑 regression prompt test(可以用 Claude Cookbook 裡的測試框架範例改)

    2. 降低幻覺與合規風險的模式

    • RAG 必備
    • system 固定句:「如果資料不足,請回答『我不知道』,不得自行補完。」
    • user prompt 裡標出:[來源文件開始]... [來源文件結束]
    • 回答時要求 "citation": [doc_id, ...] 結構化輸出

    • 敏感領域

    • Opus 5 做 reasoning + 初版草稿
    • 交由規則引擎(關鍵字、正則)+ 人工審核做最後關卡

    3. 成本優化實務

    • 一開始刻意過度使用 Opus 收集資料,記錄:
    • 哪些 query 類型其實 Sonnet / 本地就夠
    • 哪些工具調用失敗是因為 prompt / schema 設計不好
    • 之後用這些 log 寫 routing 規則或訓練 classifier,把 60-80% 流量導回 Sonnet / 本地

    💡 關鍵: 先用 Opus 全覆蓋收集真實流量,再用資料驅動的 routing 把 60–80% 較簡單請求轉回更便宜模型,是實務上的成本優化路徑。


    總結

    • Claude Opus 5 適合做「系統的大腦」而不是「所有事情都自己做」
    • 把它放在複雜推理、Agent orchestrator、關鍵決策點,其餘交給 Sonnet 或本地模型
    • 遷移時要特別檢查:上下文策略、tool schema、system prompt 行為差異,避免隱性回歸

    善用 Anthropic 提供的 Claude Cookbook 做 prompt / tool 設計模板,可以大幅縮短從 PoC 到 production 的時間。


    🚀 你現在可以做的事

    • 實際用 claude-5-opus-2026-07-25 在沙箱環境替換現有高風險、高價值步驟,觀察效果與成本
    • 參考 Claude Cookbook,為自家場景重寫一版明確的 system prompt 與 tool schema
    • 從現有 log 中標註「簡單 / 複雜 / 前處理」intent,實作最基本的 Opus / Sonnet / 本地模型 routing 規則
  • 語義快取實戰:RAG 成本暴降指南

    語義快取實戰:RAG 成本暴降指南

    📌 本文重點

    • 語義快取可降 20–60% API 成本
    • 僅對「穩定且短」內容做 embedding
    • 加多鍵條件與門檻避免誤命中
    • 做成可監控、有版本的基礎設施

    多數 RAG / chat backend 在做完 模型選型、prompt 調參、retriever 調優 之後,推理帳單還是居高不下,關鍵原因往往是:只做 exact-match cache,幾乎等於沒快取。語義快取(semantic cache)能把「同一個問題的不同說法」視為同一查詢,實務上可以做到 20–60% API call 減少,延遲跟成本一起砍。

    💡 關鍵: 用語義快取把不同說法視為同一查詢,實務上可直接減少約 20–60% 的 API 呼叫與成本。

    下面直接從實作觀點拆解:要怎麼在典型 RAG 架構裡,把語義快取變成一個可上線的「基礎設施」,而不只是一個實驗性 side project。


    重點說明

    1. Exact-match cache vs Semantic cache:差在哪裡?

    典型 chat / RAG backend 的 exact-match cache 會用:

    key   = hash(user_id + model_id + prompt_string)
    value = LLM 回應(與中間狀態)
    

    問題:只要 user 換句話說、加入一句客套話、locale 不同,就完全 miss。

    語義快取改成

    1. embedding 模型 將「實際送進 LLM 的完整 prompt」轉成向量
    2. 在向量空間做 相似度搜尋,找到語義相近的歷史請求
    3. 若相似度高於門檻,就直接重用快取結果

    核心差異:

    • exact-match:字串完全一致才命中 → hit rate 極低
    • semantic cache:語義相似即可命中 → 命中率與長尾查詢成本大幅改善

    2. Embedding 維度、距離度量與門檻設計

    (1) Embedding 選型

    實務建議:

    • 優先用雲端提供的現成模型,例如:
    • OpenAItext-embedding-3-small(1536 維,CP 值高)
    • Anthropic:搭配外部 embedding 模型(現階段主力還是在 text model)
    • 本地bge-m3 / bge-large-zh 系列
    • 維度建議:768–1536 維,再低容易語義表達力不足,再高會拖慢向量查詢與存儲

    💡 關鍵: Embedding 維度落在 768–1536 通常能兼顧語義表達力與查詢成本,是實務上常用的安全區間。

    (2) 距離度量

    多數 embedding 預設是單位向量,直接用:

    • Cosine 相似度
    • Inner product(dot product) + normalization

    pgvector / RediSearch 中對應為:

    • pgvector:cosine_distance, inner_product
    • RediSearch:COSINE, IP

    (3) 相似度門檻

    實務上用相似度 score(越高越相似):

    • 一般 QA / FAQ 類:≥ 0.85 才視為命中
    • 容錯度高(例如推薦、summarize):可以放寬到 0.8
    • 安全關鍵(法務 / 醫療):建議 0.9+ 或只做「候選提示」不直接 auto-hit

    建議做成 可配置

    semantic_cache:
      min_similarity: 0.87
      max_age_seconds: 86400  # 24h
    

    💡 關鍵: 把相似度門檻做成可配置,可以依場景在 0.8–0.9+ 之間調整,兼顧命中率與錯答風險。

    3. 多鍵策略 & Prompt 模板變動

    (1) 多鍵策略:user_id / locale / model_id

    避免「錯人、錯模、錯語系」的語義誤命中,可以在向量檢索時加上多維限制:

    • user_id:B2B 場景常有客製知識庫,可用 tenant_id / org_id 分區
    • localezh-TW vs en-US 的語義可近但答案不同
    • model_id:不同模型輸出風格與能力差異大,cache 混用會有體感落差

    查詢條件大致會長這樣:

    WHERE tenant_id = $1 AND locale = $2 AND model_id = $3
    ORDER BY embedding <-> $query_embedding
    LIMIT 1
    

    (2) Prompt 模板變動導致 cache miss

    大部分團隊會把 系統提示 + tool 描述 + 歷史對話 + user 問句 串成完整 prompt 做快取 key;結果一改模板,整個 cache 幾乎報廢。

    實務作法:

    • 把要做 embedding 的內容拆成比較穩定的部分:
    • 不要含整個系統提示
    • 不要含 tool schema
    • 只對「語義關鍵」部分做 embedding:user 問句 + 精簡後的 RAG context
    • 快取 key 中再另外紀錄 prompt_template_version,查詢時限制:
    WHERE prompt_template_version = $ver
    

    這樣改模板時只需要 bump version,舊資料會自然「冷掉」,又不會影響新版本 cache 收斂。


    實作範例

    1. 架構視角

    以典型 RAG / chat backend 為例,語義快取插在:

    1. 收到 user query
    2. 組裝完整 prompt 前/後,計算 embedding
    3. 先查 semantic cache
    4. 命中:直接回應
    5. 未命中:
      • 走正常流程:檢索(RAG)、呼叫 OpenAI / Anthropic / Meta 模型
      • 回寫快取

    2. PostgreSQL + pgvector 範例

    建表

    CREATE EXTENSION IF NOT EXISTS vector;
    
    CREATE TABLE semantic_cache (
      id BIGSERIAL PRIMARY KEY,
      tenant_id TEXT NOT NULL,
      locale TEXT NOT NULL,
      model_id TEXT NOT NULL,
      prompt_template_version INT NOT NULL,
    
      prompt_text TEXT NOT NULL,       -- 關鍵語義部分(例如 user 問句 + RAG context 摘要)
      response_json JSONB NOT NULL,    -- 模型原始回傳(含tool_calls可選)
    
      embedding VECTOR(1536) NOT NULL,
      created_at TIMESTAMPTZ DEFAULT now(),
    
      UNIQUE (tenant_id, locale, model_id, prompt_template_version, id)
    );
    
    CREATE INDEX ON semantic_cache USING ivfflat (embedding vector_cosine_ops)
      WITH (lists = 100);
    

    查詢(Node / TS pseudo-code):

    const { embedding } = await openai.embeddings.create({
      model: "text-embedding-3-small",
      input: cacheKeyText, // user 問句 + RAG 摘要
    });
    
    const { rows } = await pg.query(
      `SELECT id, response_json,
              1 - (embedding <=> $4) AS similarity
       FROM semantic_cache
       WHERE tenant_id = $1
         AND locale = $2
         AND model_id = $3
         AND prompt_template_version = $5
       ORDER BY embedding <-> $4
       LIMIT 1`,
      [tenantId, locale, modelId, embedding, promptTemplateVersion]
    );
    
    if (rows[0] && rows[0].similarity >= MIN_SIMILARITY) {
      return rows[0].response_json; // 命中語義快取
    }
    

    回寫

    await pg.query(
      `INSERT INTO semantic_cache
       (tenant_id, locale, model_id, prompt_template_version,
        prompt_text, response_json, embedding)
       VALUES ($1, $2, $3, $4, $5, $6, $7)`,
      [tenantId, locale, modelId, promptTemplateVersion,
       cacheKeyText, responseJson, embedding]
    );
    

    3. Redis + RediSearch 範例

    定義向量索引

    FT.CREATE semantic_cache_idx ON HASH PREFIX 1 sc:
      SCHEMA tenant_id TAG locale TAG model_id TAG prompt_template_version NUMERIC
             embedding VECTOR HNSW 6 TYPE FLOAT32 DIM 1536 DISTANCE_METRIC COSINE
    

    查詢(Python pseudo-code):

    vec = get_embedding(cache_key_text)  # 1536 維 float32
    
    q = (
      f"(@tenant_id:{{{tenant_id}}} "
      f"@locale:{{{locale}}} "
      f"@model_id:{{{model_id}}} "
      f"@prompt_template_version:[{ver} {ver}])=>[KNN 1 @embedding $vec AS sim]"
    )
    
    res = redis.ft("semantic_cache_idx").search(q, query_params={"vec": vec})
    if res.docs:
      sim = 1 - float(res.docs[0].sim)
      if sim >= MIN_SIMILARITY:
        return json.loads(res.docs[0].response_json)
    

    建議與注意事項

    1. 長輸入的 embedding 成本「反向暴增」

    常見錯誤:把 整個 prompt(含長 RAG context) 丟去做 embedding。

    問題:

    • context 動輒上千 tokens,embedding 成本跟 LLM inference 一起爆
    • 一點點 context 差異就讓相似度下降 → 命中率不升反降

    實務建議

    • 只對「stable 且短」的部分做 embedding:
    • user 問句
    • RAG context 的「摘要」而不是原文(可用小模型先 summarize 成 2–3 句)
    • 大型企業專案:先用 request 日誌做統計,估算 embedding 成本佔比,再決定精度/長度 trade-off

    2. 語義誤命中 → 幻覺與錯答風險

    語義快取本質上是「猜這問題和之前那題是不是本質相同」,猜錯就會回錯答案,而且錯得非常「自信」。

    風險控制手段:

    1. 提高門檻 + 多條件
    2. similarity 0.9+ + 同 tenant / locale / model / template_version
    3. 加上 lightweight 檢查模型
    4. 對 candidate 問題 & 當前問題再丟給小模型,問:
    5. 「這兩個問題是否在同一個具體情境下?只回答 yes/no」
    6. 只回部分結果
    7. 把 cache 命中當作「示範答案」塞進 system prompt,而不是直接當最終輸出

    3. 線上 A/B、hit rate 與 cost saving 監控

    (1) A/B 框架

    • A 組:只用 exact-match cache
    • B 組:開啟 semantic cache
    • 衡量指標:
    • cache_hit_rate:命中次數 / 總請求
    • avg_latency:端到端延遲
    • cost_per_1k_requests:可用 token 使用量 × 單價估算

    (2) 實作例:log 設計

    {
      "request_id": "...",
      "tenant_id": "...",
      "model_id": "gpt-4.1-mini",
      "semantic_cache_hit": true,
      "semantic_similarity": 0.91,
      "exact_cache_hit": false,
      "prompt_tokens": 923,
      "completion_tokens": 134,
      "latency_ms": 480
    }
    

    可以直接在 ClickHouse / BigQuery 做每日 dashboard:

    • 按 tenant 和 model 切分 semantic_cache_hit_rate
    • 比較「命中 vs 未命中」的平均 latency / token usage

    4. 上線前的設計 Checklist

    • Embedding 模型
    • [ ] 維度 768–1536,成本可接受
    • [ ] 支援你主要語言(中/英通常 OK,但特定語種要確認)
    • 距離度量與索引
    • [ ] PostgreSQL 使用 pgvector + ivfflat,設好 lists
    • [ ] Redis 使用 HNSW,確認記憶體預算
    • 快取 key 策略
    • [ ] 僅對 user query + 短 RAG 摘要做 embedding
    • [ ] 有 tenant_id / locale / model_id / prompt_template_version 條件
    • 風險控制
    • [ ] similarity 門檻可配置,預設 ≥ 0.85
    • [ ] 高風險業務要額外加一層 lightweight 檢查
    • 監控與 rollback
    • [ ] 有 semantic_cache_hit_rate / latency / token usage 監控
    • [ ] 開關旗標(feature flag)可在出問題時快速關閉

    只要把語義快取做成這樣一個「有監控、有開關、有版本」的基礎組件,你的 RAG / chat backend 通常能在不改業務邏輯的前提下,拿到一個非常直接的 成本與體感雙重優化。從 infra 角度來說,這個投資的 ROI 幾乎是整條 LLM pipeline 裡最高的一塊。

    🚀 你現在可以做的事

    • 在現有 RAG backend 中,先對 user 問句接入 text-embedding-3-smallbge-m3 的語義快取實驗路徑
    • 用 ClickHouse 或 BigQuery 建一個簡單 dashboard,監控 semantic_cache_hit_rate、延遲與 token 成本變化
    • 增加 tenant_id / locale / model_id / prompt_template_version 條件,並設好 min_similarity 旗標,逐步在低風險場景 rollout