Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Especificación de herramientas MCP
La solución de pruebas de carga distribuidas presenta un conjunto de herramientas de MCP que permiten a los agentes de IA interactuar con los escenarios y los resultados de las pruebas. Estas herramientas proporcionan capacidades abstractas de alto nivel que se adaptan a la forma en que los agentes de IA procesan la información, lo que les permite centrarse en el análisis y la información en lugar de centrarse en los contratos de API detallados.
nota
Todas las herramientas de MCP proporcionan acceso de solo lectura a los datos de la solución. La interfaz MCP no admite modificaciones en los escenarios o configuraciones de prueba.
list_scenarios
Description (Descripción)
La list_scenarios herramienta recupera una lista de todos los escenarios de prueba disponibles con metadatos básicos.
Punto de conexión
GET /scenarios
Parameters
Ninguno
Respuesta
| Name | Description (Descripción) |
|---|---|
|
|
Identificador único para el escenario de prueba |
|
|
Nombre del escenario de prueba |
|
|
Estado actual del escenario de prueba |
|
|
Cuándo se creó la prueba o se ejecutó por última vez |
|
|
Descripción del escenario de prueba |
get_scenario_details
Description (Descripción)
La get_scenario_details herramienta recupera la configuración de la prueba y la ejecución más reciente de la prueba para un único escenario de prueba.
Punto de conexión
GET /scenarios/<test_id>?history=false&results=false
Parámetro de solicitud
-
test_id -
-
El identificador único del escenario de prueba
Tipo: cadena
Obligatorio: sí
-
Respuesta
| Name | Description (Descripción) |
|---|---|
|
|
Configuración de tareas para cada región |
|
|
Pruebe la definición y los parámetros |
|
|
Estado actual de la prueba |
|
|
Fecha y hora de inicio de la prueba |
|
|
Marca de tiempo de finalización de la prueba (si se ha completado) |
list_test_runs
Description (Descripción)
La list_test_runs herramienta recupera una lista de las pruebas ejecutadas para un escenario de prueba específico, ordenadas de las más recientes a las más antiguas. Devuelve un máximo de 30 resultados.
Punto de conexión
GET /scenarios/<testid>/testruns/?limit=<limit>
o
GET /scenarios/<testid>/testruns/?limit=30&start_date=<start_date>&end_date=<end_date>
Parámetros de solicitud
-
test_id -
-
El identificador único del escenario de prueba
Tipo: cadena
Obligatorio: sí
-
-
limit -
-
Número máximo de ejecuciones de prueba que se devolverán
Tipo: entero
Predeterminado: 20
Máximo: 30
Obligatorio: no
-
-
start_date -
-
La marca de tiempo ISO 8601 para filtrar las ejecuciones a partir de una fecha específica
Tipo: cadena (formato de fecha y hora)
Obligatorio: no
-
-
end_date -
-
La marca de tiempo ISO 8601 para filtrar se ejecuta hasta una fecha específica
Tipo: cadena (formato de fecha y hora)
Obligatorio: no
-
Respuesta
| Name | Description (Descripción) |
|---|---|
|
|
Matriz de resúmenes de las pruebas con métricas de rendimiento y percentiles para cada ejecución |
get_test_run
Description (Descripción)
La get_test_run herramienta recupera los resultados detallados de una sola prueba con desgloses regionales y de puntos finales.
Punto de conexión
GET /scenarios/<testid>/testruns/<testrunid>
Parámetros de solicitud
-
test_id -
-
El identificador único del escenario de prueba
Tipo: cadena
Obligatorio: sí
-
-
test_run_id -
-
El identificador único de la ejecución de la prueba específica
Tipo: cadena
Obligatorio: sí
-
Respuesta
| Name | Description (Descripción) |
|---|---|
|
|
Datos completos de la ejecución de la prueba, que incluyen el desglose de los resultados regionales, las métricas específicas del punto final, los percentiles de rendimiento (p50, p90, p95, p99), los recuentos de éxitos y fracasos, los tiempos de respuesta y la latencia, y la configuración de la prueba utilizada para la ejecución |
get_latest_test_run
Description (Descripción)
La get_latest_test_run herramienta recupera la ejecución de prueba más reciente para un escenario de prueba específico.
Punto de conexión
GET /scenarios/<testid>/testruns/?limit=1
nota
Los resultados se ordenan por tiempo mediante un índice secundario global (GSI), lo que garantiza que se devuelva la prueba más reciente.
Parámetro de solicitud
-
test_id -
-
El identificador único del escenario de prueba
Tipo: cadena
Obligatorio: sí
-
Respuesta
| Name | Description (Descripción) |
|---|---|
|
|
Los datos más recientes de la ejecución de la prueba tienen el mismo formato que |
get_baseline_test_run
Description (Descripción)
La get_baseline_test_run herramienta recupera la ejecución de la prueba de referencia para un escenario de prueba específico. La línea base se utiliza para comparar el rendimiento.
Punto de conexión
GET /scenarios/<test_id>/baseline
Parámetro de solicitud
-
test_id -
-
El identificador único del escenario de prueba
Tipo: cadena
Obligatorio: sí
-
Respuesta
| Name | Description (Descripción) |
|---|---|
|
|
Datos de la ejecución de la prueba de referencia con fines de comparación, incluidas todas las métricas y la configuración de la ejecución de referencia designada |
get_test_run_artifacts
Description (Descripción)
La get_test_run_artifacts herramienta recupera la información del bucket de Amazon S3 para acceder a los artefactos de las pruebas, incluidos los registros, los archivos de errores y los resultados.
Punto de conexión
GET /scenarios/<testid>/testruns/<testrunid>
Parámetros de solicitud
-
test_id -
-
El identificador único del escenario de prueba
Tipo: cadena
Obligatorio: sí
-
-
test_run_id -
-
El identificador único de la ejecución de la prueba específica
Tipo: cadena
Obligatorio: sí
-
Respuesta
| Name | Description (Descripción) |
|---|---|
|
|
Nombre del depósito de S3 donde se almacenan los artefactos |
|
|
Prefijo de ruta para el almacenamiento de artefactos actual (versión 4.0+) |
|
|
Prefijo de ruta para el almacenamiento de artefactos antiguos (anterior a la versión 4.0) |
nota
Todas las herramientas de MCP aprovechan los puntos finales de las API existentes. No es necesario modificar el componente subyacente APIs para admitir la funcionalidad del MCP.
