---
title: 商務代理
url: https://platform.claude.com/docs/zh-TW/about-claude/use-case-guides/commerce-agents
description: 使用 Claude for commerce 在 Claude 上建構購物代理和商家代理。Claude for commerce 是一個開源藍圖，提供在 Messages API、Claude Agent SDK 和 Claude Managed Agents 上的可運作實作。
---

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

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

<Note>
  此藍圖是供您分叉（fork）並調整的參考實作，並非受支援的產品或託管服務。
</Note>

## 購物代理

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

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

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

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

## 商家代理

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

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

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

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

## 產業範例

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

| 產業 | 商店前台                              | 商家入口網站                               |
| -- | --------------------------------- | ------------------------------------ |
| 零售 | 使用內建元件提供搜尋、比較、規劃、購物車、結帳和記憶功能      | 每日摘要、暫存的補貨與刊登修正，以及在 SQL 檢視上運作的分析委派代理 |
| 旅遊 | 有日期限制的庫存和行程元件                     | 入住率行事曆和特定日期區間的房價調整                   |
| 電信 | 帳戶上下文、方案比較表，以及由伺服器撰寫的費用揭露         | 方案組合、會說明受影響門號的價格調整，以及受保護的法規費用        |
| 娛樂 | 限時保留、候補名單、票券轉讓、場館座位圖，以及含所有費用的總價揭露 | 活動銷售進度、能釋出實際座位容量的保留釋放，以及保留費用結構的價格調整  |

## 執行環境

Messages API 和 Agent SDK 執行環境可以搭配 Claude API、[Amazon Bedrock](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-amazon-bedrock)、[Google Cloud's Agent Platform](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-on-vertex-ai) 或 [Microsoft Foundry](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-microsoft-foundry) 執行，也可以透過您自己的閘道執行。Claude Managed Agents 路徑則在 Claude API 上執行。儲存庫中的部署指南說明了每條路徑在何處選擇平台，以及各自需要的模型 ID 格式。

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

此藍圖隨附一個 [Claude Code](https://code.claude.com/docs/zh-TW/overview) 外掛程式。該外掛程式會以複製下來的儲存庫作為參考，針對您自己的系統建構代理。它的四個指令涵蓋從零開始到完成測試代理的完整流程：

| 指令                         | 功能                                             |
| -------------------------- | ---------------------------------------------- |
| `/scaffold-commerce-agent` | 詢問您的技術堆疊，向您複述規劃內容，然後以參考套件為基礎，建立購物代理、商家代理或兩者的骨架 |
| `/add-commerce-flow`       | 為現有代理新增一個流程：複製該流程的技能、串接它呼叫的工具，並撰寫第一批評估案例       |
| `/author-commerce-evals`   | 建構評估套件，內容包括執行器、針對您自己商品目錄的第一批案例，以及用於 CI 的重播關卡   |
| `/review-commerce-agent`   | 分析您已在執行的代理，將其與參考實作比較，並轉換您選擇的部分                 |

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

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

## 開始使用

<CardGroup cols={2}>
  <Card title="GitHub 上的 Claude for commerce" icon="github-logo" href="https://github.com/anthropics/commerce-agents">
    複製藍圖，並在本機執行兩個代理。
  </Card>

  <Card title="有效商務代理的剖析指南" icon="book" href="https://claude.com/blog/the-anatomy-of-effective-commerce-agents">
    了解這些代理的建構方式及設計理由。
  </Card>
</CardGroup>