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
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
Description
Lo list_scenarios strumento recupera un elenco di tutti gli scenari di test disponibili con metadati di base.
Endpoint
GET /scenarios
Parameters
Nessuno
Risposta
| Nome | Description |
|---|---|
|
|
Identificatore univoco per lo scenario di test |
|
|
Nome dello scenario di test |
|
|
Stato attuale dello scenario di test |
|
|
Quando il test è stato creato o eseguito l'ultima volta |
|
|
Descrizione dello scenario di test |
get_scenario_details
Description
Lo get_scenario_details strumento recupera la configurazione del test e l'esecuzione del test più recente per un singolo scenario di test.
Endpoint
GET /scenarios/<test_id>?history=false&results=false
Parametro di richiesta
-
test_id -
-
L'identificatore univoco per lo scenario di test
Tipo: stringa
Campo obbligatorio: sì
-
Risposta
| Nome | Description |
|---|---|
|
|
Configurazione delle attività per ogni regione |
|
|
Definizione e parametri del test |
|
|
Stato attuale del test |
|
|
Timestamp di inizio del test |
|
|
Timestamp di fine del test (se completato) |
list_test_runs
Description
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
GET /scenarios/<testid>/testruns/?limit=<limit>
oppure
GET /scenarios/<testid>/testruns/?limit=30&start_date=<start_date>&end_date=<end_date>
Parametri della richiesta
-
test_id -
-
L'identificatore univoco per lo scenario di test
Tipo: stringa
Campo obbligatorio: sì
-
-
limit -
-
Numero massimo di esecuzioni di test da restituire
Tipo: integer
Impostazione predefinita: 20
Massimo: 30
Campo obbligatorio: no
-
-
start_date -
-
Il timestamp ISO 8601 per il filtraggio viene eseguito a partire da una data specifica
Tipo: Stringa (formato data-ora)
Campo obbligatorio: no
-
-
end_date -
-
Il timestamp ISO 8601 da filtrare viene eseguito fino a una data specifica
Tipo: Stringa (formato data-ora)
Campo obbligatorio: no
-
Risposta
| Nome | Description |
|---|---|
|
|
Serie di riepiloghi delle esecuzioni di test con metriche e percentili delle prestazioni per ogni esecuzione |
get_test_run
Description
Lo get_test_run strumento recupera i risultati dettagliati per una singola esecuzione di test con suddivisioni regionali ed endpoint.
Endpoint
GET /scenarios/<testid>/testruns/<testrunid>
Parametri della richiesta
-
test_id -
-
L'identificatore univoco per lo scenario di test
Tipo: stringa
Campo obbligatorio: sì
-
-
test_run_id -
-
L'identificatore univoco per l'esecuzione specifica del test
Tipo: stringa
Campo obbligatorio: sì
-
Risposta
| Nome | Description |
|---|---|
|
|
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
Description
Lo get_latest_test_run strumento recupera il test eseguito più recentemente per uno scenario di test specifico.
Endpoint
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
-
test_id -
-
L'identificatore univoco per lo scenario di test
Tipo: stringa
Campo obbligatorio: sì
-
Risposta
| Nome | Description |
|---|---|
|
|
Dati di esecuzione del test più recenti con lo stesso formato di |
get_baseline_test_run
Description
get_baseline_test_runLo strumento recupera l'esecuzione del test di base per uno scenario di test specifico. La baseline viene utilizzata per scopi di confronto delle prestazioni.
Endpoint
GET /scenarios/<test_id>/baseline
Parametro di richiesta
-
test_id -
-
L'identificatore univoco per lo scenario di test
Tipo: stringa
Campo obbligatorio: sì
-
Risposta
| Nome | Description |
|---|---|
|
|
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
Description
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
GET /scenarios/<testid>/testruns/<testrunid>
Parametri della richiesta
-
test_id -
-
L'identificatore univoco per lo scenario di test
Tipo: stringa
Campo obbligatorio: sì
-
-
test_run_id -
-
L'identificatore univoco per l'esecuzione specifica del test
Tipo: stringa
Campo obbligatorio: sì
-
Risposta
| Nome | Description |
|---|---|
|
|
Nome del bucket S3 in cui sono archiviati gli artefatti |
|
|
Prefisso del percorso per l'attuale archiviazione degli artefatti (versione 4.0+) |
|
|
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.
