最佳實務使用案例

商務代理

Copy page



使用 Claude for commerce 在 Claude 上建構購物代理和商家代理。Claude for commerce 是一個開源藍圖，提供在 Messages API、Claude Agent SDK 和 Claude Managed Agents 上的可運作實作。

本指南說明如何在 Claude 上建構商務代理。其中一個是購物代理，供客戶在您的應用程式中使用；另一個是商家代理，供經營商店的人員使用，這些人員可能是企業自己的營運人員，也可能是其平台上的賣家。本指南以 Claude for commerce 為基礎。Claude for commerce 是一個開源藍圖，內容包括：每個代理在 Messages API、Claude Agent SDK 和 Claude Managed Agents 上的可運作實作；適用於零售、旅遊、電信和娛樂產業的可執行範例；以及一個 Claude Code 外掛程式，可依照相同設計，針對您自己的系統建立專案骨架。

程式碼、設定說明和安全文件都位於 GitHub 上的 Claude for commerce 儲存庫。若想了解這些代理的建構方式及設計理由，請閱讀工程文章 A guide to the anatomy of effective commerce agents。文章涵蓋的主題包括：「single-agent-with-skills」（單一代理搭配技能）設計、以工具形式提供的 UI 元件、由「harness」（執行框架）強制執行的安全機制、「prompt caching」（提示快取）、「memory」（記憶），以及「evals」（評估）。

購物代理

購物代理位於您的應用程式中，並透過單一後端介面存取您的系統。您需要在自己的商品目錄、購物車、偏好設定、訂單、政策和出貨服務之上實作這個介面。該介面上沒有任何方法能下訂單或轉移款項。在對話中，代理可以：

• 搜尋商品目錄、比較最終候選商品，並將客戶描述的需求轉化為候選清單和推薦。
• 針對某個目標（例如一趟旅行、一場活動或一個房間）規劃一組相互搭配的商品，並使其符合預算。
• 以在對話中呈現的 UI 元件顯示商品、比較、規劃、訂單狀態和購物車。
• 將商品加入購物車，並轉交給您的結帳流程。
• 根據您自己的訂單和政策系統，回答有關訂單、配送、退貨和政策的問題。
• 記住客戶要求它記住的內容，並在之後的工作階段中套用。

代理有五項技能，會依需求載入，分別涵蓋搜尋與探索、購買研究、目標導向規劃、客戶服務，以及記憶與個人化。代理在大多數回合都需要遵循的規則則放在「system prompt」（系統提示）中，例如資訊依據、購物車與結帳的語意，以及呈現方式。

代理只會根據對話中的工具結果陳述商品、價格、庫存狀況和商店條款。寫入購物車時，只接受該工作階段中由商品目錄或訂單工具傳回的商品 ID。結帳時，代理會準備一份摘要，由客戶在您的應用程式中確認。如果您使用託管結帳，您的後端會傳回其 URL，並由主機應用程式直接呈現，不會經過模型。

商家代理

商家代理為經營商店的人員提供支援。它透過自己的後端介面存取您的分析、商品目錄、庫存、定價和行銷活動系統，並且可以：

• 說明業務表現，例如某項指標為何變動、由哪個客群帶動，以及與可比較期間相比的進度。選用的分析委派代理會在時間和資料量預算內執行唯讀查詢。
• 提供每日摘要，列出需要關注的事項，包括庫存不足、滯銷商品和訂單異常。
• 根據營運人員提供的資料，改善商品刊登內容並修正商品目錄資料。
• 在商店的防護規則範圍內建議價格調整和促銷活動，並提供利潤預覽。
• 草擬行銷活動，包括目標受眾、版位和預算。

它的五項技能分別涵蓋績效洞察、庫存與營運、商品目錄與刊登、定價與促銷，以及行銷活動。

商家代理提出的每一項寫入操作，包括刊登更新、價格調整、庫存操作、促銷或行銷活動，都會成為一項暫存變更。每項暫存變更都有一個由伺服器產生的 ID，營運人員會以預覽卡片的形式看到它。系統會在暫存變更時檢查防護規則，並在套用變更時再次檢查。這些規則包括最大價格變動幅度、促銷折扣深度、補貨數量、行銷活動預算和受保護欄位。變更必須由人員在對話之外核准後才會套用。在 Messages API 路徑上，核准方式是商家入口網站中的按鈕；在 Agent SDK 主控台中，是確認提示；在 Claude Managed Agents 上，則是套用工具上的一律詢問權限政策。在聊天中輸入的核准不具任何效力。

產業範例

每個範例都包含一個客戶商店前台和一個商家入口網站，並使用虛構資料。

執行環境

Messages API 和 Agent SDK 執行環境可以搭配 Claude API、Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry 執行，也可以透過您自己的閘道執行。Claude Managed Agents 路徑則在 Claude API 上執行。儲存庫中的部署指南說明了每條路徑在何處選擇平台，以及各自需要的模型 ID 格式。

使用 Claude Code 外掛程式建構您自己的代理

此藍圖隨附一個 Claude Code 外掛程式。該外掛程式會以複製下來的儲存庫作為參考，針對您自己的系統建構代理。它的四個指令涵蓋從零開始到完成測試代理的完整流程：

此外掛程式還包含六項技能，主題分別是架構、提示快取、以工具形式提供的 UI、信任與安全、評估，以及商家營運。只要 Claude Code 對話內容與這些技能相符，就會載入對應的技能。安裝說明請參閱儲存庫的 README。

如果您想改為手動調整參考實作，請依照以下步驟進行：在您的服務之上實作購物或商家後端介面；使用設定旗標關閉您沒有的系統，讓相關工具和提示內容不再出現；然後設定您的品牌名稱、助理名稱和語氣。儲存庫中的後端指南會逐步說明身分與憑證、有順序的流程、結帳轉交，以及具有選項的商品。試行專案可以只實作搜尋和商品詳細資料，其餘部分先以虛設常式（stub）代替。

開始使用