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

集成基于 API 的人工智能代理产品

基于 API 的人工智能代理产品指南

AWS Marketplace 为所有基于软件即服务 (SaaS) API 的人工智能代理产品提供指南。这些指南旨在为客户提供安全可靠的使用体验。

产品审核流程

提交产品时，请查看 AWS Marketplace 该产品及其元数据以验证其是否符合当前指南。我们会定期更新这些指南，以适应不断变化的安全需求。

维护合规性

AWS Marketplace 持续监控产品以验证合规性。如果您的产品不符合现行指南要求：

集成基于 API 的人工智能代理产品

基于产品定价进行集成

将您的产品与集成 AWS Marketplace 是发布基于 API 的 AI 代理产品的一个步骤。要将基于 API 的 AI 代理产品与集成 AWS Marketplace，您必须编写代码并证明它可以成功响应多个客户场景。

有关基于不同定价模式集成产品的信息，请参阅以下主题：

客户载入

重定向至网站履行

当客户通过订阅您的产品时 AWS Marketplace，他们将在您的 AWS 环境中访问该产品。订阅完成后，我们会将客户定向到您的产品官网，以便其完成账户注册和产品配置操作。

QuickLaunch 履行

当客户通过订阅您的产品时 AWS Marketplace，他们会收到 API 密钥或 OAuth 凭证，用于调用您的 API 端点或 MCP 服务器。具体流程如下：

在以下资源中了解有关 QuickLaunch 配送的更多信息：

正在访问 AWS Marketplace APIs

以下部分概述了与 AWS Marketplace 计量服务或 AWS Marketplace 授权服务集成的过程，该服务用于确保您对产品的客户使用情况的账单和报告准确无误。

SNS 通知

订阅亚马逊简单通知服务 (Amazon SNS) Service 主题，接收有关买家订阅变更和商品合同权利的通知。 AWS Marketplace 在产品创建过程中提供了这些主题，以帮助您管理客户访问权限。

以下 Amazon SNS 主题适用于基于 SaaS API 的产品：

使用说明模板

MCP 服务器使用说明模板

以下示例演示了 MCP 服务器的使用说明，包括工具描述、先决条件、身份验证设置、常用客户端的配置、速率限制及其他资源：

To get started using the remove MCP server, follow the instructions below:

**Availble Tools**
This MCP server support the following tools:
- Search - Performs a web search
- Summarize Website - Summarizes a webpage 

**Prerequisites**
- Install **Node.js** and **npm**

**Authentication**
Replace `YOUR_API_KEY` with your actual key below.

**Claude Desktop**
Edit the configuration file at:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the below code:
```
{
  "mcpServers": {
    "demo-example": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://remote.mcp.server/sse",
        "--header",
        "Authorization: Bearer <YOUR_API_KEY>"
      ]
    },
  }
}
```

**Cline**
Cline stores MCP server configurations in a JSON file that can be modified.
In the "Installed" tab, click "Configure MCP Servers" to access the settings file.

Add the following:
```
{
    "mcpServers": {
        "demoServer": {
            "url": "https://remote.mcp.server/sse",
            "disabled": false,
            "autoApprove": ["searchWeb", "summarizeWebsite"],
            "timeout": 30
        }
    }
}
```

**Rate Limits**
- 60 requests per minute per API key.  
- Exceeding returns HTTP 429 Too Many Requests.  
- Use retry and exponential backoff to handle limits.  

**Learn More**
MCP Docs: https://mcp.search.demoproduct.com
            

人工智能代理与代理和工具使用说明模板

以下示例演示了代理或代理工具的使用说明，包括先决条件、身份验证设置、支持的端点、 request/response 架构、错误代码和其他资源：

To get started follow the instructions below:

**Authentication**
All API requests require this HTTP header:
Authorization: Bearer `YOUR_API_KEY`
Replace `YOUR_API_KEY` with your actual key.

**Search Endpoint**

**Endpoint:** `GET /web/search`
Performs a web search.

**Query Parameters:**
| Param | Type | Description |
|------------|--------|-------------------------------------|
| `q` | string | Your search query (required) |
| `count` | int | Number of results (default: 10) |
| `offset` | int | Offset for pagination |
| `country` | string | Country code (e.g. `us`, `de`) |
| `safesearch` | string | `off`, `moderate`, or `strict` |

**Example Request:**
```bash
curl -X GET "https://api.search.demo.com/res/v1/web/search?q=searchtool" \
-H "Authorization: Bearer YOUR_API_KEY"
```
**Response Schema:**  
```  
{
    "results": [{  
            "title": "string",  
            "url": "string",
            "description": "string"  
    }],
    "query" :"string",
    "total" :"number"
}  
```
**Example Response:**
```
{
    "results": [
      {
        "title": "DemoProductAPI",
        "url": "https://demo.com",
        "description": "Demo Product API is a search tool for..."
      }
    ],
    "query": "searchtool",
    "total": 1
}
```

**Additional Search Types**
DemoProduct also supports:
- `GET /news/search – News articles`
- `GET /images/search – Image results`
- `GET /videos/search – Video results`

These endpoints follow the same format as /web/search.

**Summarize Endpoint**
**Endpoint:** `POST /summarize`

Summarizes a webpage 
**Request Headers:**  
Content Type: application/json
**Request Body:**  
```  
{
    "input": "string" // URL or plain text
}    
```
**Example Request:** 
```
{
    "input": "https://example.com/article"
} 
```
**Response Schema**
```
    {
            "summary": "string"  
    }    
```
**Example Response**
``` 
    {
         "summary": "This article explains our commitment to user privacy."
    }   
```

**Error Codes**
| Status | Meaning |
| ------ | ------------------------------ |
| `401` | Unauthorized (check your key) |
| `429` | Too many requests (rate limit) |
| `500` | Server error |

All error responses follow this structure:
```
{
    "error": {
    "code": 401,
    "message": "Unauthorized"
    }
}
```

**Rate Limits**
- 60 requests per minute per API key.  
- Exceeding returns HTTP 429 Too Many Requests.  
- Use retry and exponential backoff to handle limits.  

**Learn More**
API Docs: https://api.search.demoproduct.com