本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 列出 SaaS API-based 人工智能代理产品
<a name="listing-saas-ai-agents"></a>

作为 AWS Marketplace 卖家，您可以将软件即服务 (SaaS) API-based AI 代理或工具产品添加到 AWS Marketplace。这包括根据您的计费模式创建您的产品并将其与相应 AWS Marketplace 的 API 操作集成。

要以 SaaS API-based AI 代理的形式销售软件或工具产品 AWS Marketplace，请执行以下步骤：
+ 在中创建 SaaS API-based AI 代理或工具产品 AWS Marketplace。
+  AWS Marketplace 根据您的定价模式将您的产品与之集成：
  + 有关订阅制产品的信息，请参阅[将您的 SaaS 订阅或 Pay-As-You-Go 产品与 AWS Marketplace](saas-integrate-subscription.md)。
  + 有关合同制产品的信息，请参阅[将你的 SaaS 合同产品与 AWS Marketplace](saas-integrate-contract.md)。
  + 有关合同与按实际使用量付费混合模式产品的信息，请参阅[将基于合同的 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)。
  + 有关测试合同与按实际使用量付费混合模式产品的信息，请参阅[通过集成测试你的 SaaS pay-as-you-go 合同](saas-integrate-contract-with-pay.md#saas-contract-consumption-integration-testing)。
+ 提交产品以完成发布。

## 先决条件
<a name="saas-ai-agents-prerequisites"></a>

开始前，请确保您已准备好以下事项：
+ 清楚了解您的人工智能代理的功能特性及目标使用案例
+ 完备的安全防护措施和合规认证
+ 用于集成和部署的技术文档
+ 与业务模式匹配的定价策略
  + 有关定价策略的信息，请参阅 [SaaS 产品定价在 AWS Marketplace](saas-pricing-models.md)。

## 管理 SaaS API-based 人工智能代理和工具
<a name="managing-saas-ai-agents"></a>

所有 SaaS API-based 人工智能代理和工具均可通过统一的 **AI 代理和工具**产品页面或 AWS Marketplace 管理控制台中的 **Saa** S 产品页面进行管理。

## 启动上架向导
<a name="start-listing-wizard"></a>

1. 登录 A [WS 合作伙伴中心](https://us-east-1.console.aws.amazon.com/partnercentral/home)。

1. 在导航栏中，选择**构建**，然后选择 **AI 代理和工具**。

1. 从 “**创建 AI 代理和工具” 产品**菜单中，选择 **API-based 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)。

## 第 1 步：提供产品信息
<a name="step-1-product-information"></a>

您在此步骤中提供的信息将传递产品的核心价值主张。

**使用 AI-assisted 产品清单**  
您可以使用 P AWS artner Assistant 中的 AI-assisted 产品列表通过网站 URL 或上传的文档生成此步骤的产品信息。该工具根据 AWS Marketplace 标准对房源质量进行评分，并在您提交之前提供实地级建议，以提高可发现性和买家参与度。有关更多信息，请参阅 [AI-assisted 产品清单](ai-assisted-product-listing.md)。

1. 在“产品信息”选项卡中填写以下详细信息：
   + **产品标题**
   + **SKU**（可选）
   + **产品徽标 S3 URL**
   + **简短描述**
   + **详细描述**
   + **产品视频 URL**（可选）
   + **要点**（1-3 条）

1. 输入支持详细信息并通过选择**添加资源**来添加可选的学习资源。

1. 在**产品类别**菜单中，选择 1-3 个类别。
   + 建议从**人工智能代理和工具**业务类别中选择至少一个类别。

1. 输入关键字以提升搜索可发现性。

1. （可选）根据相关指南添加视频和图片素材。

1. 选择**下一步**。

## 第 2 步：配置履行选项
<a name="step-2-fulfillment-options"></a>

1. 选择履行方法：
   + **快速启动**（推荐）- 卖家与 [AWS Marketplace Deployment API](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_Operations_AWS_Marketplace_Deployment_Service.html) 集成，客户订阅后可直接获取 API 密钥至其 AWS 账户。
   + **重定向至您的网站** - 客户将被重定向至您的网站以获取 API 密钥或 OAuth 令牌。
**注意**  
产品发布后，将无法更改履行方法。

1. 输入履行 URL。这是用户登录或创建账户的 URL。

1. 选择您的人工智能代理或工具的详细信息：
   + **人工智能代理** - 使用人工智能处理请求并通过推理和决策完成任务的软件。
   + **人工智能工具**：
     + **MCP 服务器** - 管理人工智能模型与应用程序之间的通信及上下文交互的服务器。
     + **知识库** - 人工智能代理用来为决策和响应提供依据的结构化信息集合。
     + **护栏** - 定义人工智能代理行为和操作界限的规则和控件。
     + **其他** - 提升人工智能代理能力的其他工具。

1. 输入端点 URL。这是您的 API 接收请求的 URL。对于 MCP 服务器，请列出 MCP 端点。
   + **静态端点**-输入不带参数的固定 URL。例如：`https://api.example.com/v1/mcp`。
   + **动态端点**-使用`{paramName}`语法输入包含一个或多个占位符参数的 URL。例如：`https://{tenantId}.apps.example.com/v1/mcp`。

     订阅后，动态终端节点会解析为买家特定的网址。选择此选项时，必须使用**快速启动**配送方式。

     配置您的终端节点 URL 参数：
     + **名称**（必填）-与您的 URL 中的`{paramName}`占位符匹配的计算机标识符。名称必须以字母开头，并且只能包含字母、数字和下划线。最大长度为 64 个字符。
     + **描述**（可选）-向买家显示的解释参数用途的帮助文本。
     + **默认值**（可选）-买家特定值尚未交付时使用的备用值。值可以包含字母、数字、连字符、句点、下划线和波浪号。最大长度为 256 个字符。
**注意**  
每个端点最多可以定义 5 个参数。URL 中的每个`{paramName}`占位符都必须有一个匹配的参数条目，并且每个参数条目都必须对应于 URL 中的占位符。

     买家订阅后，调用 `PutDeploymentParameter` API 操作以提供买家特定的参数值。配送小工具使用已交付的值自动解析最终到达的 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-based 的产品或 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. 如果您选择了“人工智能代理”工具类型，请确认您的代理使用推理型 LLM，且具备自主运行能力。这些要求旨在确保 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：配置 End-User 许可协议 (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 账户 ID 添加至允许列表，控制哪些账户有权访问您的受限产品，包括产品的受限版本。

要将 AWS 账户添加至允许列表，请执行以下操作：

1. 输入需添加至允许列表的 AWS 账户 ID，多个 ID 以英文逗号分隔。

1. 选择**提交**。

**注意**  
仅可出于测试目的将测试账户添加至允许列表。

## 在中修改 SaaS API-based AI 代理产品设置 AWS Marketplace
<a name="modifying-saas-ai-agents"></a>

在中创建 **SaaS API-Based 代理和工具产品**后 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 账户 身份证](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。

**注意**  
产品设置为免费后，将无法再转为付费产品。