Claude Workbench 舊版 8 月 17 日退場:Prompt、Eval 與檔案怎麼匯出
如果你以前把 Claude Workbench 當成 prompt library 或簡易 eval 工具,現在要先處理資料保存。Anthropic 官方 release notes 說明,Workbench legacy 會在 2026 年 8 月 17 日對所有使用者退場;新版 Workbench 不支援舊版的 saved prompts、prompt history 和 evals。
這不是 Claude Messages API 整體下線。真正需要分流的是三件事:舊 Workbench 資料要不要保存、程式碼是否仍呼叫 experimental prompt tools,以及新 Workbench 能不能承接你的測試流程。先完成匯出,再決定要把 prompt 搬到 repository、測試工具或其他管理方式。
先分清楚 Workbench legacy 與新版
兩個入口名字相同,但保存模型不同。新版 Workbench 主要是用來試跑 Claude model 和 API 功能;舊版則保存 prompt、版本、completions,並提供 eval 相關工作流。
| 項目 | Workbench legacy | 新版 Workbench |
|---|---|---|
| 使用狀態 | 既有使用者可用至 2026-08-17 | 可在 Claude Console 試跑模型與 API 功能 |
| Prompt history | 可存取舊資料 | 不保存 prompt history |
| Prompt versions | 可匯出 | 不支援 |
| Eval | 可匯出相關資料 | 不提供舊版 eval 工作流 |
| Completions、上傳檔案 | 可在匯出時選擇 | 不會自動匯入 |
| 程式碼 | 可取得舊版範例 | 可從目前 request 匯出 code snippet |
Anthropic Help Center 也說明,新版 Workbench 的目前草稿留在瀏覽器,並直接對應公開的 Messages API request;它不是一個會自動接手舊資料的 prompt database。
8 月 17 日前的匯出流程
如果你仍看得到 legacy 入口,建議為每個 workspace 執行一次,不要只匯出自己最常用的 prompt。
- 登入 Claude Console,開啟 Workbench legacy。
- 先查看 prompt list,確認需要保存的 prompt、prompt revisions、completions 和 eval。
- 點選頁面上方的 Export data。
- 在匯出對話框選擇要包含的資料;除了 prompts,也可選 Model completions 和 Uploaded files。
- 點選 Export,等待 Anthropic 寄送 JSON 匯出下載連結。
- 下載後在本機解壓或保存,檢查 prompt 數量、版本與附件是否真的包含在內。
官方說明指出,選擇 completions 或上傳檔案可能讓匯出檔變大;若團隊有多個 workspace,也要分別確認資料歸屬,避免只保存到個人帳號的資料夾。
匯出檔先做敏感資料檢查Prompt、completion 和上傳檔案可能含有 API response、客戶資料、內部規格或測試金鑰。下載後先移除不應進 Git 的內容,再決定要存到私有 repository、加密儲存或團隊文件系統;不要為了方便把原始 JSON 直接放進公開 repository。
匯出後要保存什麼,不要只保存 JSON
JSON 是資料備份,不一定是未來可重跑的測試套件。我會把匯出內容再整理成三層:
- Prompt source:保留 system prompt、user prompt、模型、temperature、max tokens 和使用的工具定義。
- Test cases:從原本的 eval 或人工測試中挑出輸入、預期行為、不可接受的輸出與判定理由。
- Reference outputs:保存少量經過審核的 completion,並標記模型、日期和用途,不把它當成永久正解。
如果這些 prompt 會用在 coding agent,還要把「允許讀哪些資料、是否能呼叫外部工具、誰負責審核輸出」一併寫入 README。這比把一整份匯出檔丟進資料夾更容易在半年後重建流程。
檢查程式碼是否仍呼叫 experimental prompt tools
Workbench legacy 的退場也會影響使用 Claude Platform experimental prompt tools 的程式。官方 release notes 列出的 endpoint 包含:
/v1/experimental/generate_prompt/v1/experimental/improve_prompt/v1/experimental/templatize_prompt
官方表示這些 endpoint 會在 8 月 17 日隨 Workbench 一起退休,移除後請求會回傳錯誤。可以先在 application 和部署設定中搜尋:
rg -n \ 'experimental/(generate_prompt|improve_prompt|templatize_prompt)|generate_prompt|improve_prompt|templatize_prompt' \ . \ --glob '!node_modules/**' \ --glob '!dist/**'命中後先確認它是文件、測試,還是真的 production code。官方公告沒有承諾這些 endpoint 會自動改寫成另一個 API,因此不要只把 URL 替換成猜測的路徑;先記錄目前輸入、輸出、錯誤處理和 fallback,再依公開的 Messages API 或自有評測流程重新實作。
新版 Workbench 能做什麼
若你的需求是「試一個模型、看 request/response、確認 token usage,再匯出可執行程式碼」,新版 Workbench 仍然適用。它可以:
- 選擇模型與調整 temperature、maximum output tokens。
- 測試 tools 和 structured outputs。
- 查看 raw request、raw response、stop reason 與 usage。
- 透過 code toggle 匯出目前 request 的程式碼片段。
但新版不會保存 prompt history、prompt versions、eval 或 prompt sharing,也不能把 legacy 匯出資料直接 import 回去。需要長期追蹤的 prompt 和測試案例,應搬到可版本控制、可審核的儲存方式,而不是繼續把瀏覽器中的當前草稿當成備份。
一份可以在今天完成的遷移清單
- 逐一登入仍有 legacy 存取權的 workspace。
- 匯出 prompts、prompt versions、需要的 completions、eval 和上傳檔案。
- 下載 JSON 並檢查附件、敏感資訊與資料完整性。
- 搜尋 codebase 是否使用三個 experimental prompt tools endpoint。
- 把重要 prompt 和 eval case 整理成可版本控制的格式。
- 用新版 Workbench 或 Messages API 重跑最小測試,記下輸入、模型、日期和差異。
- 在 2026-08-17 後再做一次 smoke test,確認正式環境沒有依賴已退休 endpoint。
這次變動最需要把握的不是新版 Workbench 的介面,而是保存期限。先把 legacy 資料拿出來,再決定哪些內容要變成 prompt source、測試案例或程式碼,遷移成本會比事後重新猜測舊設定低很多。
常見問題
Q: Workbench legacy 退場會讓 Claude Messages API 一起停止嗎?
A: Anthropic 公告的退場範圍是 Workbench legacy 與三個 experimental prompt tools endpoint;新版 Workbench 本身直接建立在公開 Messages API 上。不要把 Workbench 介面退場解讀成 Messages API 一起下線,但仍要單獨確認 application 使用的 endpoint。
Q: 新版 Workbench 可以匯入舊版 prompt 和 eval 嗎?
A: 不行。官方 Help Center 說明新版 Workbench 不保存舊版 prompt、prompt history、prompt versions 或 eval,也沒有 legacy data import。請在 8 月 17 日前用 legacy 的 Export data 保存,再由團隊自行整理成版本控制或測試工具可讀的格式。
Q: 只保存 prompts,不匯出 completions 可以嗎?
A: 如果只需要保留輸入模板,可以;但若你要重建 eval、比較模型輸出或追查歷史決策,就應一併匯出需要的 completions 和上傳檔案。匯出前先檢查敏感資料,避免把原始 response 當成可以公開分享的測試資料。
參考資料:
回報錯字、失效連結,或告訴我你想看的延伸主題。