本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 列出 SaaS API 型 AI 代理程式產品
<a name="listing-saas-ai-agents"></a>

身為 AWS Marketplace 賣方，您可以將軟體新增為服務 (SaaS) API 型 AI 代理程式或工具產品 AWS Marketplace。這包括根據您的帳單模型建立您的產品，並將其與適當的 AWS Marketplace API 操作整合。

若要在 中以 SaaS API 型 AI 代理器或工具產品的形式銷售軟體 AWS Marketplace，請遵循下列步驟：
+ 在其中建立 SaaS API 型 AI 代理器或工具產品 AWS Marketplace。
+  AWS Marketplace 根據您的定價模式，將您的 產品與 整合：
  + 如需訂閱型產品的相關資訊，請參閱 [將您的 SaaS 訂閱或Pay-As-You-Go產品與 整合 AWS Marketplace](saas-integrate-subscription.md)。
  + 如需有關以合約為基礎的產品的資訊，請參閱 [將您的 SaaS 合約產品與 整合 AWS Marketplace](saas-integrate-contract.md)。
  + 如需與pay-as-you-go產品簽訂合約的相關資訊，請參閱 [將您的 SaaS 合約型產品與 整合 AWS Marketplace](saas-integrate-contract-with-pay.md)。
+ 測試您產品的整合：
  + 如需測試訂閱型產品的相關資訊，請參閱 [測試您的 SaaS 訂閱產品整合](saas-integrate-subscription.md#saas-subscription-integration-testing)。
  + 如需有關測試以合約為基礎的產品的資訊，請參閱 [測試您的 SaaS 合約產品整合](saas-integrate-contract.md#saas-contract-integration-testing)。
  + 如需使用即pay-as-you-go產品測試合約的相關資訊，請參閱 [使用隨需pay-as-you-go整合測試您的 SaaS 合約](saas-integrate-contract-with-pay.md#saas-contract-consumption-integration-testing)。
+ 提交您的產品以啟動。

## 先決條件
<a name="saas-ai-agents-prerequisites"></a>

開始之前，請確定您有下列項目：
+ 清楚了解您的 AI 代理器功能和目標使用案例
+ 適當的安全措施和合規認證
+ 整合和部署的技術文件
+ 與您的商業模式一致的定價策略
  + 如需定價策略的詳細資訊，請參閱 [中的 SaaS 產品定價 AWS Marketplace](saas-pricing-models.md)。

## 管理 SaaS API 型 AI 代理器和工具
<a name="managing-saas-ai-agents"></a>

所有以 SaaS API 為基礎的 AI 代理器和工具都可以透過統一 **AI 代理器和工具**產品頁面或 AWS Marketplace 管理主控台中的 **SaaS** 產品頁面進行管理。

## 啟動清單精靈
<a name="start-listing-wizard"></a>

1. 登入 [AWS Partner Central](https://us-east-1.console.aws.amazon.com/partnercentral/home)。

1. 在導覽列中，選取**建置**，然後選擇 **AI 代理器和工具**。

1. 從**建立 AI 代理程式和工具產品**功能表中，選擇 **API 型 AI 代理程式和工具**。

1. 輸入產品標題。

1. 選擇**產生產品 ID 和產品代碼**。

1. （選用） 新增標籤以支援標籤型授權。

1. 選擇**繼續精靈**。

**注意**  
如需標籤型授權的相關資訊，請參閱《[AWS Identity and Access Management 使用者指南》中的使用標籤控制對 AWS 資源的存取](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources)。 AWS Identity and Access Management 

## 步驟 1：提供產品資訊
<a name="step-1-product-information"></a>

您在此步驟中提供的資訊會傳達產品的價值主張。

**使用 AI 輔助產品清單**  
您可以使用 AWS 合作夥伴助理中的 AI 輔助產品清單，從網站 URL 或上傳的文件產生此步驟的產品資訊。工具會根據 AWS Marketplace 標準對列出品質進行評分，並提供欄位層級建議，以在提交之前改善可探索性和買方參與度。如需詳細資訊，請參閱[AI 輔助產品清單](ai-assisted-product-listing.md)。

1. 提供產品資訊索引標籤的詳細資訊：
   + **產品標題**
   + **SKU** （選用）
   + **產品標誌 S3 URL**
   + **簡短描述**
   + **長描述**
   + **產品影片 URL** （選用）
   + **反白 **(1-3)

1. 透過選擇新增資源，輸入支援詳細資訊並新增選用的學習**資源**。

1. 在**產品類別**功能表中，選擇 1-3 個類別。
   + 我們建議您從 **AI Agents & Tools** 商業類別中至少選擇一個類別。

1. 輸入關鍵字以改善搜尋可探索性。

1. （選用） 根據準則新增影片和影像資產。

1. 選擇**下一步**。

## 步驟 2：設定履行選項
<a name="step-2-fulfillment-options"></a>

1. 選擇履行方法：
   + **快速啟動** （建議） - 賣方與[AWS Marketplace 部署 API](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_Operations_AWS_Marketplace_Deployment_Service.html) 整合，並在訂閱時將 API 金鑰直接提供給客戶的 AWS 帳戶。
   + **重新導向至您的網站** - 客戶將重新導向至您的網站，以取得 API 金鑰或 OAuth 權杖。
**注意**  
您無法在發佈產品後變更履行方法。

1. 輸入履行 URL。這是使用者登入或建立帳戶的 URL。

1. 選擇您的 AI 代理器或工具詳細資訊：
   + **AI 代理程式** - 使用 AI 透過推理和決策處理請求並完成任務的軟體。
   + **AI 工具**：
     + **MCP 伺服器** - 管理 AI 模型和應用程式之間的通訊和內容交換的伺服器。
     + **知識庫** - AI 代理器用於通知決策和回應的結構化資訊集合。
     + **護欄** - 定義 AI 代理器行為和操作界限的規則和控制項。
     + **其他** - 增強 AI 代理器功能的其他工具。

1. 輸入端點 URL。這是您的 API 接收請求的 URL。對於 MCP 伺服器，列出 MCP 端點。
   + **靜態端點** – 輸入不含參數的固定 URL。例如：`https://api.example.com/v1/mcp`。
   + **動態端點** – 使用`{paramName}`語法輸入包含一或多個預留位置參數的 URL。例如：`https://{tenantId}.apps.example.com/v1/mcp`。

     動態端點會在訂閱後解析為買方特定的 URLs。選擇此選項時，您必須使用 **Quick Launch** 履行方法。

     設定您的端點 URL 參數：
     + **名稱** （必要） – 符合您 URL 中預留`{paramName}`位置的機器識別符。名稱必須以字母開頭，且只包含字母、數字和底線。長度上限為 64 個字元。
     + **描述** （選用） – 向買方顯示的說明文字，說明 參數的用途。
     + **預設值 **（選用） – 尚未交付買方特定值時使用的備用值。值可包含字母、數字、連字號、句點、底線和波紋。長度上限為 256 個字元。
**注意**  
每個端點最多可以定義 5 個參數。URL 中的每個`{paramName}`預留位置都必須有相符的參數項目，而且每個參數項目都必須對應至 URL 中的預留位置。

     買方訂閱後，請呼叫 `PutDeploymentParameter` API 操作以提供買方特定的參數值。Fulfillment Widget 會使用交付的值自動解析最終 URL。如需詳細資訊，請參閱[交付動態端點參數](integrating-api-ai-agents-tools.md#dynamic-endpoint-parameter-delivery)。

1. 新增使用說明：
   + 提供買方使用 API 的詳細指示，例如 API 結構描述、速率限制和用量範例。
   + 您也可以提供文件的其他連結。

1. 選擇授權方法：
   + **API 金鑰** – 客戶使用您提供的 API 金鑰進行身分驗證。
   + **OAuth** – 客戶使用 OAuth 2.0 授權流程進行身分驗證。如果您選擇 OAuth，請為客戶提供明確的使用說明，包括：
     + OAuth 授權 URL 和字符端點
     + 必要的範圍和許可
     + Step-by-step身分驗證流程說明
     + 具有適當身分驗證標頭的範例 API 呼叫
     + 疑難排解常見的身分驗證問題

1. （選用） Amazon Bedrock AgentCore 整合 
   + 如果您列出支援兩邊 OAuth 身分驗證的 MCP 伺服器，您可以使用 MCP 伺服器端點做為目標，啟用與 Amazon Bedrock AgentCore Gateway 的整合。如需詳細資訊，請參閱 [MCP 伺服器目標](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-target-MCPservers.html)。在此情況下，不需要 OpenAPI 規格。
   + 如果您使用 API 金鑰身分驗證列出任何其他 API 型產品或 MCP 伺服器，您可以提供 OpenAPI 規格來啟用與 Amazon Bedrock AgentCore 的整合。
   + 若要進一步了解 AgentCore 部署和擴展 AI 代理器的功能，請參閱[什麼是 Amazon Bedrock AgentCore？](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html)

1. （選用） - 選擇 API 整合通訊協定並提供使用說明：
   + **MCP** - 模型內容通訊協定 (MCP) 標準化對外部工具、資料和服務的存取，以增強功能。
   + **A2A** - Agent2Agent (A2A) 可啟用跨不同平台的直接通訊和任務委派。

1. 如果您選取 AI 代理器工具類型，請確認您的代理器使用推理 LLMs並示範自主功能。這些要求有助於確保 AWS Marketplace 上提供的代理程式符合高品質標準。如果您的代理程式不符合這兩個要求，請選擇不同的工具類型。

## 步驟 3：設定產品定價
<a name="step-3-product-pricing"></a>

若要提供您的產品 AWS Marketplace，請決定定價模式並定義產品的定價維度。如需可用定價選項的詳細資訊，請參閱 [中的 SaaS 產品定價 AWS Marketplace](saas-pricing-models.md)。

每個維度都是產品的特徵、服務或其他方面，您可以為其設定每單位價格。

1. 選擇定價模型。

1. 選擇**下一步**。

## 步驟 4：檢閱價格
<a name="step-4-review-prices"></a>

1. 檢閱產品定價。

1. 選擇**下一步**。

**注意**  
基於測試目的，我們會將價格設定為 $0.001 或 $0.00000001。您現在不需要變更價格。這可讓您的團隊和 AWS Marketplace 賣方營運團隊以較低的價格測試產品，而不會產生大量測試帳單。當您請求產品公開的產品可見性時，您將提供實際定價。

## 步驟 5：指定退款政策
<a name="step-5-refund-policy"></a>

1. 輸入您產品的退款政策。

1. 選擇**下一步**。

## 步驟 6：設定最終使用者授權合約 (EULA)
<a name="step-6-eula"></a>

1. 選擇**適用於 的標準合約 AWS Marketplace**，或為您的**自訂 EULA** 提供 S3 URL。
   + 如需使用標準合約的詳細資訊，請參閱 [在 中使用標準化合約 AWS Marketplace](standardized-license-terms.md)。

1. 選擇**下一步**。

## 步驟 7：設定優惠可用性
<a name="step-7-offer-availability"></a>

根據預設，列出的產品 AWS Marketplace 可在 AWS 支援的所有國家/地區購買。您可以選擇透過識別買方可以或不能購買您產品的國家/地區，來啟用國家/地區特定的可用性。

1. 依國家/地區選擇您的優惠可用性。

1. 選擇**下一步**。

## （選用） 步驟 8：設定允許清單
<a name="step-8-allowlist"></a>

所有發佈以有限可見性 AWS Marketplace 開始的新產品清單。您可以將選取 AWS 帳戶 IDs 新增至允許清單，以控制哪些帳戶可以存取您的有限產品，包括產品的有限版本。

若要將 AWS 帳戶新增至允許清單：

1. 輸入您需要新增至允許清單的逗號分隔 AWS 帳戶 IDs。

1. 選擇**提交**。

**注意**  
僅將測試帳戶新增至允許清單以進行測試。

## 在 中修改 SaaS API 型 AI 代理器產品設定 AWS Marketplace
<a name="modifying-saas-ai-agents"></a>

在 中建立 **SaaS API 型代理程式和工具產品**後 AWS Marketplace，您可以修改許多產品設定。如需提交變更請求和修改產品設定的相關資訊，請參閱下列主題：

### 產品變更和請求
<a name="product-changes-requests"></a>
+ 如需管理變更請求的資訊，請參閱 [管理變更請求](saas-product-settings.md#create-change-request)。
+ 如需更新產品資訊的資訊，請參閱 [更新產品資訊](saas-product-settings.md#update-product-information)。
+ 如需更新架構詳細資訊的詳細資訊，請參閱 [更新架構詳細資訊](saas-product-settings.md#updating-architecture-details)。

### 存取和可見性
<a name="access-visibility"></a>
+ 如需更新允許清單的資訊，請參閱 [更新 AWS 帳戶 IDs的允許清單](saas-product-settings.md#update-allowlist)。
+ 如需變更產品可見性的資訊，請參閱 [更新產品可見性](saas-product-settings.md#saas-update-visibility)。
+ 如需管理買方存取權的詳細資訊，請參閱 [更新定價條款](saas-product-settings.md#saas-update-pricing-terms)。
+ 如需國家/地區可用性的資訊，請參閱 [依國家/地區更新可用性](saas-product-settings.md#saas-availability-by-country)。

### 定價和條款
<a name="pricing-terms"></a>
+ 如需更新定價條款的詳細資訊，請參閱 [更新定價條款](saas-product-settings.md#saas-update-pricing-terms)。
+ 如需新增定價維度的詳細資訊，請參閱 [新增定價維度](saas-product-settings.md#saas-add-pricing-dimensions)。
+ 如需更新定價維度的詳細資訊，請參閱 [更新定價維度](saas-product-settings.md#saas-update-dimension)。
+ 如需限制定價維度的資訊，請參閱 [限制定價維度](saas-product-settings.md#restrict-pricing-dimensions)。

### 法律和授權
<a name="legal-licensing"></a>
+ 如需更新退款政策的詳細資訊，請參閱 [更新產品的退款政策](saas-product-settings.md#update-refund-policy)。
+ 如需更新 EULA 的資訊，請參閱 [更新最終使用者授權合約 (EULA)](saas-product-settings.md#saas-update-eula)。

### 提供免費產品
<a name="free-product"></a>

如果您的產品可見性有限：
+ 提交請求，將可見性從限制變更為公有。
+ 輸入所有定價維度的 $0。

如果您的產品已公開：
+ 提交**更新定價條款**變更請求。
+ 輸入所有定價維度的 $0。

**注意**  
將產品設定為免費之後，您就無法將其轉換為付費產品。