L'API Reference di AWS Marketplace è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'[AWS Marketplace API Reference](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).
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à.
# Informazioni su Marketplace AWS Server MCP
Marketplace AWS Model Context Protocol (MCP) fornisce AI-powered strumenti per la Marketplace AWS scoperta, la valutazione, la ricerca e la generazione di proposte. MCP è un protocollo standardizzato che consente agli assistenti AI di interagire con sistemi esterni attraverso quanto segue:
+ **Strumenti**: funzioni che i modelli di intelligenza artificiale possono richiamare per eseguire azioni.
+ **Risorse**: dati e contesto che possono essere condivisi con i modelli di intelligenza artificiale.
Tutti gli strumenti sono stateless: ogni chiamata è indipendente e non prevede lo stato di conversazione sul lato server.
**Casi d'uso esemplificativi**
Di seguito sono riportati i modi più comuni per utilizzare il server Marketplace AWS MCP:
+ Trova prodotti che soddisfano le esigenze aziendali utilizzando query in linguaggio naturale.
+ Valuta rapidamente più fornitori con report di AI-generated confronto.
+ Crea proposte di acquisto complete personalizzate in base alle esigenze aziendali.
+ Ottieni un'analisi fianco a fianco delle soluzioni concorrenti.
**Punto finale:** `https://marketplace-mcp.us-east-1.api.aws/mcp`
**Protocollo:** MCP su Streamable HTTP (2.0)JSON-RPC . Tutte le risposte sono payload JSON singoli.
**Autenticazione:** non richiesta.
**Topics**
+ [Strumenti disponibili](#marketplace-mcp-available-tools)
+ [Guida all'integrazione](#marketplace-mcp-integration-guide)
+ [Dettagli dello strumento](#marketplace-mcp-tool-details)
+ [Flussi di lavoro](#marketplace-mcp-workflows)
+ [End-to-end esempio](#marketplace-mcp-end-to-end-example)
+ [Gestione degli errori](#marketplace-mcp-error-handling)
## Strumenti disponibili
Tutti e 6 gli strumenti sono stateless e non richiedono alcun contesto di conversazione o gestione della sessione. Tutte le definizioni degli strumenti, inclusi input/output gli schemi completi, sono disponibili a livello di codice tramite l'endpoint MCP standard. `tools/list` Gli schemi restituiti da `tools/list` sono la fonte di verità canonica e sempre attuale per i nomi, i tipi e i vincoli dei parametri.
La tabella seguente riassume ogni strumento e indica se è di sola lettura.
| Nome dello strumento | Description | Read-only |
| --- | --- | --- |
| [`get_aws_marketplace_report_guidelines`](#marketplace-mcp-tool-report-guidelines) | Restituisce istruzioni sul flusso di lavoro e modelli di formato di report per consigli, confronti o valutazioni. Chiama prima per qualsiasi flusso di lavoro di report. | Sì |
| [`search_aws_marketplace_solutions`](#marketplace-mcp-tool-search-solutions) | Cerca nel Marketplace AWS catalogo per query. Supporta interrogazioni in batch (fino a 10) e impaginazione basata su cursori. | Sì |
| [`get_aws_marketplace_solution`](#marketplace-mcp-tool-get-solution) | Ottiene i metadati dettagliati della soluzione in base agli ID della soluzione (recensioni, prezzi, opinioni, classiifiche, CTA). | Sì |
| [`get_aws_marketplace_related_solutions`](#marketplace-mcp-tool-related-solutions) | Ottiene soluzioni correlate per determinati ID di soluzione, classificate in base al punteggio di relazione. | Sì |
| [`research_aws_marketplace_solution`](#marketplace-mcp-tool-research-solution) | Esegue ricerche approfondite sul web sulle soluzioni (caratteristiche, recensioni, limitazioni, concorrenti, prezzi, integrazioni, casi di studio). Nascosto ai clienti con ricerca web nativa. | Sì |
| [`submit_aws_marketplace_feedback`](#marketplace-mcp-tool-submit-feedback) | Invia il feedback degli utenti (positive/negative) sulla qualità dei report. | No |
## Guida all'integrazione
È possibile effettuare l'integrazione con il server Marketplace AWS MCP in due modi: tramite un Claude Connector senza codice o tramite un client MCP programmatico.
### Claude Connector (consigliato)
Il modo più veloce per utilizzare gli strumenti Marketplace AWS MCP è tramite il **Marketplace AWS connettore per** Claude. Ciò non richiede alcuna codifica o configurazione del client MCP: Claude gestisce automaticamente l'individuazione e la chiamata degli strumenti.
**Configurazione:**
1. Apri il [Marketplace AWS connettore](https://claude.ai/directory/connectors/2ed43e1e-f547-48a3-85cc-b9baa412d06b) nella Claude Connectors Directory.
1. Scegli **Connect** per abilitarlo.
1. In qualsiasi conversazione con Claude, scegli il pulsante **\+** (in basso a sinistra) o digita**/**per aprire il menu.
1. Passa il mouse su **Connectors** e attiva. **Marketplace AWS**
1. Chiedi a Claude di trovare, confrontare o valutare Marketplace AWS i prodotti: utilizza automaticamente gli strumenti MCP.
Per maggiori dettagli su come funzionano i connettori, consulta [Usare i connettori per estendere le funzionalità di Claude](https://support.claude.com/en/articles/11176164-use-connectors-to-extend-claude-s-capabilities).
**Suggerimenti di esempio:**
+ «Trova le migliori soluzioni SIEM Marketplace AWS per un'azienda di medie dimensioni»
+ «Confronta Datadog e New Relic su» Marketplace AWS
+ «Crea un rapporto di valutazione per Terraform Cloud on» Marketplace AWS
### Integrazione con client MCP
Per integrazioni programmatiche o framework di agenti personalizzati, connettiti direttamente all'endpoint MCP.
#### Prerequisiti
Per iniziare, hai bisogno di quanto segue:
1. Un framework o un client per MCP-compatible agenti.
1. Un client HTTP in grado di effettuare richieste JSON-RPC 2.0.
#### Fase 1: Configurare il client MCP
Utilizzate un client MCP standard che supporti il trasporto HTTP.
**Endpoint:**
```
https://marketplace-mcp.us-east-1.api.aws/mcp
```
Sono supportati i seguenti metodi:
+ `POST`con `method: "initialize"` — Inizializza la sessione e ottieni`Mcp-Session-Id`.
+ `POST`con`method: "tools/list"`: scopri gli strumenti disponibili e i relativi schemi.
+ `POST`con`method: "tools/call"`: richiama uno strumento.
**Autenticazione:** non è richiesta alcuna autenticazione. Ometti le intestazioni di autenticazione nelle richieste HTTP.
#### Fase 2: Ottenere e registrare gli strumenti (tool discovery)
Tutte le definizioni degli strumenti sono disponibili a livello di codice tramite il metodo `tools/list` MCP standard. Questo è il metodo consigliato per ottenere input/output gli schemi correnti, in quanto gli schemi degli strumenti possono essere aggiornati indipendentemente dalla presente documentazione. Chiamate `tools/list` una sola volta durante l'inizializzazione e registrate gli strumenti restituiti nel manifesto degli strumenti dell'agente o nel prompt di sistema.
L'esempio seguente mostra una `tools/list` richiesta.
**Richiesta:**
```
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}
```
**Risposta (abbreviata):**
```
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"tools": [
{
"name": "get_aws_marketplace_report_guidelines",
"description": "...",
"inputSchema": { ... }
},
{
"name": "search_aws_marketplace_solutions",
"description": "...",
"inputSchema": { ... }
},
{
"name": "get_aws_marketplace_solution",
"description": "...",
"inputSchema": { ... }
},
{
"name": "get_aws_marketplace_related_solutions",
"description": "...",
"inputSchema": { ... }
},
{
"name": "research_aws_marketplace_solution",
"description": "...",
"inputSchema": { ... }
},
{
"name": "submit_aws_marketplace_feedback",
"description": "...",
"inputSchema": { ... }
}
]
}
}
```
Ogni voce dello strumento include lo strumento`name`, una guida dettagliata `description` con istruzioni d'uso ed esempi e una completa `inputSchema` di tipi di parametri, vincoli e regole di convalida.
#### Fase 3: Configurare la telemetria
Marketplace AWS MCP richiede un identificatore stabile su ogni richiesta di strumento per la correlazione delle richieste e la telemetria. Non si tratta di una credenziale di autenticazione: viene utilizzata solo per la diagnostica e l'analisi.
Passa l'identificatore nell'intestazione HTTP personalizzata:
```
Mcp-Session-Id:
```
+ **Client del browser:** derivano da un cookie di sessione esistente o da un UUID generato dal frontend. Utilizzate lo stesso valore per tutte le chiamate allo strumento.
+ **Client programmatici:** utilizzare `POST` with `method: "initialize"` per ottenere un`Mcp-Session-Id`.
#### Trasporto HTTP
Marketplace AWS MCP utilizza il trasporto HTTP, in cui il server funziona come un servizio HTTP indipendente in grado di gestire più connessioni client.
Di seguito sono riportate le principali caratteristiche di trasporto:
+ **HTTP POST per le richieste:** ogni messaggio del client viene inviato come una nuova richiesta HTTP POST.
+ **Risposte JSON:** tutti gli strumenti restituiscono risposte JSON ()`Content-Type: application/json`.
+ **Gestione delle sessioni:** ID di sessione tramite l'`Mcp-Session-Id`intestazione per la correlazione delle richieste e la telemetria.
+ **Versione del protocollo: specificata tramite** l'intestazione. `MCP-Protocol-Version: 2025-06-18`
**Intestazioni HTTP richieste:**
```
Content-Type: application/json
Mcp-Session-Id:
MCP-Protocol-Version: 2025-06-18
```
L'esempio seguente mostra una richiesta e una risposta alla chiamata di uno strumento.
**Richiesta di esempio:**
```
POST /mcp HTTP/1.1
Content-Type: application/json
Mcp-Session-Id: 1868a90c-5b12-4e8a-9f3d-2a1b3c4d5e6f
MCP-Protocol-Version: 2025-06-18
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_aws_marketplace_solutions",
"arguments": {
"queries": ["SIEM solutions"]
}
}
}
```
**Esempio di risposta:**
```
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "{\"results\":[...],\"next_cursor\":null}"
}
],
"isError": false
}
}
```
## Dettagli dello strumento
Questa sezione descrive i parametri di input, il formato di output e le linee guida all'utilizzo di ogni strumento.
### get\_aws\_marketplace\_report\_guidelines
Restituisce le istruzioni sul flusso di lavoro e il modello di formato di output per un determinato tipo di report. **Chiamalo prima** per qualsiasi flusso di lavoro di raccomandazione, confronto o valutazione.
Questo strumento restituisce prompt diversi a seconda delle funzionalità del client: i clienti con ricerca web nativa ricevono prompt con query di ricerca incorporate anziché riferimenti agli strumenti. `research_aws_marketplace_solution`
**Ingresso:**
```
{
"workflow_type": "recommendations" | "comparison" | "evaluation"
}
```
La tabella seguente descrive i parametri di input.
| Campo | Tipo | Campo obbligatorio | Description |
| --- | --- | --- | --- |
| workflow\_type | enum | Sì | "recommendations"per l'individuazione di prodotti classificati, "comparison" per l'analisi fianco a fianco, "evaluation" per la valutazione di un singolo prodotto. |
**Output:**
```
{
"workflow_type": "recommendations",
"guidelines": "# AWS Marketplace Recommendations Workflow\n\n..."
}
```
La tabella seguente descrive i campi di output.
| Campo | Tipo | Description |
| --- | --- | --- |
| workflow\_type | stringa | Il tipo di flusso di lavoro richiesto. |
| guidelines | stringa | Istruzioni combinate per il flusso di lavoro e modello di formato markdown. |
**Quando utilizzare ogni flusso di lavoro:**
+ **consigli**: «trova strumenti di monitoraggio», «Ho bisogno di una CI/CD soluzione», "scansione SOC2-compliant di sicurezza sotto $5k/month».
+ **confronto**: «confronta Datadog e New Relic», «Splunk vs Elastic per la gestione dei log».
+ **valutazione**: «crea un rapporto di valutazione per Terraform Cloud», «giustifica l'acquisto di New Relic al mio CTO».
### search\_aws\_marketplace\_solutions
Esegue una ricerca diretta nell'API del catalogo. Marketplace AWS Restituisce risultati grezzi, non classificati e non filtrati senza elaborazione AI o punteggio di pertinenza. Supporta query in batch (fino a 10) e l'impaginazione basata su cursori per singole query.
**Ingresso:**
```
{
"queries": ["Drata compliance", "Vanta compliance"],
"max_results": 5,
"cursor": null
}
```
La tabella seguente descrive i parametri di input.
| Campo | Tipo | Campo obbligatorio | Description |
| --- | --- | --- | --- |
| queries | stringa [] | Sì | Matrice di query di ricerca (1-10). Accetta anche versioni legacy query (stringa singola, convertita automaticamente in array). |
| max\_results | numero | No | Numero massimo di risultati per query (1-100, impostazione predefinita: 10). |
| cursor | stringa | No | Cursore di impaginazione (funziona solo per una singola query, ignorato per batch). |
**Output:**
```
{
"results": [
{
"solution_id": "prodview-abc123",
"solution_name": "Drata",
"vendor_name": "Drata Inc",
"vendor_url": "https://aws.amazon.com/marketplace/seller-profile?id=...",
"solution_description": "Continuous compliance automation...",
"solution_url": "https://aws.amazon.com/marketplace/pp/prodview-abc123",
"reviews_summary": {
"reviews_count": 150,
"average_rating": 4.7
}
}
],
"next_cursor": "eyJvZmZzZXQiOjEwLCJwYWdlU2l6ZSI6MTB9"
}
```
La tabella seguente descrive i campi di output.
| Campo | Tipo | Description |
| --- | --- | --- |
| results | MinimalSolutionMetadata[] | Gamma di soluzioni corrispondenti. |
| next\_cursor | stringa \| null | Cursore di impaginazione per la pagina successiva (solo query singola). nullquando non ci sono più risultati. |
**Comportamento in batch:** per più query, i risultati vengono combinati e deduplicati da. `solution_id` Il cursore di impaginazione non viene restituito per le richieste batch.
**Impaginazione:** se `next_cursor` viene restituito (solo richieste a query singola), restituiscilo come `cursor` parametro per recuperare risultati aggiuntivi. Quando `next_cursor` è così`null`, tutte le soluzioni corrispondenti sono state recuperate.
### get\_aws\_marketplace\_solution
Esegue una chiamata diretta all'API Catalog. Marketplace AWS Recupera i metadati completi della soluzione per ID della soluzione senza elaborazione AI. Supporta richieste batch (fino a 10 ID).
**Ingresso:**
```
{
"solution_ids": ["prodview-abc123", "prodview-xyz789"]
}
```
La tabella seguente descrive i parametri di input.
| Campo | Tipo | Campo obbligatorio | Description |
| --- | --- | --- | --- |
| solution\_ids | stringa [] | Sì | Matrice di ID di soluzione (1-10). Gli ID iniziano conprodview-. Accetta anche versioni legacy solution\_id (stringa singola, convertita automaticamente). |
**Output:**
```
{
"solutions": [
{
"solution_id": "prodview-abc123",
"solution_name": "Datadog",
"solution_description": "Comprehensive monitoring and analytics...",
"solution_url": "https://aws.amazon.com/marketplace/pp/prodview-abc123?ref_=...",
"vendor_name": "Datadog, Inc.",
"vendor_url": "https://aws.amazon.com/marketplace/seller-profile?id=...&ref_=...",
"highlights": ["Real-time monitoring", "700+ integrations"],
"reviews_summary": {
"reviews_count": 245,
"average_rating": 4.6
},
"review_sentiments": [
{
"sentiment_category": "functionality",
"overall_polarity": "positive",
"positive_score": "85%",
"negative_score": "5%",
"mixed_score": "10%",
"sample_reviews": [
{
"review_text": "Excellent monitoring capabilities...",
"rating": 5,
"source_name": "G2"
}
]
}
],
"free_trial_available": true,
"pricing_options": [
{
"name": "Infrastructure Monitoring",
"description": "$15 per host per month"
}
],
"fulfillment_options_types": ["SaaS"],
"categories": ["Monitoring & Observability"],
"security_certificates": ["SOC 2 Type II", "ISO 27001"],
"rankings": [{ "category": "Monitoring", "rank": 3 }],
"has_standard_contract": true,
"call_to_action": {
"procurement_url": "https://...",
"request_for_demo_url": "https://...",
"request_for_private_offer_url": "https://...",
"procure_free_trial_url": "https://..."
}
}
]
}
```
La tabella seguente descrive i campi di output.
| Campo | Tipo | Description |
| --- | --- | --- |
| solutions | SolutionOutput[] | Serie di dettagli sulla soluzione (sempre array, anche per ID singolo). |
La tabella seguente descrive i campi di ogni `SolutionOutput` oggetto.
| Campo | Tipo | Description |
| --- | --- | --- |
| solution\_id | stringa | Marketplace AWS ID della soluzione. |
| solution\_name | stringa | Nome del prodotto. |
| solution\_description | stringa | Descrizione lunga o breve. |
| solution\_url | stringa | URL del Marketplace con tag di riferimento. |
| vendor\_name | stringa | Nome visualizzato dal fornitore. |
| vendor\_url | stringa | URL del profilo del fornitore con tag di riferimento. |
| highlights | stringa [] | Caratteristiche salienti del prodotto. |
| reviews\_summary | oggetto | { reviews\_count, average\_rating } |
| review\_sentiments | ReviewSentiment[] | Sentiment per categoria (funzionalità, facilità d'uso, servizio\_cliente, costo\_efficacia) con punteggi di polarità e recensioni di esempio. |
| free\_trial\_available | booleano? | Se è disponibile una prova gratuita. |
| pricing\_options | PricingOption[] | { name, description }coppie. |
| fulfillment\_options\_types | stringa []? | Tipi di evasione degli ordini come SaaS, Container o AMI. |
| categories | stringa []? | Categorie come «Monitoraggio e osservabilità». |
| security\_certificates | stringa []? | Certificazioni come «SOC 2 Type II» o «ISO 27001". |
| rankings | Classificazione []? | { category, rank }— posizione all'interno della categoria (1-100). |
| has\_standard\_contract | booleano? | Se il prodotto supporta AWS Standard Contract. |
| call\_to\_action | CallToAction | { procurement\_url, request\_for\_demo\_url, request\_for\_private\_offer\_url, procure\_free\_trial\_url } |
### get\_aws\_marketplace\_related\_solutions
Esegue una chiamata diretta all'API Catalog. Marketplace AWS Restituisce le soluzioni correlate per determinati ID di soluzione identificate da Marketplace AWS, ordinate per punteggio di relazione (decrescente), senza analisi AI o punteggio di pertinenza. Supporta richieste batch (fino a 10 ID).
**Ingresso:**
```
{
"solution_ids": ["prodview-abc123"]
}
```
La tabella seguente descrive i parametri di input.
| Campo | Tipo | Campo obbligatorio | Description |
| --- | --- | --- | --- |
| solution\_ids | stringa [] | Sì | Matrice di ID di soluzione (1-10). Accetta anche versioni legacy solution\_id (stringa singola, convertita automaticamente). |
**Output:**
```
{
"results": [
{
"solution_id": "prodview-abc123",
"related_solutions": [
{
"solution_id": "prodview-xyz789",
"solution_name": "New Relic",
"vendor_name": "New Relic, Inc.",
"vendor_url": "https://aws.amazon.com/marketplace/seller-profile?id=...",
"solution_description": "Full-stack observability platform...",
"solution_url": "https://aws.amazon.com/marketplace/pp/prodview-xyz789"
}
]
}
]
}
```
La tabella seguente descrive i campi di output.
| Campo | Tipo | Description |
| --- | --- | --- |
| results | SingleRelatedSolutionsResult[] | Una voce per ID della soluzione di input. |
| results[].solution\_id | stringa | L'ID della soluzione di input. |
| results[].related\_solutions | MinimalSolutionMetadata[] | Soluzioni correlate ordinate per rilevanza. |
### research\_aws\_marketplace\_solution
Esegue ricerche approfondite sul web sulle soluzioni. Marketplace AWS Esegue ricerche web per ogni sezione richiesta e restituisce contenuti con link di citazione in linea. Supporta richieste batch (fino a 5 ID).
**Visibilità:** questo strumento è nascosto ai client con funzionalità di ricerca web native (ad esempio, Anthropic/ClaudeAI). Questi clienti ricevono invece istruzioni sul flusso di lavoro con query di ricerca incorporate.
**Ingresso:**
```
{
"solution_ids": ["prodview-abc123", "prodview-xyz789"],
"sections": ["features", "integrations"]
}
```
La tabella seguente descrive i parametri di input.
| Campo | Tipo | Campo obbligatorio | Description |
| --- | --- | --- | --- |
| solution\_ids | stringa [] | Sì | Matrice di ID di soluzione in prodview-\* formato (1-5). |
| sections | ResearchSection[] | No | Sezioni da ricercare. Predefinito: tutte e 7 le sezioni. |
La tabella seguente descrive ogni sezione di ricerca disponibile.
| Sezione | Cosa restituisce |
| --- | --- |
| features | Documentazione ufficiale, funzionalità, specifiche |
| reviews | G2, Gartner, feedback dei clienti TrustRadius |
| limitations | Problemi noti, inconvenienti e critiche |
| competitors | Posizionamento competitivo, alternative |
| pricing | Informazioni sui costi, modelli di prezzo, livelli |
| integrations | AWS ecosistema, API, strumenti di terze parti |
| case\_studies | Storie di successo dei clienti, testimonianze, ROI |
**Output:**
```
{
"results": [
{
"solution_id": "prodview-abc123",
"solution_name": "Datadog",
"research": {
"features": {
"content": "Datadog provides 700+ integrations...",
"citations": [
{
"index": "1",
"title": "Datadog Integrations",
"url": "https://docs.datadoghq.com/integrations/"
}
]
}
}
}
]
}
```
La tabella seguente descrive i campi di output.
| Campo | Tipo | Description |
| --- | --- | --- |
| results | SingleResearchResult[] | Una voce per ID della soluzione di input. |
| results[].solution\_id | stringa | L'ID della soluzione ricercata. |
| results[].solution\_name | stringa | Nome del prodotto risolto dall'ID della soluzione. |
| results[].research | oggetto | Oggetto con chiavi per ogni sezione richiesta. |
| results[].research[section].content | stringa | Contenuti di ricerca con link di citazione in linea. |
| results[].research[section].citations | Citazione [] | { index, title, url }per ogni citazione. |
**Concorrenza:** le soluzioni vengono ricercate in parallelo. Le sezioni all'interno di ciascuna soluzione sono sequenziali per evitare sovraccarichi di servizi a valle.
### submit\_aws\_marketplace\_feedback
Invia il feedback degli utenti su un rapporto. Marketplace AWS Richiama questo strumento dopo aver completato qualsiasi flusso di lavoro di raccomandazione, confronto o valutazione.
**Ingresso:**
```
{
"sentiment": "negative",
"categories": ["incomplete", "other"],
"feedback_text": "Missing pricing details"
}
```
La tabella seguente descrive i parametri di input.
| Campo | Tipo | Campo obbligatorio | Description |
| --- | --- | --- | --- |
| sentiment | enum | Sì | "positive" o "negative". |
| categories | stringa [] | No | Per un feedback negativo:"irrelevant","incomplete","inaccurate","other". |
| feedback\_text | stringa | No | Free-form testo (max 1000 caratteri). |
**Output:**
```
{
"success": true,
"message": "Thank you for your feedback. We'll use it to improve."
}
```
## Flussi di lavoro
Il server Marketplace AWS MCP supporta tre flussi di lavoro principali per la ricerca di prodotti e la ricerca diretta nei cataloghi.
### Generazione di report (consigli, confronti, valutazioni)
Questo è il flusso di lavoro principale per la ricerca sui AI-assisted prodotti. Viene utilizzato `get_aws_marketplace_report_guidelines` come punto di ingresso dell'orchestrazione.
**Flusso:**
1. Chiama `get_aws_marketplace_report_guidelines` con l'appropriato`workflow_type`.
1. Lo strumento restituisce istruzioni dettagliate sul flusso di lavoro e un modello di formato di output.
1. L'assistente AI segue le istruzioni restituite, che in genere comportano la chiamata all'API del catalogo e agli strumenti di ricerca per raccogliere dati.
1. L'assistente genera un report formattato seguendo il modello di output.
1. Dopo aver consegnato il rapporto, l'assistente raccoglie il feedback degli utenti tramite. `submit_aws_marketplace_feedback`
**Flusso di lavoro dei consigli:**
1. `get_aws_marketplace_report_guidelines({ workflow_type: "recommendations" })`
1. `search_aws_marketplace_solutions({ queries: ["Product A", "Product B"], max_results: 3 })`
1. Scrivi il rapporto seguendo il modello di formato.
1. `submit_aws_marketplace_feedback({ sentiment: "positive" })`
**Flusso di lavoro di confronto:**
1. `get_aws_marketplace_report_guidelines({ workflow_type: "comparison" })`
1. `get_aws_marketplace_solution({ solution_ids: ["prodview-abc", "prodview-xyz"] })`
1. `research_aws_marketplace_solution({ solution_ids: [...], sections: ["features", "integrations"] })`
1. Crea una matrice di confronto e scrivi un rapporto seguendo il modello di formato.
1. `submit_aws_marketplace_feedback({ sentiment: "positive" })`
**Flusso di lavoro di valutazione:**
1. `get_aws_marketplace_report_guidelines({ workflow_type: "evaluation" })`
1. `get_aws_marketplace_solution({ solution_ids: ["prodview-target"] })`
1. `research_aws_marketplace_solution({ solution_ids: ["prodview-target"], sections: ["features", "reviews", "limitations", "case_studies"] })`
1. Scrivi un rapporto di valutazione seguendo il modello di formato.
1. `submit_aws_marketplace_feedback({ sentiment: "positive" })`
### Ricerca diretta nel catalogo
Per le integrazioni programmatiche o le ricerche rapide che non richiedono l'analisi dell'intelligenza artificiale, puoi chiamare gli strumenti dell'API del catalogo direttamente senza. `get_aws_marketplace_report_guidelines`
**Cerca e poi cerca i dettagli:**
1. Chiama `search_aws_marketplace_solutions` con una o più domande su parole chiave.
1. Usa i `solution_id` valori restituiti `get_aws_marketplace_solution` per richiedere tutti i dettagli.
1. Facoltativamente, chiama `get_aws_marketplace_related_solutions` per scoprire prodotti correlati.
### Raccolta di feedback
Dopo aver completato qualsiasi flusso di lavoro, l'assistente dovrebbe raccogliere il feedback degli utenti.
1. Chiedi all'utente se la risposta è stata utile.
1. Se positivo, chiama `submit_aws_marketplace_feedback` con`sentiment: "positive"`.
1. Se negativo, chiedi a quali categorie si riferiscono (`irrelevant`,`incomplete`,`inaccurate`,`other`), opzionalmente raccogli feedback a testo libero e invia.
## End-to-end esempio
L'esempio seguente illustra un flusso di lavoro completo per i consigli, dalla richiesta iniziale all'invio del feedback.
**Fase 1: Ottieni le istruzioni sul flusso di lavoro:**
```
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_aws_marketplace_report_guidelines",
"arguments": {
"workflow_type": "recommendations"
}
}
}
```
**Fase 2: Ricerca delle soluzioni candidate:**
```
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "search_aws_marketplace_solutions",
"arguments": {
"queries": ["SIEM security monitoring", "log management SIEM"],
"max_results": 10
}
}
}
```
**Fase 3 — Recupera i metadati dettagliati per i migliori candidati:**
```
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "get_aws_marketplace_solution",
"arguments": {
"solution_ids": ["prodview-abc123", "prodview-def456", "prodview-ghi789"]
}
}
}
```
**Fase 4 — Inviare il feedback degli utenti:**
```
{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
"name": "submit_aws_marketplace_feedback",
"arguments": {
"sentiment": "positive",
"feedback_text": "Recommendations were relevant and well-structured"
}
}
}
```
## Gestione degli errori
Gli errori si dividono in tre categorie: errori di protocollo, errori di esecuzione degli strumenti ed errori di convalida.
### Errori di protocollo
Gli errori di protocollo vengono restituiti quando la richiesta viola la specifica JSON-RPC o MCP (ad esempio, JSON non valido, campi obbligatori mancanti o metodi sconosciuti).
```
{
"jsonrpc": "2.0",
"id": 10,
"error": {
"code": -32602,
"message": "Invalid params",
"data": {
"details": "Missing required field: queries"
}
}
}
```
### Errori di esecuzione dello strumento
Gli errori di esecuzione dello strumento vengono restituiti quando l'invocazione di uno strumento non riesce in fase di esecuzione (ad esempio, limitazione della velocità, ID di soluzione non validi o errori del servizio upstream). Gli errori dello strumento vengono segnalati all'interno dell'oggetto risultato, non come errori a livello di protocollo MCP, in modo che l'assistente AI possa vedere e gestire l'errore.
```
{
"jsonrpc": "2.0",
"id": 11,
"result": {
"content": [
{
"type": "text",
"text": "Failed to search listings: Rate limit exceeded"
}
],
"isError": true
}
}
```
### Errori di convalida
Gli errori di convalida vengono restituiti quando l'input non supera la convalida dello schema (ad esempio, formato ID della soluzione non valido, lunghezza massima dell'array superiore o campi obbligatori mancanti). Questi vengono visualizzati come errori di esecuzione dello strumento con. `isError: true`