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
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_scénarios
Description
L'list_scenariosoutil extrait une liste de tous les scénarios de test disponibles avec des métadonnées de base.
Endpoint
GET /scenarios
Parameters
Aucune
Réponse
| Nom | Description |
|---|---|
|
|
Identifiant unique pour le scénario de test |
|
|
Nom du scénario de test |
|
|
État actuel du scénario de test |
|
|
Date de création ou de dernière exécution du test |
|
|
Description du scénario de test |
get_scenario_details
Description
L'get_scenario_detailsoutil récupère la configuration de test et la dernière exécution de test pour un seul scénario de test.
Endpoint
GET /scenarios/<test_id>?history=false&results=false
Paramètre de demande
-
test_id -
-
L'identifiant unique du scénario de test
Type : String
Obligatoire : oui
-
Réponse
| Nom | Description |
|---|---|
|
|
Configuration des tâches pour chaque région |
|
|
Définition et paramètres du test |
|
|
État actuel du test |
|
|
Horodatage de début du test |
|
|
Horodatage de fin du test (s'il est terminé) |
list_test_runs
Description
L'list_test_runsoutil 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
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
-
test_id -
-
L'identifiant unique du scénario de test
Type : String
Obligatoire : oui
-
-
limit -
-
Nombre maximum de tests à renvoyer
Type : entier
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
| Nom | Description |
|---|---|
|
|
Tableau de résumés des essais avec indicateurs de performance et percentiles pour chaque cycle |
get_test_run
Description
L'get_test_runoutil 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
GET /scenarios/<testid>/testruns/<testrunid>
Paramètres de demande
-
test_id -
-
L'identifiant unique du scénario de test
Type : String
Obligatoire : oui
-
-
test_run_id -
-
L'identifiant unique pour le cycle de test spécifique
Type : String
Obligatoire : oui
-
Réponse
| Nom | Description |
|---|---|
|
|
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_latest_test_run
Description
L'get_latest_test_runoutil récupère le dernier test pour un scénario de test spécifique.
Endpoint
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
-
test_id -
-
L'identifiant unique du scénario de test
Type : String
Obligatoire : oui
-
Réponse
| Nom | Description |
|---|---|
|
|
Données de test les plus récentes au même format que |
get_baseline_test_run
Description
L'get_baseline_test_runoutil 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
GET /scenarios/<test_id>/baseline
Paramètre de demande
-
test_id -
-
L'identifiant unique du scénario de test
Type : String
Obligatoire : oui
-
Réponse
| Nom | Description |
|---|---|
|
|
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_test_run_artefacts
Description
L'get_test_run_artifactsoutil 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
GET /scenarios/<testid>/testruns/<testrunid>
Paramètres de demande
-
test_id -
-
L'identifiant unique du scénario de test
Type : String
Obligatoire : oui
-
-
test_run_id -
-
L'identifiant unique pour le cycle de test spécifique
Type : String
Obligatoire : oui
-
Réponse
| Nom | Description |
|---|---|
|
|
Nom du compartiment S3 dans lequel les artefacts sont stockés |
|
|
Préfixe de chemin pour le stockage actuel des artefacts (version 4.0+) |
|
|
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.
