Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Spécification des outils MCP
<a name="mcp-tools-specification"></a>

La solution de test de charge distribué expose un ensemble d'outils MCP qui permettent aux agents d'intelligence artificielle d'interagir avec les scénarios et les résultats des tests. Ces outils fournissent des fonctionnalités abstraites de haut niveau qui correspondent à la façon dont les agents d'IA traitent les informations, ce qui leur permet de se concentrer sur l'analyse et les informations plutôt que sur des contrats d'API détaillés.

**Note**  
Tous les outils MCP fournissent un accès en lecture seule aux données de la solution. Aucune modification des scénarios ou des configurations de test n'est prise en charge via l'interface MCP.

## liste\$1scénarios
<a name="list-scenarios-tool"></a>

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

L'`list_scenarios`outil extrait une liste de tous les scénarios de test disponibles avec des métadonnées de base.

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

 `GET /scenarios` 

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

Aucune

### Réponse
<a name="list-scenarios-tool-response"></a>


| Nom | Description | 
| --- | --- | 
|   `testId`   |  Identifiant unique pour le scénario de test  | 
|   `testName`   |  Nom du scénario de test  | 
|   `status`   |  État actuel du scénario de test  | 
|   `startTime`   |  Date de création ou de dernière exécution du test  | 
|   `testDescription`   |  Description du scénario de test  | 

## get\$1scenario\$1details
<a name="get-scenario-details-tool"></a>

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

L'`get_scenario_details`outil récupère la configuration de test et la dernière exécution de test pour un seul scénario de test.

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

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

### Paramètre de demande
<a name="get-scenario-details-tool-request"></a>

 `test_id`   
+ L'identifiant unique du scénario de test

  Type : Chaîne

  Obligatoire : oui

### Réponse
<a name="get-scenario-details-tool-response"></a>


| Nom | Description | 
| --- | --- | 
|   `testTaskConfigs`   |  Configuration des tâches pour chaque région  | 
|   `testScenario`   |  Définition et paramètres du test  | 
|   `status`   |  État actuel du test  | 
|   `startTime`   |  Horodatage de début du test  | 
|   `endTime`   |  Horodatage de fin du test (s'il est terminé)  | 

## list\$1test\$1runs
<a name="list-test-runs-tool"></a>

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

L'`list_test_runs`outil récupère une liste de tests pour un scénario de test spécifique, triée du plus récent au plus ancien. Renvoie un maximum de 30 résultats.

### 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>` 

### Paramètres de demande
<a name="list-test-runs-tool-request"></a>

 `test_id`   
+ L'identifiant unique du scénario de test

  Type : Chaîne

  Obligatoire : oui

 `limit`   
+ Nombre maximum de tests à renvoyer

  Type : Integer

  Valeur par défaut : 20

  Maximum : 30

  Obligatoire : non

 `start_date`   
+ Horodatage ISO 8601 pour filtrer les séries à partir d'une date spécifique

  Type : chaîne (format date-heure)

  Obligatoire : non

 `end_date`   
+ Horodatage ISO 8601 pour filtrer les exécutions jusqu'à une date précise

  Type : chaîne (format date-heure)

  Obligatoire : non

### Réponse
<a name="list-test-runs-tool-response"></a>


| Nom | Description | 
| --- | --- | 
|   `testRuns`   |  Tableau de résumés des essais avec indicateurs de performance et percentiles pour chaque cycle  | 

## get\$1test\$1run
<a name="get-test-run-tool"></a>

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

L'`get_test_run`outil récupère les résultats détaillés d'un seul test avec des ventilations par région et par point de terminaison.

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

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

### Paramètres de demande
<a name="get-test-run-tool-request"></a>

 `test_id`   
+ L'identifiant unique du scénario de test

  Type : Chaîne

  Obligatoire : oui

 `test_run_id`   
+ L'identifiant unique pour le cycle de test spécifique

  Type : Chaîne

  Obligatoire : oui

### Réponse
<a name="get-test-run-tool-response"></a>


| Nom | Description | 
| --- | --- | 
|   `results`   |  Données complètes des tests, y compris la répartition des résultats régionaux, les mesures spécifiques aux terminaux, les percentiles de performance (p50, p90, p95, p99), le nombre de réussites et d'échecs, les temps de réponse et la latence, ainsi que la configuration de test utilisée pour l'exécution  | 

## get\$1latest\$1test\$1run
<a name="get-latest-test-run-tool"></a>

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

L'`get_latest_test_run`outil récupère le dernier test pour un scénario de test spécifique.

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

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

**Note**  
Les résultats sont triés par heure à l'aide d'un index secondaire global (GSI), ce qui garantit que le test le plus récent est renvoyé.

### Paramètre de demande
<a name="get-latest-test-run-tool-request"></a>

 `test_id`   
+ L'identifiant unique du scénario de test

  Type : Chaîne

  Obligatoire : oui

### Réponse
<a name="get-latest-test-run-tool-response"></a>


| Nom | Description | 
| --- | --- | 
|   `results`   |  Données de test les plus récentes au même format que `get_test_run`   | 

## get\$1baseline\$1test\$1run
<a name="get-baseline-test-run-tool"></a>

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

L'`get_baseline_test_run`outil récupère le test de référence pour un scénario de test spécifique. La base de référence est utilisée à des fins de comparaison des performances.

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

 `GET /scenarios/<test_id>/baseline` 

### Paramètre de demande
<a name="get-baseline-test-run-tool-request"></a>

 `test_id`   
+ L'identifiant unique du scénario de test

  Type : Chaîne

  Obligatoire : oui

### Réponse
<a name="get-baseline-test-run-tool-response"></a>


| Nom | Description | 
| --- | --- | 
|   `baselineData`   |  Données de test de référence à des fins de comparaison, y compris toutes les mesures et configurations issues de l'exécution de référence désignée  | 

## get\$1test\$1run\$1artefacts
<a name="get-test-run-artifacts-tool"></a>

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

L'`get_test_run_artifacts`outil récupère les informations du compartiment Amazon S3 pour accéder aux artefacts de test, notamment les journaux, les fichiers d'erreurs et les résultats.

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

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

### Paramètres de demande
<a name="get-test-run-artifacts-tool-request"></a>

 `test_id`   
+ L'identifiant unique du scénario de test

  Type : Chaîne

  Obligatoire : oui

 `test_run_id`   
+ L'identifiant unique pour le cycle de test spécifique

  Type : Chaîne

  Obligatoire : oui

### Réponse
<a name="get-test-run-artifacts-tool-response"></a>


| Nom | Description | 
| --- | --- | 
|   `bucketName`   |  Nom du compartiment S3 dans lequel les artefacts sont stockés  | 
|   `testRunPath`   |  Préfixe de chemin pour le stockage actuel des artefacts (version 4.0\$1)  | 
|   `testScenarioPath`   |  Préfixe de chemin pour le stockage des artefacts existants (version antérieure à 4.0)  | 

**Note**  
Tous les outils MCP exploitent les points de terminaison d'API existants. Aucune modification du APIs sous-jacent n'est requise pour prendre en charge la fonctionnalité MCP.