anthropics/commerce-agents：電商 agent 的官方參考實作

這是〈The Anatomy of Effective Commerce Agents〉那篇文章的官方參考實作。文章講原理，這個 repo 給可以跑的程式碼。

這是什麼

Anthropic 官方釋出的電商 agent 範本專案。裡面有兩個做好的 agent：購物 agent（給消費者——找商品、比較、規劃購買、管購物車、回答訂單與政策問題）和商家 agent（給店家員工——看營運數字、維護商品、處理庫存與訂單警報、管定價促銷）。

核心概念怎麼運作

它不是一個可以安裝的套件，是一份拿來拄的完整範本。重點在四個產業的可執行範例，每個都有能跑的店面和後台：零售（基本的搜尋結帳）、旅遊（綁日期的庫存、行程組裝、房況日曆）、電信（帳戶脈絡、資費比較表、受規範的費用揭露）、娛樂票務（限時保留、候補名單、場地圖）。

商家 agent 有一個重要設計：所有寫入動作都是暫存的，要人批准才生效。這是文章裡「模型只提案」原則的實際實作。

提供三種執行方式（Messages API、Claude Agent SDK、Managed Agents），後端透過 MCP 串接、可抽換。另附一個 Claude Code plugin（commerce-builder），能幫你搭新 agent 的骨架或審查現有的。

解決什麼問題

看文章知道原則，但不知道實際写出來長什麼樣。這個 repo 把抽象原則變成跑得起來的東西，可以直接開來玩、可以拆開看。

用到哪些東西

Python 3.11+、Node 22、Claude API、MCP。三步跑起來：clone、把 API key 填進 .env、python scripts/run_demo.py retail（API 在 8000、店面在 3000）。文件分三份：docs/safety.md（安全規則）、docs/backends.md（怎麼接自己的系統）、docs/deployment.md（上雲）。

注意事項：公司商品全是虛構的，不會真的下單扣款；範例沒有身分驗證。Apache 2.0 授權，但官方註明不維護、不收 PR——它是範本，不是可以依賴的套件。

前置知識

要看懂得會 Python。不寫程式的人也能把 demo 跑起來看介面——這部分只需要複製貼上三行指令。