기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

API 기반 AI 에이전트 제품 통합

API 기반 AI 에이전트 제품 지침

AWS Marketplace 는 모든 서비스형 소프트웨어(SaaS) API 기반 AI 에이전트 제품에 대한 지침을 제공합니다. 이러한 지침은 고객에게 안전하고 신뢰할 수 있는 환경을 보장합니다.

제품 검토 프로세스

제품을 제출하면는 제품 및 메타데이터를 AWS Marketplace 검토하여 현재 지침을 충족하는지 확인합니다. 진화하는 보안 요구 사항을 해결하기 위해 이러한 지침은 정기적으로 업데이트됩니다.

규정 준수 유지

AWS Marketplace 는 제품을 지속적으로 모니터링하여 규정 준수를 확인합니다. 제품이 현재 지침을 충족하지 않는 경우:

API 기반 AI 에이전트 제품 통합

제품 요금에 따른 통합

제품을와 통합하는 AWS Marketplace 것은 API 기반 AI 에이전트 제품을 나열하는 한 단계입니다. API 기반 AI 에이전트 제품을와 통합하려면 코드를 작성하고 여러 고객 시나리오에 성공적으로 대응할 수 있음을 입증해야 AWS Marketplace합니다.

다양한 요금 모델을 기반으로 제품을 통합하는 방법에 대한 자세한 내용은 다음 주제를 참조하세요.

고객 온보딩

웹 사이트로 리디렉션 이행

고객이를 통해 제품을 구독하면 AWS 환경에서 제품에 AWS Marketplace액세스합니다. 구독한 후, 고객은 계정을 등록하고 제품을 구성하기 위해 판매자의 웹 사이트로 전송됩니다.

QuickLaunch 이행

고객이를 통해 제품을 구독하면 API 키 또는 OAuth 자격 증명을 AWS Marketplace수신하여 API 엔드포인트 또는 MCP 서버를 호출합니다. 이 프로세스는 다음과 같이 작동합니다.

다음 리소스에서 QuickLaunch 이행에 대해 자세히 알아보세요.

AWS Marketplace APIs 액세스

다음 섹션에서는 제품의 고객 사용에 대한 결제 및 보고가 정확한지 확인하는 데 사용되는 AWS Marketplace 측정 서비스 또는 AWS Marketplace 권한 부여 서비스와 통합하는 프로세스를 간략하게 설명합니다.

SNS 알림

Amazon Simple Notification Service(Amazon SNS) 주제를 구독하여 제품의 고객 구독 변경 및 계약 권한에 대한 알림을 받습니다.는 제품 생성 중에 이러한 주제를 AWS Marketplace 제공하여 고객 액세스를 관리하는 데 도움이 됩니다.

다음은 SaaS API 기반 제품에 사용할 수 있는 Amazon SNS 주제입니다.

사용 지침 템플릿

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 에이전트와 에이전트 및 도구 사용 지침 템플릿

다음 예제에서는 사전 조건, 인증 설정, 지원되는 엔드포인트, 요청/응답 스키마, 오류 코드 및 추가 리소스를 포함한 에이전트 또는 에이전트 도구의 사용 지침을 보여줍니다.

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