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à.

# Specifiche degli strumenti MCP
<a name="mcp-tools-specification"></a>

La soluzione Distributed Load Testing espone una serie di strumenti MCP che consentono agli agenti AI di interagire con gli scenari e i risultati dei test. Questi strumenti forniscono funzionalità astratte di alto livello che si allineano al modo in cui gli agenti di intelligenza artificiale elaborano le informazioni, consentendo loro di concentrarsi sull'analisi e sugli approfondimenti anziché su contratti API dettagliati.

**Nota**  
Tutti gli strumenti MCP forniscono accesso in sola lettura ai dati della soluzione. Nessuna modifica agli scenari o alle configurazioni di test è supportata tramite l'interfaccia MCP.

## list\_scenarios
<a name="list-scenarios-tool"></a>

### Description
<a name="list-scenarios-tool-description"></a>

Lo `list_scenarios` strumento recupera un elenco di tutti gli scenari di test disponibili con metadati di base.

### Endpoint
<a name="list-scenarios-tool-endpoint"></a>

 `GET /scenarios` 

### Parameters
<a name="list-scenarios-tool-parameters"></a>

Nessuno

### Risposta
<a name="list-scenarios-tool-response"></a>


| Nome | Description | 
| --- | --- | 
|  `testId`  | Identificatore univoco per lo scenario di test | 
|  `testName`  | Nome dello scenario di test | 
|  `status`  | Stato attuale dello scenario di test | 
|  `startTime`  | Quando il test è stato creato o eseguito l'ultima volta | 
|  `testDescription`  | Descrizione dello scenario di test | 

## get\_scenario\_details
<a name="get-scenario-details-tool"></a>

### Description
<a name="get-scenario-details-tool-description"></a>

Lo `get_scenario_details` strumento recupera la configurazione del test e l'esecuzione del test più recente per un singolo scenario di test.

### Endpoint
<a name="get-scenario-details-tool-endpoint"></a>

 `GET /scenarios/<test_id>?history=false&results=false` 

### Parametro di richiesta
<a name="get-scenario-details-tool-request"></a>

 `test_id`   
+ L'identificatore univoco per lo scenario di test

  Tipo: stringa

  Obbligatorio: sì

### Risposta
<a name="get-scenario-details-tool-response"></a>


| Nome | Description | 
| --- | --- | 
|  `testTaskConfigs`  | Configurazione delle attività per ogni regione | 
|  `testScenario`  | Definizione e parametri del test | 
|  `status`  | Stato attuale del test | 
|  `startTime`  | Timestamp di inizio del test | 
|  `endTime`  | Timestamp di fine del test (se completato) | 

## list\_test\_runs
<a name="list-test-runs-tool"></a>

### Description
<a name="list-test-runs-tool-description"></a>

Lo `list_test_runs` strumento recupera un elenco di esecuzioni di test per uno scenario di test specifico, ordinate dalla più recente alla meno recente. Restituisce un massimo di 30 risultati.

### Endpoint
<a name="list-test-runs-tool-endpoint"></a>

 `GET /scenarios/<testid>/testruns/?limit=<limit>` 

or

 `GET /scenarios/<testid>/testruns/?limit=30&start_date=<start_date>&end_date=<end_date>` 

### Parametri della richiesta
<a name="list-test-runs-tool-request"></a>

 `test_id`   
+ L'identificatore univoco per lo scenario di test

  Tipo: stringa

  Obbligatorio: sì

 `limit`   
+ Numero massimo di esecuzioni di test da restituire

  Tipo: numero intero

  Impostazione predefinita: 20

  Massimo: 30

  Obbligatorio: no

 `start_date`   
+ Il timestamp ISO 8601 per il filtraggio parte da una data specifica

  Tipo: Stringa (formato data-ora)

  Obbligatorio: no

 `end_date`   
+ Il timestamp ISO 8601 da filtrare viene eseguito fino a una data specifica

  Tipo: Stringa (formato data-ora)

  Obbligatorio: no

### Risposta
<a name="list-test-runs-tool-response"></a>


| Nome | Description | 
| --- | --- | 
|  `testRuns`  | Serie di riepiloghi delle esecuzioni di test con metriche e percentili delle prestazioni per ogni esecuzione | 

## get\_test\_run
<a name="get-test-run-tool"></a>

### Description
<a name="get-test-run-tool-description"></a>

Lo `get_test_run` strumento recupera i risultati dettagliati per una singola esecuzione di test con suddivisioni regionali ed endpoint.

### Endpoint
<a name="get-test-run-tool-endpoint"></a>

 `GET /scenarios/<testid>/testruns/<testrunid>` 

### Parametri della richiesta
<a name="get-test-run-tool-request"></a>

 `test_id`   
+ L'identificatore univoco per lo scenario di test

  Tipo: stringa

  Obbligatorio: sì

 `test_run_id`   
+ L'identificatore univoco per l'esecuzione specifica del test

  Tipo: stringa

  Obbligatorio: sì

### Risposta
<a name="get-test-run-tool-response"></a>


| Nome | Description | 
| --- | --- | 
|  `results`  | Dati completi sull'esecuzione del test, tra cui la ripartizione dei risultati regionali, le metriche specifiche degli endpoint, i percentili di prestazioni (p50, p90, p95, p99), il numero di successi e fallimenti, i tempi di risposta e la latenza e la configurazione del test utilizzata per l'esecuzione | 

## get\_latest\_test\_run
<a name="get-latest-test-run-tool"></a>

### Description
<a name="get-latest-test-run-tool-description"></a>

Lo `get_latest_test_run` strumento recupera il test eseguito più recentemente per uno scenario di test specifico.

### Endpoint
<a name="get-latest-test-run-tool-endpoint"></a>

 `GET /scenarios/<testid>/testruns/?limit=1` 

**Nota**  
I risultati vengono ordinati in base all'ora utilizzando un indice secondario globale (GSI), che garantisce la restituzione del test eseguito più recente.

### Parametro di richiesta
<a name="get-latest-test-run-tool-request"></a>

 `test_id`   
+ L'identificatore univoco per lo scenario di test

  Tipo: stringa

  Obbligatorio: sì

### Risposta
<a name="get-latest-test-run-tool-response"></a>


| Nome | Description | 
| --- | --- | 
|  `results`  | Dati di esecuzione del test più recenti con lo stesso formato di `get_test_run`  | 

## get\_baseline\_test\_run
<a name="get-baseline-test-run-tool"></a>

### Description
<a name="get-baseline-test-run-tool-description"></a>

`get_baseline_test_run`Lo strumento recupera l'esecuzione del test di base per uno scenario di test specifico. La baseline viene utilizzata per il confronto delle prestazioni.

### Endpoint
<a name="get-baseline-test-run-tool-endpoint"></a>

 `GET /scenarios/<test_id>/baseline` 

### Parametro di richiesta
<a name="get-baseline-test-run-tool-request"></a>

 `test_id`   
+ L'identificatore univoco per lo scenario di test

  Tipo: stringa

  Obbligatorio: sì

### Risposta
<a name="get-baseline-test-run-tool-response"></a>


| Nome | Description | 
| --- | --- | 
|  `baselineData`  | Dati di base relativi all'esecuzione del test a scopo di confronto, incluse tutte le metriche e la configurazione relative all'esecuzione di base designata | 

## get\_test\_run\_artifacts
<a name="get-test-run-artifacts-tool"></a>

### Description
<a name="get-test-run-artifacts-tool-description"></a>

Lo `get_test_run_artifacts` strumento recupera le informazioni sui bucket Amazon S3 per accedere agli artefatti dei test, inclusi log, file di errore e risultati.

### Endpoint
<a name="get-test-run-artifacts-tool-endpoint"></a>

 `GET /scenarios/<testid>/testruns/<testrunid>` 

### Parametri della richiesta
<a name="get-test-run-artifacts-tool-request"></a>

 `test_id`   
+ L'identificatore univoco per lo scenario di test

  Tipo: stringa

  Obbligatorio: sì

 `test_run_id`   
+ L'identificatore univoco per l'esecuzione specifica del test

  Tipo: stringa

  Obbligatorio: sì

### Risposta
<a name="get-test-run-artifacts-tool-response"></a>


| Nome | Description | 
| --- | --- | 
|  `bucketName`  | Nome del bucket S3 in cui sono archiviati gli artefatti | 
|  `testRunPath`  | Prefisso del percorso per l'attuale archiviazione degli artefatti (versione 4.0\+) | 
|  `testScenarioPath`  | Prefisso del percorso per l'archiviazione degli artefatti legacy (versione precedente alla 4.0) | 

**Nota**  
Tutti gli strumenti MCP sfruttano gli endpoint API esistenti. Non sono necessarie modifiche al sottostante per supportare la APIs funzionalità MCP.