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

整合 API 型 AI 代理器產品

API 型 AI 代理器產品準則

AWS Marketplace 提供所有軟體即服務 (SaaS) API 型 AI 代理器產品的指導方針。這些準則可確保為客戶提供安全且值得信賴的體驗。

產品審核程序

當您提交產品時， 會 AWS Marketplace 檢閱產品及其中繼資料，以確認其符合目前的準則。我們會定期更新這些準則，以因應不斷變化的安全需求。

維持合規

AWS Marketplace 會持續監控產品以驗證合規性。如果您的產品不符合目前的準則：

整合 API 型 AI 代理器產品

根據產品定價進行整合

將您的產品與 整合， AWS Marketplace 是列出 API 型 AI 代理器產品的一個步驟。若要將 API 型 AI 代理器產品與 整合 AWS Marketplace，您必須撰寫程式碼，並示範它可以成功回應數個客戶案例。

如需根據不同定價模型整合產品的相關資訊，請參閱下列主題：

客戶加入

重新導向至網站履行

當客戶透過 訂閱您的產品時 AWS Marketplace，他們會存取您 AWS 環境中的產品。訂閱後，我們會引導客戶前往您的產品網站，註冊其帳戶並設定產品。

QuickLaunch 履行

客戶透過 訂閱您的產品時 AWS Marketplace，會收到 API 金鑰或 OAuth 登入資料，以呼叫您的 API 端點或 MCP 伺服器。程序的運作方式如下：

進一步了解這些資源中的 QuickLaunch 履行：

存取 AWS Marketplace APIs

下一節概述了與 AWS Marketplace Metering Service 或 AWS Marketplace Entitlement Service 整合的程序，用於確保您產品的帳單和客戶用量報告的準確性。

SNS 通知

訂閱 Amazon Simple Notification Service (Amazon SNS) 主題，以接收有關產品的客戶訂閱變更和合約權利的通知。 會在產品建立期間 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
            

AI Agent 和 Agent & Tools 使用說明範本

下列範例示範客服人員或客服人員工具的使用說明，包括先決條件、身分驗證設定、支援的端點、請求/回應結構描述、錯誤碼和其他資源：

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