Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Spezifikation der MCP-Tools
<a name="mcp-tools-specification"></a>

Die Distributed Load Testing-Lösung bietet eine Reihe von MCP-Tools, mit denen KI-Agenten mit Testszenarien und Ergebnissen interagieren können. Diese Tools bieten umfassende, abstrakte Funktionen, die auf die Art und Weise abgestimmt sind, wie KI-Agenten Informationen verarbeiten, sodass sie sich auf Analysen und Erkenntnisse konzentrieren können, anstatt sich auf detaillierte API-Verträge zu konzentrieren.

**Anmerkung**  
Alle MCP-Tools bieten nur Lesezugriff auf die Daten der Lösung. Über die MCP-Schnittstelle werden keine Änderungen an Testszenarien oder Konfigurationen unterstützt.

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

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

Das `list_scenarios` Tool ruft eine Liste aller verfügbaren Testszenarien mit grundlegenden Metadaten ab.

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

 `GET /scenarios` 

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

Keine

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


| Name | Description | 
| --- | --- | 
|  `testId`  | Eindeutiger Bezeichner für das Testszenario | 
|  `testName`  | Name des Testszenarios | 
|  `status`  | Aktueller Status des Testszenarios | 
|  `startTime`  | Wann der Test erstellt oder zuletzt ausgeführt wurde | 
|  `testDescription`  | Beschreibung des Testszenarios | 

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

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

Das `get_scenario_details` Tool ruft die Testkonfiguration und den letzten Testlauf für ein einzelnes Testszenario ab.

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

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

### Parameter anfordern
<a name="get-scenario-details-tool-request"></a>

 `test_id`   
+ Die eindeutige Kennung für das Testszenario

  Typ: Zeichenfolge

  Erforderlich: Ja

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


| Name | Description | 
| --- | --- | 
|  `testTaskConfigs`  | Aufgabenkonfiguration für jede Region | 
|  `testScenario`  | Testdefinition und Parameter | 
|  `status`  | Aktueller Teststatus | 
|  `startTime`  | Zeitstempel für den Teststart | 
|  `endTime`  | Endzeitstempel des Tests (falls abgeschlossen) | 

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

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

Das `list_test_runs` Tool ruft eine Liste von Testläufen für ein bestimmtes Testszenario ab, sortiert vom neuesten zum ältesten. Gibt maximal 30 Ergebnisse zurück.

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

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

oder

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

### Anforderungsparameter
<a name="list-test-runs-tool-request"></a>

 `test_id`   
+ Der eindeutige Bezeichner für das Testszenario

  Typ: Zeichenfolge

  Erforderlich: Ja

 `limit`   
+ Maximale Anzahl zurückzugebender Testläufe

  Typ: Ganzzahl

  Standard: 20

  Maximum: 30

  Erforderlich: Nein

 `start_date`   
+ ISO 8601-Zeitstempel zum Filtern von Läufen ab einem bestimmten Datum

  Typ: Zeichenfolge (Datums-/Uhrzeitformat)

  Erforderlich: Nein

 `end_date`   
+ Der ISO 8601-Zeitstempel zum Filtern läuft bis zu einem bestimmten Datum

  Typ: Zeichenfolge (Datums-/Uhrzeitformat)

  Erforderlich: Nein

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


| Name | Description | 
| --- | --- | 
|  `testRuns`  | Reihe von Testlaufzusammenfassungen mit Leistungskennzahlen und Perzentilen für jeden Lauf | 

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

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

Das `get_test_run` Tool ruft detaillierte Ergebnisse für einen einzelnen Testlauf mit regionalen und Endpunktaufschlüsselungen ab.

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

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

### Anforderungsparameter
<a name="get-test-run-tool-request"></a>

 `test_id`   
+ Die eindeutige Kennung für das Testszenario

  Typ: Zeichenfolge

  Erforderlich: Ja

 `test_run_id`   
+ Die eindeutige Kennung für den spezifischen Testlauf

  Typ: Zeichenfolge

  Erforderlich: Ja

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


| Name | Description | 
| --- | --- | 
|  `results`  | Vollständige Testlaufdaten, einschließlich Aufschlüsselung der regionalen Ergebnisse, endpunktspezifischer Metriken, Leistungsperzentile (p50, p90, p95, p99), Erfolgs- und Fehlschlagzahlen, Reaktionszeiten und Latenz sowie der für den Testlauf verwendeten Testkonfiguration | 

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

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

Das `get_latest_test_run` Tool ruft den letzten Testlauf für ein bestimmtes Testszenario ab.

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

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

**Anmerkung**  
Die Ergebnisse werden anhand eines Global Secondary Index (GSI) nach Zeit sortiert, sodass sichergestellt wird, dass der letzte Testlauf zurückgegeben wird.

### Anforderungsparameter
<a name="get-latest-test-run-tool-request"></a>

 `test_id`   
+ Die eindeutige Kennung für das Testszenario

  Typ: Zeichenfolge

  Erforderlich: Ja

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


| Name | Description | 
| --- | --- | 
|  `results`  | Aktuelle Testlaufdaten mit demselben Format wie `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>

Das `get_baseline_test_run` Tool ruft den Basistestlauf für ein bestimmtes Testszenario ab. Die Baseline wird zu Leistungsvergleichszwecken verwendet.

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

 `GET /scenarios/<test_id>/baseline` 

### Anforderungsparameter
<a name="get-baseline-test-run-tool-request"></a>

 `test_id`   
+ Die eindeutige Kennung für das Testszenario

  Typ: Zeichenfolge

  Erforderlich: Ja

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


| Name | Description | 
| --- | --- | 
|  `baselineData`  | Basisdaten des Testlaufs zu Vergleichszwecken, einschließlich aller Metriken und Konfigurationen aus dem angegebenen Baselinelauf | 

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

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

Das `get_test_run_artifacts` Tool ruft Amazon S3 S3-Bucket-Informationen für den Zugriff auf Testartefakte wie Protokolle, Fehlerdateien und Ergebnisse ab.

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

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

### Anforderungsparameter
<a name="get-test-run-artifacts-tool-request"></a>

 `test_id`   
+ Die eindeutige Kennung für das Testszenario

  Typ: Zeichenfolge

  Erforderlich: Ja

 `test_run_id`   
+ Die eindeutige Kennung für den spezifischen Testlauf

  Typ: Zeichenfolge

  Erforderlich: Ja

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


| Name | Description | 
| --- | --- | 
|  `bucketName`  | Name des S3-Buckets, in dem Artefakte gespeichert werden | 
|  `testRunPath`  | Pfadpräfix für den aktuellen Artefaktspeicher (Version 4.0\+) | 
|  `testScenarioPath`  | Pfadpräfix für älteren Artefaktspeicher (vor Version 4.0) | 

**Anmerkung**  
Alle MCP-Tools nutzen bestehende API-Endpunkte. Zur Unterstützung der MCP-Funktionalität APIs sind keine Änderungen am Basisprodukt erforderlich.