Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Spesifikasi alat MCP


Solusi Pengujian Beban Terdistribusi memperlihatkan seperangkat alat MCP yang memungkinkan agen AI berinteraksi dengan skenario dan hasil pengujian. Alat-alat ini memberikan kemampuan abstrak tingkat tinggi yang selaras dengan cara agen AI memproses informasi, memungkinkan mereka untuk fokus pada analisis dan wawasan daripada kontrak API terperinci.

**catatan**  
Semua alat MCP menyediakan akses hanya-baca ke data solusi. Tidak ada modifikasi untuk menguji skenario atau konfigurasi yang didukung melalui antarmuka MCP.

## list\$1scenario


### Deskripsi


`list_scenarios`Alat ini mengambil daftar semua skenario pengujian yang tersedia dengan metadata dasar.

### Titik akhir


 `GET /scenarios` 

### Parameter


Tidak ada

### Respons



| Nama | Deskripsi | 
| --- | --- | 
|   `testId`   |  Pengidentifikasi unik untuk skenario pengujian  | 
|   `testName`   |  Nama skenario pengujian  | 
|   `status`   |  Status skenario pengujian saat ini  | 
|   `startTime`   |  Saat pengujian dibuat atau terakhir dijalankan  | 
|   `testDescription`   |  Deskripsi skenario pengujian  | 

## get\$1scenario\$1details


### Deskripsi


`get_scenario_details`Alat ini mengambil konfigurasi pengujian dan uji coba terbaru untuk satu skenario pengujian.

### Titik akhir


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

### Parameter permintaan


 `test_id`   
+ Pengidentifikasi unik untuk skenario pengujian

  Tipe: String

  Diperlukan: Ya

### Respons



| Nama | Deskripsi | 
| --- | --- | 
|   `testTaskConfigs`   |  Konfigurasi tugas untuk setiap wilayah  | 
|   `testScenario`   |  Definisi dan parameter uji  | 
|   `status`   |  Status tes saat ini  | 
|   `startTime`   |  Uji stempel waktu mulai  | 
|   `endTime`   |  Stempel waktu akhir uji (jika selesai)  | 

## list\$1test\$1runs


### Deskripsi


`list_test_runs`Alat ini mengambil daftar uji coba untuk skenario pengujian tertentu, diurutkan terbaru ke yang terlama. Mengembalikan maksimal 30 hasil.

### Titik akhir


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

atau

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

### Permintaan parameter


 `test_id`   
+ Pengidentifikasi unik untuk skenario pengujian

  Tipe: String

  Diperlukan: Ya

 `limit`   
+ Jumlah maksimum uji coba yang akan dikembalikan

  Jenis: Integer

  Default: 20

  Maksimum: 30

  Wajib: Tidak

 `start_date`   
+ Stempel waktu ISO 8601 untuk memfilter berjalan dari tanggal tertentu

  Jenis: String (format tanggal-waktu)

  Wajib: Tidak

 `end_date`   
+ Stempel waktu ISO 8601 untuk memfilter berjalan hingga tanggal tertentu

  Jenis: String (format tanggal-waktu)

  Wajib: Tidak

### Respons



| Nama | Deskripsi | 
| --- | --- | 
|   `testRuns`   |  Array ringkasan uji coba dengan metrik kinerja dan persentil untuk setiap proses  | 

## get\$1test\$1run


### Deskripsi


`get_test_run`Alat ini mengambil hasil terperinci untuk satu uji coba dengan kerusakan regional dan titik akhir.

### Titik akhir


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

### Permintaan parameter


 `test_id`   
+ Pengidentifikasi unik untuk skenario pengujian

  Tipe: String

  Diperlukan: Ya

 `test_run_id`   
+ Pengidentifikasi unik untuk uji coba tertentu

  Tipe: String

  Diperlukan: Ya

### Respons



| Nama | Deskripsi | 
| --- | --- | 
|   `results`   |  Data uji coba lengkap termasuk rincian hasil regional, metrik spesifik titik akhir, persentil kinerja (p50, p90, p95, p99), jumlah keberhasilan dan kegagalan, waktu respons dan latensi, dan konfigurasi pengujian yang digunakan untuk menjalankan  | 

## get\$1latest\$1test\$1run


### Deskripsi


`get_latest_test_run`Alat ini mengambil uji coba terbaru untuk skenario pengujian tertentu.

### Titik akhir


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

**catatan**  
Hasil diurutkan berdasarkan waktu menggunakan Indeks Sekunder Global (GSI), memastikan uji coba terbaru dikembalikan.

### Parameter permintaan


 `test_id`   
+ Pengidentifikasi unik untuk skenario pengujian

  Tipe: String

  Diperlukan: Ya

### Respons



| Nama | Deskripsi | 
| --- | --- | 
|   `results`   |  Data uji coba terbaru dengan format yang sama dengan `get_test_run`   | 

## get\$1baseline\$1test\$1run


### Deskripsi


`get_baseline_test_run`Alat ini mengambil uji dasar yang dijalankan untuk skenario pengujian tertentu. Baseline digunakan untuk tujuan perbandingan kinerja.

### Titik akhir


 `GET /scenarios/<test_id>/baseline` 

### Parameter permintaan


 `test_id`   
+ Pengidentifikasi unik untuk skenario pengujian

  Tipe: String

  Diperlukan: Ya

### Respons



| Nama | Deskripsi | 
| --- | --- | 
|   `baselineData`   |  Data uji coba dasar untuk tujuan perbandingan, termasuk semua metrik dan konfigurasi dari baseline run yang ditentukan  | 

## get\$1test\$1run\$1artefak


### Deskripsi


`get_test_run_artifacts`Alat ini mengambil informasi bucket Amazon S3 untuk mengakses artefak pengujian termasuk log, file kesalahan, dan hasil.

### Titik akhir


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

### Permintaan parameter


 `test_id`   
+ Pengidentifikasi unik untuk skenario pengujian

  Tipe: String

  Diperlukan: Ya

 `test_run_id`   
+ Pengidentifikasi unik untuk uji coba tertentu

  Tipe: String

  Diperlukan: Ya

### Respons



| Nama | Deskripsi | 
| --- | --- | 
|   `bucketName`   |  Nama bucket S3 tempat artefak disimpan  | 
|   `testRunPath`   |  Awalan jalur untuk penyimpanan artefak saat ini (versi 4.0\$1)  | 
|   `testScenarioPath`   |  Awalan jalur untuk penyimpanan artefak lama (pra-versi 4.0)  | 

**catatan**  
Semua alat MCP memanfaatkan titik akhir API yang ada. Tidak ada modifikasi pada yang mendasari APIs yang diperlukan untuk mendukung fungsionalitas MCP.