Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Integrazione di prodotti di agenti AI basati su API

Linee guida sui prodotti per agenti AI basati su API

Marketplace AWS fornisce linee guida per tutti i prodotti agenti AI basati su API Software as a Service (SaaS). Queste linee guida garantiscono un'esperienza sicura e affidabile per i clienti.

Processo di revisione del prodotto

Quando invii un prodotto, Marketplace AWS esamina il prodotto e i relativi metadati per verificare che soddisfi le linee guida attuali. Aggiorniamo regolarmente queste linee guida per rispondere all'evoluzione dei requisiti di sicurezza.

Mantenimento della conformità

Marketplace AWS monitora continuamente i prodotti per verificarne la conformità. Se il prodotto non soddisfa le linee guida attuali:

Integrazione di prodotti di agenti AI basati su API

Integrazione in base al prezzo del prodotto

L'integrazione del prodotto con Marketplace AWS è un passaggio per elencare un prodotto agente AI basato su API. Per integrare il tuo prodotto agente AI basato su API con Marketplace AWS, devi scrivere codice e dimostrare che è in grado di rispondere con successo a diversi scenari di clienti.

Per informazioni sull'integrazione del prodotto in base a diversi modelli di prezzo, consulta i seguenti argomenti:

Onboarding dei clienti

Reindirizzamento alla pagina di gestione del sito Web

Quando i clienti si abbonano al tuo prodotto tramite Marketplace AWS, accedono al prodotto nel tuo ambiente AWS. Dopo l'iscrizione, indirizziamo i clienti al sito Web del prodotto per registrare il proprio account e configurare il prodotto.

QuickLaunch adempimento

Quando i clienti si abbonano al tuo prodotto tramite Marketplace AWS, ricevono una chiave API o OAuth credenziali per effettuare chiamate all'endpoint API o al server MCP. Di seguito è riportato il procedimento:

Scopri di più sull' QuickLaunch adempimento in queste risorse:

Accedendo Marketplace AWS APIs

La sezione seguente descrive il processo di integrazione con il Marketplace AWS Metering Service o Marketplace AWS Entitlement Service, utilizzato per garantire che la fatturazione e la rendicontazione relative all'utilizzo dei prodotti da parte dei clienti siano accurate.

Notifiche SNS

Iscriviti agli argomenti di Amazon Simple Notification Service (Amazon SNS) per ricevere notifiche sulle modifiche all'abbonamento dei clienti e sui diritti contrattuali per i tuoi prodotti. Marketplace AWS fornisce questi argomenti durante la creazione del prodotto per aiutarti a gestire l'accesso dei clienti.

I seguenti argomenti di Amazon SNS sono disponibili per i prodotti basati su API SaaS:

Modelli di istruzioni per l'uso

Modello di istruzioni per l'utilizzo del server MCP

L'esempio seguente illustra le istruzioni d'uso per un server MCP, tra cui descrizioni degli strumenti, prerequisiti, configurazione dell'autenticazione, configurazione per i client più diffusi, limiti di velocità e risorse aggiuntive:

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
            

Modello di istruzioni per l'utilizzo di AI Agent e Agent & Tools

L'esempio seguente illustra le istruzioni di utilizzo per uno o più strumenti dell'agente, inclusi prerequisiti, configurazione dell'autenticazione, endpoint supportati, request/response schema, codici di errore e risorse aggiuntive:

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