標籤: LLM 優化

  • Claude 永續 Agent Warm-Cache 實戰

    Claude 永續 Agent Warm-Cache 實戰

    📌 本文重點

    • 全上下文重送會讓長期 Agent 在成本與延遲上崩盤
    • 用 Warm-Cache 三層快取可把成本壓到約 1/8
    • 短期 context + 向量庫分層記憶可兼顧長期記憶與成本
    • 嚴格工具邊界與審計是讓 Claude Agent 能上線的關鍵

    在 Discord 上跑一個長期管理 AWS 基礎設施與程式碼的 Claude Agent,如果每次請求都把 全上下文重送,你很快就會發現兩個殘酷事實:token 費用爆炸延遲高到用不下去。實測數據來看,透過 Warm-Cache + 分層記憶架構,可以把成本壓到原本的 1/8 左右,P95 latency 也從 10+ 秒壓到 3 秒內,而且邏輯與安全性更可控。

    💡 關鍵: 透過結構化快取與記憶分層設計,可以同時把成本壓到約 1/8,並把 P95 延遲從 10 秒級降到 3 秒內,讓長期 Agent 實際可用。


    重點說明

    1. 為什麼「全上下文重送」會崩盤?

    典型實作:

    • 每個 Discord 訊息 → 直接呼叫 /v1/messages
    • 完整對話歷史 + 工具定義 + 系統提示 一起丟進去

    問題:

    1. token 費用幾乎線性成長:對話越長,每次重送的 tokens 越多,長期 Agent 變成「每句話都在重付歷史學費」。
    2. 延遲被序列化成本綁死:100K context 每次 encode / decode 都是固定開銷,沒做 cache 再快的模型也救不了。
    3. 易爆 context:聊久一點就逼近上限,被系統自動截斷,Agent 出現「金魚記憶」。

    結論:永續 Agent 若不做 Prompt Caching,本質上不具備經濟可行性。

    💡 關鍵: 對長期 Agent 而言,不做 Prompt Caching 意味著 token 成本和延遲會隨時間線性惡化,最終失去經濟可行性。


    2. Warm-Cache 三層設計:工具、系統提示、歷史

    核心想法:把「幾乎不變」的部分從請求中抽出來,讓 Claude 的 Prompt Caching 真正生效,同時在你自己的系統再加一層 cache。

    三層結構:

    1. 工具定義層(Tools Cache)
    2. 例如 AWS 管理、Git 操作、MemPalace 查詢等工具定義
    3. 穩定的 ID + 版本號 來標記(例如 aws_tools:v3
    4. 實作:

      • 本地用 JSON 檔TypeScript enum 管理
      • 對 Claude 端利用 prompt_cache_key(概念上,可用 system prompt 方式固定)
    5. 系統提示層(System Prompt Cache)

    6. 定義 Agent 的角色、邊界、倫理規則(例如只能操作 Private VPC 而非公網)
    7. 變動頻率低,但會跟版本、環境(staging/prod)綁定
    8. 推薦:用 template + 版本號,例如 discord_infra_agent:v5

    9. 歷史記錄層(Conversation Cache)

    10. 只快取「近期對話 + 工具呼叫結果」的短期記憶
    11. 長期記憶丟給向量庫(MemPalace / 自建 Milvus / PGvector),避免塞爆 context
    12. 每個 channel / user 維護一個 sliding window,例如最近 30 則訊息

    典型資料結構(TypeScript):

    type CacheKey = string; // e.g. "tools:aws:v3", "sys:discord_agent:v5"
    
    interface WarmCacheEntry {
      version: string;
      contentHash: string;
      serialized: string;   // 已處理過、可直接拼進 messages 的 JSON 字串
      updatedAt: number;
    }
    
    class WarmCache {
      private store = new Map<CacheKey, WarmCacheEntry>();
    
      get(key: CacheKey): WarmCacheEntry | undefined {
        return this.store.get(key);
      }
    
      set(key: CacheKey, entry: WarmCacheEntry) {
        this.store.set(key, entry);
      }
    }
    

    版本管理與失效策略:

    • 工具或系統提示改版 → 直接 變更 version(v3v4,讓舊 cache 自然失效
    • 每次啟動時計算一遍 contentHash,若 hash 改變但 version 沒變,log 出警告避免「隱性分叉」

    3. 長期記憶:MemPalace + 短期上下文的分層設計

    要讓 Agent 在 Discord 長期「記得」你的 AWS 結構、服務慣例,又不把所有東西塞進 context,做法是:

    1. 短期記憶(Context Window)
    2. Warm-Cache 上的歷史層,只保留最近 N 回合(例如 30)
    3. 專門服務「連續對話」與「工具呼叫之前的局部上下文」

    4. 長期記憶(向量庫 / MemPalace)

    5. 把:
      • 專案 README
      • 關鍵 AWS 架構說明
      • 常見 Runbook / SOP
    6. 全部 embed 成向量,存進 MemPalace / 其他向量庫

    7. 查詢流程:

    8. 使用者問問題 →

    9. 先以「channel + user + 問題」做 embedding,去 MemPalace 找 Top-K 相關記憶片段
    10. 把這些片段壓縮後,丟進當次 system 或 user message 的前置 context

    簡單 Python 記憶層(SQLite + 向量庫 ID)示意:

    import sqlite3
    
    conn = sqlite3.connect("memory.db")
    cur = conn.cursor()
    
    cur.execute("""
    CREATE TABLE IF NOT EXISTS long_term_memory (
      id INTEGER PRIMARY KEY,
      user_id TEXT,
      channel_id TEXT,
      vector_id TEXT,   -- 真正的向量存在 MemPalace / pgvector
      summary TEXT,
      created_at INTEGER
    );
    """)
    
    # 檢索時:先從 MemPalace 拿相關 vector_id,再 join 回 summary
    

    好處:

    • context 永遠保持在一個可以預估的上限
    • 記憶可審計、可搜索,而不是全埋在 opaque 的 token 流裡

    實作範例

    1. Node.js:Claude Warm-Cache middleware

    以下是假想的 middleware,包裝 /v1/messages 呼叫,示意如何組合三層快取與向量記憶:

    import { claudeClient } from "./claude";
    import { WarmCache } from "./warmCache";
    import { fetchMemories } from "./memPalace";
    
    const cache = new WarmCache();
    
    export async function handleDiscordMessage(ctx: {
      channelId: string;
      userId: string;
      message: string;
      history: any[]; // 最近 N 則對話
    }) {
      const toolsKey = "tools:aws:v3";
      const sysKey = "sys:discord_infra_agent:v5";
    
      const tools = cache.get(toolsKey) ?? buildAndCacheTools(toolsKey);
      const systemPrompt = cache.get(sysKey) ?? buildAndCacheSystem(sysKey);
    
      const longTerm = await fetchMemories(ctx.userId, ctx.channelId, ctx.message);
    
      const messages = [
        { role: "system", content: systemPrompt.serialized },
        { role: "user", content: buildUserContent(ctx.message, longTerm) },
        ...ctx.history
      ];
    
      const res = await claudeClient.messages.create({
        model: "claude-3.7-sonnet",
        max_tokens: 1024,
        tools: JSON.parse(tools.serialized),
        messages
      });
    
      return res;
    }
    

    關鍵點:

    • toolssystemPrompt 都是快取後的 序列化結果,避免每請求重組
    • history 控制在固定長度,長期記憶透過 fetchMemories 注入

    2. Claude 系統 Prompt 模板(安全與邊界)

    你是一個在 Discord 裡專門協助管理 AWS 基礎設施與程式碼庫的 Agent。
    
    嚴格規則:
    - 只能透過提供的工具存取資源,禁止自行連線外部網路。
    - 所有操作必須限制在指定的 AWS Account 與 VPC,禁止新增具有公開網路權限的資源。
    - 若使用者要求執行具破壞性的操作(刪庫、清 bucket、關閉整個叢集),必須:
      1. 先以自然語言解釋風險與影響。
      2. 要求使用者提供明確確認字串(例如 "CONFIRM_DELETE_PROD")。
      3. 仍應優先建議更安全的替代方案。
    
    審計要求:
    - 對每一次工具呼叫,以簡潔 JSON 描述操作意圖與參數,方便後續寫入 audit log。
    

    3. Redis-based 歷史快取(短期記憶)

    import redis
    import json
    
    r = redis.Redis(host="localhost", port=6379, db=0)
    
    HISTORY_LIMIT = 30
    
    def push_history(channel_id: str, message: dict):
      key = f"history:{channel_id}"
      r.lpush(key, json.dumps(message))
      r.ltrim(key, 0, HISTORY_LIMIT - 1)
    
    def get_history(channel_id: str):
      key = f"history:{channel_id}"
      return [json.loads(x) for x in r.lrange(key, 0, -1)][::-1]
    

    建議與注意事項

    1. 監控:請求數、token、P95 latency 要一起看

    至少打三個 metrics:

    • token_usage_total:區分 prompt / completion / cache-hit
    • request_latency_ms:P50 / P95 / P99,分 model / route
    • tool_invocation_count:看 Agent 是否頻繁誤用工具

    優化策略:

    • 發現 P95 延遲高但 token 不高 → 多半是工具 / 外部 API 慢
    • 發現 token 緩慢上升 → 歷史快取 window 太大、向量記憶注入過多

    2. MCP / 工具設計:少而精 + 嚴格邊界

    • 像 PullMD 那樣,利用 MCP 把「HTML 轉 Markdown」這種重複工作下沉到工具層,避免讓 LLM 直接吃原始 HTML,token 省很大。
    • 工具要:
    • 明確輸入輸出 schema
    • 在私有網路中運行(Docker / Kubernetes namespace)
    • 只開最小必要權限(IAM 最小權限 + security group 限制)

    3. 避免「刪庫跑路」:幾個實務守則

    1. 只給「建議權」不給「直接執行權」 在 production
    2. 例如:Agent 只能產生 Terraform / CloudFormation patch,由人類 review + apply。
    3. 所有破壞性操作都經過雙重 gate:
    4. system prompt 要求二次確認
    5. backend 還要檢查「環境 + 操作類型」,prod 一律走人工流程
    6. 完整審計 log:
    7. 記錄:使用者指令、模型輸出、工具參數、執行結果
    8. 存在 append-only storage(CloudWatch Logs / Loki / S3 + Object Lock)

    4. 部署拓撲:限制在私有網路

    • Discord Bot → Gateway → Agent 後端(VPC 內)→ MCP 工具(同 VPC)
    • 往外只有到 Claude API + 向量庫(若是 SaaS) 的 egress
    • 不讓 Agent 直接 hit 公網,避免「自己 curl 一個 random script 來跑」這類事故

    總結:

    • Warm-Cache 三層快取(工具、系統、歷史)+ 分層記憶(短期 context + MemPalace 長期記憶),可以在實戰中穩定做到 成本 ≈ 1/8、P95 latency < 3s
    • 關鍵不是「多堆一點 GPU」,而是把「一次性 prompt」變成「可重用的結構」,再加上嚴格邊界與審計,讓你的 Claude 永續 Agent 真正能上 production。

    把上面的 middleware + Redis + SQLite/向量庫實作搬進你的客服 bot、infra bot 或內部 Copilot,大部分情況下只需要換掉工具與系統 prompt,就能直接開始省錢又提速。

    🚀 你現在可以做的事

    • 在現有 Discord / Slack Bot 中,先實作一層 Warm-Cache,把工具定義與系統提示抽出並版本化
    • 建一個最小可行的向量庫(MemPalace 或 pgvector),將 README、架構文件與 Runbook 全部 embed 進去
    • 為 production 環境補上系統 prompt 邊界、工具權限縮減與審計 log pipeline,驗證一條完整安全鏈路
  • GPT-5.5 實戰:從舊 API 到 Agent 模型

    GPT-5.5 實戰:從舊 API 到 Agent 模型

    📌 本文重點

    • GPT-5.5 對複雜多步任務與程式碼生成穩定度提升
    • 成本約為 GPT-5.4 的兩倍,需搭配模型路由控費
    • 建議先讓 GPT-5.5 接手最痛的 10% 高複雜任務

    GPT-5.5 主要解決兩個老問題:複雜多步任務很難穩定跑完、以及 程式碼生成在實務專案中需要大量人工修補。代價是 API 價格約 翻倍,但在多步推理、跨工具協作(agentic)場景,實測能少掉 30–60% 的「人肉 orchestrator」工作。這篇從工程落地角度整理:何時值得升級、怎麼改最少程式碼、怎麼安全灰度上線。


    重點說明

    1. 能力與效益:什麼場景值得多付兩倍單價?

    基於官方說明與社群測試,GPT-5.5 / 5.5 Pro 相較 GPT-5.4 / GPT-4.x 的實務差異,可粗略量化成幾類:

    💡 關鍵: 若你有大量跨系統、多步驟任務,GPT-5.5 能實際減少 30–60% 人工編排成本,值得用較高單價換穩定度與省人力。

    1. 程式碼生成 / 除錯
    2. 專案級 refactor(多檔案、跨模組)成功率提升,一次生成即可可編譯 / 可跑的比例顯著增加
    3. 能自己分解成「閱讀現有程式碼 → 擬方案 → 修改多個檔案 → 自我檢查」的多步流程。
    4. 若你現在常遇到:

      • 4.x 產出的 patch 無法編譯
      • RAG 上接錯 API、型別對不起來

      → 使用 GPT-5.5 Pro 當「主程式碼助手」通常物有所值。

    5. 多步任務編排 / Agent 能力

    6. GPT-5.5 對 tool calling 的規劃更積極:
      • 能自動決定「先查 DB → 再呼叫支付 API → 最後寄信」,而不是你手動 orchestrate。
      • 對含糊任務會先發問澄清,而不是直接亂調工具。
    7. 適合:客服自動處理、報表生成、跨系統自動化(CRM + 票務 + ERP)。

    8. 上下文與多模態

    9. 更長的 context window(依官方實際規格為準),對 RAG / 長文件總結,能減少 chunking 與多輪 query。
    10. 圖片 + 文字 + 結構化資料混合輸入時的理解更穩。

    不建議升級的場景
    – 純 FAQ、簡單分類、模板生成(信件、固定格式回答)。
    – 已經用 4.x 跑得很穩,且沒有多工具協作需求。

    此時可維持舊模型,或只對「高價值任務」做路由到 GPT-5.5。


    2. API 變更與最小遷移清單

    以官方 changelog 與社群實測為基礎,整理從 GPT-5.4 / GPT-4.x → GPT-5.5 的常見差異(命名依照 OpenAI 既有慣例,實際以文件為準):

    1. 模型名稱與 context
    2. 一般能力:gpt-5.5(假設 context 最高 ~200k tokens 級別)。
    3. 高階版:gpt-5.5-pro(更快、更穩、較高 rate limit)。
    4. 最小變更:
      “`diff

      • model: “gpt-4.1-mini”
      • model: “gpt-5.5”
        “`
    5. Tool calling / JSON mode 行為

    6. 工具呼叫邏輯更 agentic:模型會「自己決定」何時用工具,而不是你硬塞指令。
    7. response_format 行為加強:
      • {"type": "json_schema"} 更嚴格遵守 schema,但也可能為滿足 schema 而「合理捏造」欄位。
    8. 工具呼叫格式仍是 tools + tool_choice,但推薦寫法:
      jsonc
      {
      "model": "gpt-5.5",
      "tools": [
      {
      "type": "function",
      "function": {
      "name": "get_user_profile",
      "parameters": {
      "type": "object",
      "properties": {
      "user_id": {
      "type": "string"
      }
      },
      "required": ["user_id"]
      }
      }
      }
      ],
      "tool_choice": "auto" // 讓 5.5 自行規劃
      }

    9. 安全策略與輸出

    10. 官方系統卡說明:安全防護更嚴格,對灰色內容更傾向拒絕或弱化。
    11. 實務影響:有些之前「勉強會答」的 debug / 測試資料,可能會被誤判為敏感,需要:

      • 加強 system prompt:強調是企業內部開發、無真實個資。
      • 避免在 prompt 中填入真實 PII,改用匿名 ID。
    12. 延遲與費用

    13. token 單價約為 5.4 的兩倍級別(需看官方表)。
    14. GPT-5.5 本身更快,但若大量 tool calling,整體延遲可能 抖動更大(因為多輪 HTTP)。

    💡 關鍵: 單價約為 5.4 的兩倍,但若只在高價值、多步任務上使用,整體成本未必增加,反而可能因少錯誤與少人工介入而下降。

    最小遷移清單
    – [ ] 替換 model 名稱為 gpt-5.5gpt-5.5-pro
    – [ ] 檢查 tool 定義:補齊 parameters schema,避免舊寬鬆 schema 造成誤呼叫。
    – [ ] 若依賴 JSON 格式輸出,統一改用 response_format: { type: "json_schema" } 並加上 嚴格驗證
    – [ ] 更新成本計算與限額:調整配額、降級策略。


    3. 把 5.5 的 agent 能力整進現有架構

    一個實用思路:不要讓 GPT-5.5 直接當「超級大腦」管所有東西,而是:

    現有後端 + 工具層不動,只是把「任務分解與工具選擇」交給 5.5 來做。

    常見架構:

    Client → API Gateway → Orchestrator Service →
      ├─ LLM (GPT-4.x / 5.4)
      ├─ Tool Services (DB / CRM / Payment / RAG)
      └─ Logging & Guardrails
    

    升級方式:在 Orchestrator 裡新增一個路徑:

    Orchestrator
      ├─ Simple flows → 4.x
      └─ Complex multi-step flows → 5.5 (tool auto)
    

    實作範例

    1. 基本遷移:從 GPT-4.1 到 GPT-5.5 + JSON Schema

    // Node/TS 假想範例
    import OpenAI from "openai";
    
    const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
    
    async function generateInvoice(data: any) {
      const completion = await client.responses.create({
        model: "gpt-5.5",
        input: [
          {
            role: "system",
            content: "你是一個嚴格輸出 JSON 的後端服務,不要輸出解釋文字。",
          },
          {
            role: "user",
            content: `根據以下訂單資料產生發票 JSON:${JSON.stringify(data)}`,
          },
        ],
        response_format: {
          type: "json_schema",
          json_schema: {
            name: "InvoiceSchema",
            schema: {
              type: "object",
              required: ["invoice_id", "items", "total"],
              properties: {
                invoice_id: { type: "string" },
                items: {
                  type: "array",
                  items: {
                    type: "object",
                    required: ["name", "price"],
                    properties: {
                      name: { type: "string" },
                      price: { type: "number" },
                    },
                  },
                },
                total: { type: "number" },
              },
            },
            strict: true,
          },
        },
      });
    
      const json = JSON.parse(completion.output[0].content[0].text);
      return json;
    }
    

    好處
    – GPT-5.5 在複雜訂單(折扣、稅金)時,更少漏欄位與型別錯誤
    strict: true 讓 schema 驗證更嚴格,搭配後端再做一次 JSON schema 驗證,可大幅降低格式 bug。


    2. Agentic tool calling:自動任務分解 + 多工具串接

    以下示範:用 GPT-5.5 當任務規劃器 + 工具選擇器,工具維持既有 microservice。

    const tools = [
      {
        type: "function",
        function: {
          name: "search_tickets",
          description: "查詢使用者未處理工單",
          parameters: {
            type: "object",
            properties: { user_id: { type: "string" } },
            required: ["user_id"],
          },
        },
      },
      {
        type: "function",
        function: {
          name: "create_ticket_reply",
          description: "對特定工單回覆訊息",
          parameters: {
            type: "object",
            properties: {
              ticket_id: { type: "string" },
              message: { type: "string" },
            },
            required: ["ticket_id", "message"],
          },
        },
      },
    ];
    
    async function handleSupportRequest(userId: string, query: string) {
      const res = await client.responses.create({
        model: "gpt-5.5",
        tools,
        tool_choice: "auto", // 讓 5.5 自己決定呼叫順序
        input: [
          {
            role: "system",
            content:
              "你是客服 Agent,可以呼叫工具查詢工單並回覆。遇到資訊不足時先提問澄清。",
          },
          { role: "user", content: `user_id=${userId}, 問題:${query}` },
        ],
      });
    
      // 實務上這裡要迴圈處理多輪 tool calls,以下簡化偽碼
      for (const output of res.output) {
        for (const item of output.content) {
          if (item.type === "tool_call") {
            const { name, arguments: args } = item.tool_call;
            const toolResult = await dispatchTool(name, args); // call your microservice
            // 把工具結果再丟回 5.5 讓它整合
          }
        }
      }
    }
    

    實際好處
    – 過去你可能要在 Orchestrator 裡手寫流程:先 search_tickets,再挑一筆,然後叫模型產生回覆,再 create_ticket_reply
    – 現在可以讓 GPT-5.5 自己決定要查幾次、要不要先澄清,你只需負責工具實作 + 安全閘。


    3. 成本優化與模型路由示意

    簡單的分層推理策略(Pseudo-code):

    async function routeLLMTask(task: Task) {
      // 1. 便宜模型先做分類 / 難度預估
      const difficulty = await estimateDifficultyWithMini(task);
    
      if (difficulty === "simple") {
        return callLLM({ model: "gpt-4.1-mini", task });
      }
    
      if (difficulty === "medium") {
        return callLLM({ model: "gpt-5.4", task });
      }
    
      // 真的複雜 / 高價值才用 5.5 Pro
      return callLLM({ model: "gpt-5.5-pro", task });
    }
    

    適用場景:
    – SaaS 產品內的「AI 助理」,各種請求混雜。
    – 有明顯高價值操作(下單、修改合約)與低價值操作(查 FAQ)。


    建議與注意事項

    1. 常見坑

    1. 自動工具過度呼叫
    2. GPT-5.5 在 tool_choice: "auto" 下偏好積極使用工具,可能導致:
      • 單次對話打爆你的 microservice rate limit。
    3. 建議:

      • 在 Orchestrator 加 工具呼叫次數上限(例如每次對話最多 5 次)。
      • 若超過,回傳一個「工具不可用」的 faux tool result,要求模型改用已有資訊回答。
    4. 推理時間抖動

    5. 多輪 tool calling 會導致延遲暴增(LLM 快,但你的工具慢)。
    6. 建議:

      • 對每個工具加 timeout;
      • 若工具 timeout,回傳明確錯誤給 LLM(例如 "status": "timeout"),讓它用降級策略回應。
    7. 輸出格式不穩 / schema 假資料

    8. json_schema 雖強,但 GPT-5.5 會為滿足 schema 而補齊不存在的欄位。
    9. 必做:
      • 後端再驗證一次 JSON schema,不要信任模型;
      • 對關鍵欄位(如金額、user_id)加入「只允許從工具輸入,不允許模型自由發明」的規則(可在 prompt 說明、也可在 runtime 檢查來源)。

    2. 灰度上線與降級策略

    建議 rollout 策略

    1. 先鎖定 1–2 個「高價值 + 複雜」flow:
    2. 例如:整合多系統產生週報、客服自動處理退款申請。
    3. 開 feature flag:
    4. 部分租戶 / 內部帳號先用 GPT-5.5,其他維持 4.x。
    5. 監控三件事:
    6. 成單 / 解決率提升(而不是只看 token 使用量)。
    7. 平均與 P95 latency
    8. 工具錯誤率與人工介入次數
    9. 預設降級路徑:
    10. 若工具錯誤或 LLM 回傳不符合 schema,
      • 自動重試一次 GPT-5.5;
      • 仍失敗則降級到 GPT-5.4 或交由人工處理(打 label,順便收集資料)。

    💡 關鍵: 用 feature flag + 降級路徑灰度上線,可以在不影響主流程穩定性的前提下,逐步放大 GPT-5.5 的覆蓋範圍。


    結論:什麼時候立刻上 GPT-5.5?

    優先升級條件
    – 你有大量「跨系統、多步驟」任務,目前靠工程師硬寫 orchestration 邏輯維持。
    – 你在做程式碼助手、IDE 插件、CI 上的自動修 bug / 重構,現有模型常產生半成品。

    不必急著升級
    – 任務單步、邏輯簡單,或 4.x 已經穩定跑很久;
    – 成本壓力大,且沒有足夠監控來衡量 GPT-5.5 帶來的實際收益。

    合理的做法是:先用 GPT-5.5 接手最痛的 10% 任務,在舊架構外側加一層 agentic 能力,再決定是否全面遷移。

    🚀 你現在可以做的事

    • 先盤點系統中最複雜、跨多服務的 10% flow,評估是否改由 gpt-5.5 處理
    • 把現有 tools schema 補齊與收斂,為 tool_choice: "auto"json_schema 做好準備
    • 實作一個簡單的模型路由器,先在測試環境導入 gpt-5.5-pro 並觀察錯誤率與延遲指標
  • Claude Opus 4.7 實作可控 Agent 平台

    Claude Opus 4.7 實作可控 Agent 平台

    📌 本文重點

    • Opus 4.7 更適合長上下文、多步任務與自我校對
    • 可作為常駐 coding / ops Supervisor Agent
    • 透過工具層與治理設計,接手真實 CI / PR pipeline

    Opus 4.7 解決的痛點很直接:以前你不太敢把多步任務完全丟給 LLM 自動跑——上下文記不住、自我檢查不足、程式碼改著改著就壞掉、Agent 亂調工具、成本爆炸。Opus 4.7 把這幾個點同時強化:長上下文 + 自我校對 + agentic coding,讓它不再只是「聊天模型」,而是可以放進持續運行 pipeline 的一個穩定元件。


    重點說明:Opus 4.7 對 Agent 能力的實質升級

    1. 長上下文 + 自我校對 = 多步任務可「放手」

    Opus 4.7 官方強調:

    • 更長上下文:可以在一次對話裡管理整個任務歷史、spec、log、既有程式碼與錯誤紀錄,減少你自己在應用層做 chunk & stitching。
    • 自我核查輸出:模型在回傳前會傾向先「檢查」自己的推論、程式碼或計算結果,等於內建一層 lightweight critic。

    💡 關鍵: 更長上下文搭配自我核查,實際上讓多步任務可以交給單一模型從頭管到尾,而不是切給一堆臨時腳本與輔助模型。

    對多步 pipeline(例如:分析 log → 找 root cause → 編輯程式碼 → 產 PR)最大的好處是:

    • 可以讓 Supervisor Agent 一次看到完整任務 timeline,而不是一段一段 patch;
    • 減少你在系統外再包一層「審題 / 校對」模型的需求(但關鍵步驟仍建議顯式加 guardrail)。

    2. Agentic Coding:如何讓 Opus 4.7 當常駐 coding / ops agent

    Opus 4.7 在 程式碼規劃 + 工具調用 上的品質明顯提高,實務上你可以讓它做:

    • 長期追蹤一組 repo 的變更,持續提出 refactor / bugfix 建議;
    • 自動跑 CI log 分析 → 開 issue → 出 patch → 發 PR;
    • ops 向:監看監控告警 → 初步診斷 → 呼叫 runbook 工具。

    💡 關鍵: 把「讀檔、改檔、跑測試、開 PR」封裝成工具給 Opus 4.7 用,它就能長期常駐在 repo / pipeline 中當實際執行者,而不是只當輔助聊天夥伴。

    核心設計重點:

    1. 工具調用(Tool use)
    2. /v1/messages + tools 讓 Opus 負責選擇何時 call tool、填參數;
    3. 將「讀檔、改檔、跑 test、開 PR」抽成安全封裝的工具,不讓模型直接操作 Git。

    4. 程式碼修改與回滾

    5. 永遠透過 「diff-based API」 修改程式碼,而不是讓模型輸出整檔;
    6. 由工具層實作版本管理(Git branch/commit),模型只負責描述修改 intent。

    7. 安全護欄設計

    8. 角色+權限 限制工具:code_writer 不能直接 deployops_agent 只能操作 sandbox;
    9. 重要操作強制走「人審 + MCP gateway」流程。

    3. 在多代理系統中的定位:Supervisor / Orchestrator 角色

    以「Supervisor Agent」架構來看(類似 Towards AI 提到的 blueprint):

    • Opus 4.7 很適合擔任 Supervisor / Orchestrator
    • 拆解使用者目標 → 任務樹;
    • 安排子代理:搜尋 Agent、執行 Agent、評估/QA Agent
    • 維護整個任務的 context & memory。

    • MCP 或你自建的工具層則提供:

    • 可治理的工具執行(權限、審計 log、版本管理);
    • 與企業內部 API / 資料庫 / CI/CD / issue tracker 的橋接。

    重點:Supervisor 不直接做所有事,而是負責問對問題、調對工具、把任務切給對的子代理。Opus 4.7 的長上下文 +較穩定規劃能力,剛好補上這個角色。


    實作範例:自動 triage issue → 修 bug → 開 PR

    以下示意使用 Claude API + MCP / 自建工具,流程:

    1. 新 issue 建立 → Webhook 觸發 Supervisor;
    2. Supervisor(Opus 4.7)分析 issue,決定是否可自動處理;
    3. 呼叫 repo 工具 找到相關檔案、測試;
    4. 呼叫 code-agent(也是 LLM 或工具) 產生 patch;
    5. 呼叫 git/pr 工具 開 PR,必要時標記需要人工 review。

    1. Supervisor 的 messages 結構

    POST /v1/messages
    {
      "model": "claude-3-opus-4.7",  // **關鍵:Supervisor 指定 Opus 4.7**
      "system": "你是Supervisor Agent,負責協調工具與子代理.\n" +
        "規則:\n" +
        "1. 僅在需要時使用工具,不要自己幻想結果。\n" +
        "2. 高風險操作(寫檔、開PR)前,一定先提出計畫並自我檢查。\n" +
        "3. 若不確定,改為標記需要人工審核.",
      "tools": [
        { "name": "repo_search", "input_schema": {"type": "object", ...} },
        { "name": "repo_read_file", "input_schema": {"type": "object", ...} },
        { "name": "repo_edit_file_diff", "input_schema": {"type": "object", ...} },
        { "name": "run_tests", "input_schema": {"type": "object", ...} },
        { "name": "create_pr", "input_schema": {"type": "object", ...} }
      ],
      "messages": [
        {
          "role": "user",
          "content": [
            {
              "type": "text",
              "text": "有新的 GitHub issue:#1234 API 回傳 500,log ID=abcd...\n" +
                       "請決定是否可以自動修復,若可以,直接走:分析→修改→測試→開PR。"
            }
          ]
        }
      ]
    }
    

    2. 工具呼叫:diff-based 程式碼修改

    在第一次 tool call 前,先讓 Supervisor 規劃:

    1. 讀取相關檔案與測試檔。
    2. 產生修改計畫與預期影響範圍。
    3. 套用最小 diff 修改程式碼。
    4. 執行相關測試。
    5. 測試通過後建立 PR,標記『自動修復,請人工 review』。
    

    接著模型會回覆一個 tool 呼叫(格式依 SDK):

    {
      "role": "assistant",
      "content": [
        {
          "type": "tool_use",
          "id": "toolu_1",
          "name": "repo_search",
          "input": {
            "query": "500 error log id abcd", 
            "max_results": 10
          }
        }
      ]
    }
    

    你的應用層接到後:

    1. 執行 repo_search(你實作的服務,可能包 Git grep / code search);
    2. 把結果以 tool_result 回餵:
    {
      "role": "tool",
      "tool_use_id": "toolu_1",
      "content": [{
        "type": "text",
        "text": "找到可能相關檔案: src/api/user.ts, src/service/userService.ts ..."
      }]
    }
    

    之後 Supervisor 可能呼叫:

    {
      "type": "tool_use",
      "name": "repo_edit_file_diff",
      "input": {
        "path": "src/service/userService.ts",
        "diff": "@@ -42,6 +42,10 @@\n- const result = await dao.getUser(id);\n+ const result = await dao.getUser(id).catch(e => {\n+   logger.error('getUser failed', { id, err: e });\n+   throw new HttpError(500, 'USER_LOOKUP_FAILED');\n+ });"
      }
    }
    

    這裡的關鍵是:

    • repo_edit_file_diff 工具會:
    • 把原始檔讀出來;
    • 套用 diff(可用 git apply 或自寫 patch 邏輯);
    • commit 到專用 branch;
    • 回傳新的 snippet / commit id;
    • 回滾 就交給 Git:若後續測試失敗,由 Supervisor 呼叫 git_reset_to_commit(另一個工具),或人工介面一鍵 rollback。

    3. MCP / 自建工具層設計示意(pseudo code)

    // MCP Gateway / 工具伺服器(Node 範例)
    
    import express from 'express';
    import { searchRepo, editFileWithDiff, runTests, createPR } from './infra';
    
    const app = express();
    app.use(express.json());
    
    function requireRole(role: string) {
      return (req, res, next) => {
        const callerRole = req.headers['x-agent-role'];
        if (callerRole !== role) return res.status(403).send('forbidden');
        next();
      };
    }
    
    app.post('/tools/repo_edit_file_diff', requireRole('supervisor'), async (req, res) => {
      const { path, diff } = req.body;
      // 審計 log
      console.log('[AUDIT] edit_file_diff', { path, by: 'supervisor' });
      const result = await editFileWithDiff(path, diff);
      res.json(result);
    });
    
    // 其他工具類似實作...
    
    app.listen(3001);
    

    Supervisor Agent 呼叫工具時,由你的 orchestrator 轉成 HTTP request,並加上 x-agent-role: supervisor 等標頭,實作權限與審計。


    建議與注意事項:成本、延遲與治理

    1. 成本與延遲控制

    • 長上下文 ≠ 無腦塞所有東西
    • 為 Supervisor 設計 分層上下文
      • 任務規格(長期保持);
      • 當前子任務狀態(中期);
      • 最近工具回傳、log(短期)。
    • 透過你的應用層做 context summarization / state store,不要每次把整個任務歷史丟進去。

    • 對長跑任務(例如多輪 patch + test):

    • 使用 max_tokens / tool_temperature 控制回覆長度與探索度;
    • 將「細節 log」放在外部存儲,必要時讓模型用工具查詢,而不是全部當成 prompt。

    2. 避免過度「自作主張」

    Opus 4.7 的推理與自我校對更強,副作用是它會更願意自己決定事情。控制方式:

    • system 提前定義 contract
    • 任務邊界:可修改哪些 repo / namespace;
    • 停機條件
      • 測試連續失敗 N 次 → 停止修改,標記需要人工;
      • 連續無法重現 bug → 輸出完整調查報告,停止嘗試;
    • 審核步驟
      • 高風險變更必須產生「變更說明 + 風險清單」給人看。

    範例 system 片段:

    你是後端修 bug 的 Supervisor Agent,遵守以下 contract:
    - 只能操作 repo `my-service`,不可動 infra repo。
    - 若連續 2 次修改導致測試新增失敗,立即停止,輸出調查報告,等待人工處理。
    - 不得直接部署,只能開 PR,並在 PR 描述中列出:問題原因、修改內容、風險與 rollback 方式。
    

    3. 對話風格變更對既有工作流的影響

    Opus 4.7 更傾向「先思考再回答」,你會看到:

    • 回覆結構更完整,但文字量可能變多,對老工作流可能:
    • 冗長說明擾亂你原本靠 pattern matching 的 parser;
    • 原本 prompt 期待的 JSON 結構會被「多講兩句」破壞。

    💡 關鍵: 若你的系統嚴重依賴固定輸出格式,必須明確要求「只輸出 JSON」,並用 schema 驗證與重試機制包住模型。

    建議:

    • 儘量讓模型輸出 單一結構化 payload,多餘說明放在欄位內:
    {
      "plan": "文字說明…",
      "actions": [ ... ],
      "needs_human_review": true
    }
    
    • system 明確要求:僅輸出 JSON,不要額外文字,並在應用層加 schema 驗證,若解析失敗就回饋「格式錯誤,請重新輸出」。

    結論:Opus 4.7 的能力重點不是「更會聊天」,而是更適合當有邊界、有工具、有治理的 Agent 核心。只要把它放在 Supervisor 位置,搭配 MCP 或自建工具層,控制好 contract / 成本 / 權限,你就可以開始放心讓它接手一部分真實的 coding / ops pipeline,而不只是做輔助建議。

    🚀 你現在可以做的事

    • 在現有 LLM 應用中,先挑一條「分析 log → 修 bug → 開 PR」的小流程改由 Opus 4.7 當 Supervisor 嘗試落地
    • 設計一組 repo_searchrepo_edit_file_diffrun_testscreate_pr 工具,並封裝成 MCP 或內部 HTTP 服務
    • 為 Opus 4.7 Supervisor 撰寫明確的 system contract(任務邊界、停機條件、審核規則),再逐步擴大可自動處理的任務範圍
  • 讓 LLM 真的會做研究:拆解 ResearchEVO

    📌 本文重點

    • ResearchEVO 讓 LLM 直接在程式碼空間做演化搜尋
    • 論文寫作以 sentence-level RAG 確保可檢索與可驗證
    • 可拆解為可落地的 Auto-Research / Auto-ABTest / Auto-Feature-Engineering 流程

    多數所謂「AI 做研究」還停留在幫你寫 code、寫報告;ResearchEVO 解決的痛點是:讓 LLM 直接在程式碼空間裡做演化搜尋、自己排實驗、自己寫論文。從工程角度看,它提供了一個可實作的 blueprint,讓你能在公司內做 Auto-Research / Auto-ABTest / Auto-Feature-Engineering,而不是只多一個聊天機器人。


    重點說明

    1. 演化階段:LLM 驅動的「程式碼空間搜索」

    ResearchEVO 的核心是 LLM + 演化算法 操作「程式碼本身」:

    1. 程式碼空間表示
    2. 個體 = 一份可執行程式碼(例如一個 train.py 或一個 model 定義 + config)。
    3. 用 LLM 實作 變異 / 交配
      • 變異:改損失函數、網路結構、優化器、訓練 schedule。
      • 交配:將兩個高適應度方案的關鍵設計融合。
    4. 不做 AST 級別操作也可以,實務上多數情況直接用 自然語言 prompt + code diff 就夠用。

    5. fitness 評估與搜索控制

    6. fitness 只看 metrics:例如 val_accuracyAUClatency
    7. Search loop:
      1. LLM 生成/修改程式碼。
      2. 提交到 GPU/雲端排程系統跑實驗。
      3. 收集結果 → 更新種群 → 再交給 LLM 反思與生成。
    8. 約束控制 避免亂飛:
      • 硬約束:只允許改特定檔案 / 函數;強制保持 I/O 介面不變。
      • 軟約束:LLM prompt 中加入「只動這幾個維度」「保留下列設計」。

    💡 關鍵: 把 fitness 完全交給客觀 metrics(如 val_accuracylatency),可以讓 LLM 的創意探索與實際效能緊密對齊。

    1. 對接現有 GPU / 雲端排程
    2. ResearchEVO 本身不是新的 scheduler,而是:
      • 上游:LLM 生成/修改 code & config。
      • 下游:把 job 提交給你已有的 Kubernetes / Slurm / Airflow / SageMaker / Vertex AI
    3. 你只需要做一層 adapter,把 ExperimentSpec → Job 映射好。

    2. 寫作階段:sentence-level RAG + 驗證

    演化出最佳演算法後,ResearchEVO 的寫作階段是在做 「可檢索、可驗證」的自動論文生成

    1. 論文結構模板
    2. 先固定一個論文 schema(Title / Abstract / Intro / Method / Exp / Discussion / Related Work)。
    3. 每個 section 再細分成 段落 level 的子任務,讓 LLM 聚焦生成。

    4. 句子級 RAG(sentence-level RAG)

    5. 檢索單位不是 chunk,而是句子
      • 實驗 log、表格、程式碼註解、對照文獻都 embed 成 sentence vector。
      • 每當 LLM 要生成一個句子,就檢索最相關的 3~5 個 evidence。
    6. 這樣可以:
      • 降低 context 噪音。
      • 讓每句話都有「引用依據」。

    💡 關鍵: 以「句子」為檢索單位,讓每一句論文敘述能精確對應到 3–5 條證據,大幅降低幻覺與錯引。

    1. 事實核查與防幻覺
    2. 對每一句包含數字、claim 的句子,送到 Verifier agent
      • 檢查是否能在實驗結果 / log / paper corpus 中找到支持證據。
      • 找不到就要求 LLM 重寫或改成不那麼強的 claim。
    3. 論文內引用的實驗表格、圖表,ID 必須能對回到真實跑出的 artifacts(例如 MLflow run id / S3 path)。

    3. 如何落地 Auto-Research / Auto-ABTest / Auto-Feature-Engineering

    你不一定要重現完整 ResearchEVO。實務上可以拆成:

    • 一個 orchestrator(Airflow / Prefect / Dagster / LangGraph)
    • 幾個 LLM agent(code 生成 / 反思 / 寫作)
    • 一個實驗調度器(K8s / Slurm / 自家平台)
    • 一個結果分析工具(MLflow / Weights & Biases / 自製 dashboard)

    核心流程:

    1. 目標定義
    2. LLM 生成候選方案
    3. 實驗排程跑
    4. 收集結果 & 自動分析
    5. LLM 反思改進
    6. 收斂後自動產出報告/論文

    💡 關鍵: 把「做研究」拆成可編排的 6 步驟流程後,Auto-Research 就變成一組可插拔模組,而不是神秘黑盒。


    實作範例

    以下用 Python + Airflow/LangGraph 說明一個簡化版 pipeline。

    1. 演化 loop 的 code 表示與變異

    假設我們把「演算法個體」抽象成一個簡單的 spec:

    from pydantic import BaseModel
    from typing import Dict, Any
    
    class AlgoSpec(BaseModel):
        name: str
        base_script: str              # 參考模板路徑
        hyperparams: Dict[str, Any]   # 学习率, layer 数等
        patches: str                  # LLM 產生的程式碼 patch (diff-like)
    

    讓 LLM 做「變異」:

    SYSTEM_PROMPT = """你是資深 ML 研究員,幫我在保持 I/O 介面不變的前提下,
    只修改 loss function、網路架構與訓練策略。輸出 unified diff 格式的 patch。"""
    
    user_msg = f"""
    目前的程式碼:
    {current_code}
    
    本輪實驗結果:
    val_accuracy = {metrics['val_acc']}
    train_loss_curve = {metrics['loss_curve'][:10]}
    
    請根據結果給出改進 patch。"""
    
    resp = llm.chat([
        {"role": "system", "content": SYSTEM_PROMPT},
        {"role": "user", "content": user_msg},
    ])
    
    patch = extract_patch(resp)  # 解析成純文本 diff
    new_spec = AlgoSpec(
        name=f"algo_v{gen_id}",
        base_script="templates/train_base.py",
        hyperparams={"lr": 3e-4, "hidden_dim": 512},
        patches=patch,
    )
    

    接著用簡單的 patch engine 把 diff 套進檔案,產生下一版 train.py


    2. 串接實驗排程(以 K8s Job 為例)

    假設有一個內部的 submit_experiment(spec: AlgoSpec) -> str 會幫你:

    1. 打包 code + config 到 image/volume。
    2. 生成 K8s Job yaml。
    3. 提交到 cluster,回傳 job_id

    簡化 pseudo-code:

    import kubernetes as k8s
    
    def submit_experiment(spec: AlgoSpec) -> str:
        job = build_k8s_job(spec)  # 填入 image, args, resource 限制
        api = k8s.client.BatchV1Api()
        resp = api.create_namespaced_job(namespace="research", body=job)
        return resp.metadata.name
    
    # fitness 評估:等 job 完成,讀取 metrics.json
    
    def fetch_fitness(job_id: str) -> float:
        # 假設每個 job 在 /results/metrics.json 寫入 val_acc
        metrics = load_from_object_store(f"results/{job_id}/metrics.json")
        return metrics["val_acc"]
    

    你只要確保:

    • 所有實驗都寫出 統一格式的 metrics.json / config.json
    • job name、run id 能對應回實驗記錄系統(MLflow、W&B)。

    3. Orchestrator:以 LangGraph 為例構建演化 DAG

    LangGraph 可以把 LLM、工具、迭代邏輯包成圖:

    from langgraph.graph import StateGraph, END
    
    class EvoState(BaseModel):
        population: list[AlgoSpec]
        history: list[dict]
        generation: int
    
    
    def propose_candidates(state: EvoState) -> EvoState:
        # 用 LLM 對每個 top-k spec 做變異
        ...
    
    
    def run_experiments(state: EvoState) -> EvoState:
        # 提交所有 candidates,等待完成,回寫 fitness
        ...
    
    
    def select_and_check_stop(state: EvoState) -> str:
        if state.generation >= MAX_GEN:
            return END
        return "propose"
    
    
    graph = StateGraph(EvoState)
    
    graph.add_node("propose", propose_candidates)
    graph.add_node("run", run_experiments)
    
    graph.add_edge("propose", "run")
    
    graph.add_conditional_edges("run", select_and_check_stop, {"propose": "propose", END: END})
    
    evo_app = graph.compile()
    

    後面你可以在另一個 graph 裡接上 writing phase:以最優 AlgoSpec + 實驗結果為輸入,調用 sentence-level RAG agent 生成報告或論文。


    4. sentence-level RAG 實作簡例

    from sentence_transformers import SentenceTransformer
    from qdrant_client import QdrantClient
    
    encoder = SentenceTransformer("all-mpnet-base-v2")
    qdrant = QdrantClient(host="localhost", port=6333)
    
    # 建 index:把實驗 log、表格、文獻拆成句子
    
    def index_sentences(sentences: list[str], meta: list[dict]):
        vecs = encoder.encode(sentences)
        qdrant.upsert(
            collection_name="research_corpus",
            points=[{"id": i, "vector": v, "payload": meta[i]} for i, v in enumerate(vecs)],
        )
    
    
    def retrieve_evidence(query_sentence: str, k: int = 5):
        qvec = encoder.encode([query_sentence])[0]
        hits = qdrant.search("research_corpus", query_vector=qvec, limit=k)
        return hits
    
    # LLM 每寫一句話前,先取 evidence
    
    claim = "在 QEC 任務上,我們的演算法平均錯誤率降低了 12.3%。"
    evidences = retrieve_evidence(claim)
    llm_context = format_evidence(evidences)
    
    resp = llm.chat([
        {"role": "system", "content": "根據下面的實驗證據,生成一個對應的結論句。"},
        {"role": "user", "content": llm_context},
    ])
    

    再加一個 Verifier:重新檢索一次,看 claim 是否可被證據支持,不行就標記為需重寫。


    建議與注意事項

    1. 實驗結果格式不一致

    • :每個實驗 script 隨意 print,LLM/agent 很難 parse,fitness 評估混亂。
    • 建議
    • 強制所有實驗輸出 統一 schema 的 JSON,例如:
      • metrics.json{"val_acc": 0.92, "train_time": 360}
      • config.json(完整 hyperparams)。
    • schema 驗證(Pydantic)檢查 artifact;不合法就標記這個個體為低適應度。

    2. LLM 收斂到壞思路 / mode collapse

    • :LLM 易過度放大小樣本成功設計,反覆微調同一個局部解,失去探索。
    • 建議
    • 搜索策略上引入 探索度控制:族群裡保留一部分「純隨機變異」個體。
    • 每 N 代重啟一次高多樣性的種群(借鑑 evolutionary algo 的 restart 策略)。
    • LLM prompt 中顯式要求「給出三類不同思路」,避免只改超參數。

    3. 成本與資源控制

    • :LLM + GPU 雙重成本,很容易跑成燒錢機器。
    • 建議
    • 在 orchestrator 層面設 hard budget:最大世代數、最大 job 數、最大雲端花費。
    • 用低成本模型做日常迭代,大模型只用在 跨世代總結 / 報告撰寫
    • 優先讓 LLM 做 靜態檢查(例如檢查明顯錯誤設計)再送去跑 GPU。

    4. LLM 對數據科學工具的錯用

    • :LLM 可能亂用 API(例如 pandas groupby 用錯、Sklearn split 漏掉 stratify),結果漂亮但不可信。
    • 建議
    • 對關鍵 API(train/test split、metrics 計算、cross-validation)儘量做成 封裝好的 utility 函數,禁止 LLM 自己寫這些低級邏輯。
    • 在 pipeline 裡加入 sanity check step
      • label 分布是否合理?
      • baseline 是否被超過?
      • 結果是否疑似 data leakage?

    5. 開始時先做「窄版」

    • 不要一開始就做「全自動研究員」。較務實的起點:
    • Auto-ABTest:讓 LLM 只改部分業務策略 / feature 配置,實驗系統沿用現有 AB 平台。
    • Auto-Feature-Engineering:LLM 只負責產生特徵轉換 pipeline(例如 SQL / PySpark),模型訓練沿用既有框架。
    • 寫作階段先只產出 自動實驗報告(非論文),幫團隊省時間。

    從工程的角度看,ResearchEVO 真正帶來的啟發是:

    把「做研究」拆成可編排的演化搜尋 + sentence-level RAG 寫作兩個 pipeline,然後用現成的 LLM、orchestrator、GPU 排程系統拼起來。

    只要你公司已經有基本的實驗平台,做一個自己的「輕量版 ResearchEVO」其實沒有想像中難,但能快速幫你把實驗速度和研究產出拉一個量級。

    🚀 你現在可以做的事

    • 先為現有實驗腳本統一輸出 metrics.json / config.json schema,打好 Auto-Research 地基
    • 選一個任務,用一個 LLM agent + 既有 K8s/Slurm 搭出最小可用的演化搜尋 loop
    • 把歷史實驗 log 拆成句子建一個向量索引,試做 sentence-level RAG 自動實驗報告生成