MCP 工具規格 - AWS 上的分散式負載測試
list_scenariosget_scenario_detailslist_test_runsget_test_runget_latest_test_runget_baseline_test_runget_test_run_artifacts

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

MCP 工具規格

分散式負載測試解決方案公開了一組 MCP 工具，可讓 AI 代理器與測試案例和結果互動。這些工具提供高階的抽象功能，符合 AI 代理器處理資訊的方式，讓他們能夠專注於分析和洞見，而不是詳細的 API 合約。

注意

所有 MCP 工具都提供對解決方案資料的唯讀存取。不支援透過 MCP 介面修改測試案例或組態。

list_scenarios

說明

此list_scenarios工具會擷取所有可用測試案例的清單，其中包含基本中繼資料。

Endpoint

GET /scenarios

Parameters

無

回應

名稱 描述

testId

測試案例的唯一識別符

testName

測試案例的名稱

status

測試案例的目前狀態

startTime

測試建立或上次執行的時間

testDescription

測試案例的描述

get_scenario_details

說明

此get_scenario_details工具會擷取單一測試案例的測試組態和最新的測試執行。

Endpoint

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

請求參數

test_id

  • 測試案例的唯一識別符

    類型：字串

    必要：是

回應

名稱 描述

testTaskConfigs

每個區域的任務組態

testScenario

測試定義和參數

status

目前的測試狀態

startTime

測試開始時間戳記

endTime

測試結束時間戳記 （如果已完成）

list_test_runs

說明

此list_test_runs工具會擷取特定測試案例的測試執行清單，將最新到最舊排序。傳回最多 30 個結果。

Endpoint

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

或

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

請求參數

test_id

  • 測試案例的唯一識別符

    類型：字串

    必要：是

limit

  • 要傳回的測試執行數目上限

    類型：整數

    預設：20

    上限：30

    必要：否

start_date

  • 篩選從特定日期執行的 ISO 8601 時間戳記

    類型：字串 （日期時間格式）

    必要：否

end_date

  • 篩選執行至特定日期的 ISO 8601 時間戳記

    類型：字串 （日期時間格式）

    必要：否

回應

名稱 描述

testRuns

具有每次執行效能指標和百分位數的測試執行摘要陣列

get_test_run

說明

此get_test_run工具會擷取具有區域和端點明細的單一測試執行的詳細結果。

Endpoint

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

請求參數

test_id

  • 測試案例的唯一識別符

    類型：字串

    必要：是

test_run_id

  • 特定測試執行的唯一識別符

    類型：字串

    必要：是

回應

名稱 描述

results

完整的測試執行資料，包括區域結果明細、端點特定指標、效能百分位數 (p50、p90、p95、p99)、成功和失敗計數、回應時間和延遲，以及用於執行的測試組態

get_latest_test_run

說明

此get_latest_test_run工具會擷取特定測試案例的最新測試執行。

Endpoint

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

注意

結果會使用全域次要索引 (GSI) 依時間排序，確保傳回最新的測試執行。

請求參數

test_id

  • 測試案例的唯一識別符

    類型：字串

    必要：是

回應

名稱 描述

results

與 具有相同格式的最新測試執行資料 get_test_run

get_baseline_test_run

說明

此get_baseline_test_run工具會擷取特定測試案例的基準測試執行。基準用於效能比較目的。

Endpoint

GET /scenarios/<test_id>/baseline

請求參數

test_id

  • 測試案例的唯一識別符

    類型：字串

    必要：是

回應

名稱 描述

baselineData

用於比較的基準測試執行資料，包括來自指定基準執行的所有指標和組態

get_test_run_artifacts

說明

此get_test_run_artifacts工具會擷取 Amazon S3 儲存貯體資訊，以存取測試成品，包括日誌、錯誤檔案和結果。

Endpoint

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

請求參數

test_id

  • 測試案例的唯一識別符

    類型：字串

    必要：是

test_run_id

  • 特定測試執行的唯一識別符

    類型：字串

    必要：是

回應

名稱 描述

bucketName

存放成品的 S3 儲存貯體名稱

testRunPath

目前成品儲存的路徑字首 (4.0+ 版）

testScenarioPath

舊版成品儲存的路徑字首 (4.0 版前）
注意

所有 MCP 工具都會利用現有的 API 端點。不需要修改基礎 APIs 即可支援 MCP 功能。