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
<a name="mcp-tools-specification"></a>

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. No se admiten modificaciones en los escenarios o configuraciones de prueba a través de la interfaz MCP.

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

### Description (Descripción)
<a name="list-scenarios-tool-description"></a>

La `list_scenarios` herramienta recupera una lista de todos los escenarios de prueba disponibles con metadatos básicos.

### Punto de conexión
<a name="list-scenarios-tool-endpoint"></a>

 `GET /scenarios` 

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

Ninguno

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


| Name | Description (Descripción) | 
| --- | --- | 
|   `testId`   |  Identificador único para el escenario de prueba  | 
|   `testName`   |  Nombre del escenario de prueba  | 
|   `status`   |  Estado actual del escenario de prueba  | 
|   `startTime`   |  Cuándo se creó la prueba o se ejecutó por última vez  | 
|   `testDescription`   |  Descripción del escenario de prueba  | 

## get\$1scenario\$1details
<a name="get-scenario-details-tool"></a>

### Description (Descripción)
<a name="get-scenario-details-tool-description"></a>

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
<a name="get-scenario-details-tool-endpoint"></a>

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

### Parámetro de solicitud
<a name="get-scenario-details-tool-request"></a>

 `test_id`   
+ El identificador único del escenario de prueba

  Tipo: cadena

  Obligatorio: sí

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


| Name | Description (Descripción) | 
| --- | --- | 
|   `testTaskConfigs`   |  Configuración de tareas para cada región  | 
|   `testScenario`   |  Pruebe la definición y los parámetros  | 
|   `status`   |  Estado actual de la prueba  | 
|   `startTime`   |  Fecha y hora de inicio de la prueba  | 
|   `endTime`   |  Marca de tiempo de finalización de la prueba (si se ha completado)  | 

## list\$1test\$1runs
<a name="list-test-runs-tool"></a>

### Description (Descripción)
<a name="list-test-runs-tool-description"></a>

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
<a name="list-test-runs-tool-endpoint"></a>

 `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
<a name="list-test-runs-tool-request"></a>

 `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
<a name="list-test-runs-tool-response"></a>


| Name | Description (Descripción) | 
| --- | --- | 
|   `testRuns`   |  Matriz de resúmenes de las pruebas con métricas de rendimiento y percentiles para cada ejecución  | 

## get\$1test\$1run
<a name="get-test-run-tool"></a>

### Description (Descripción)
<a name="get-test-run-tool-description"></a>

La `get_test_run` herramienta recupera los resultados detallados de una sola prueba con desgloses regionales y de puntos finales.

### Punto de conexión
<a name="get-test-run-tool-endpoint"></a>

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

### Parámetros de solicitud
<a name="get-test-run-tool-request"></a>

 `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
<a name="get-test-run-tool-response"></a>


| Name | Description (Descripción) | 
| --- | --- | 
|   `results`   |  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\$1latest\$1test\$1run
<a name="get-latest-test-run-tool"></a>

### Description (Descripción)
<a name="get-latest-test-run-tool-description"></a>

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
<a name="get-latest-test-run-tool-endpoint"></a>

 `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
<a name="get-latest-test-run-tool-request"></a>

 `test_id`   
+ El identificador único del escenario de prueba

  Tipo: cadena

  Obligatorio: sí

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


| Name | Description (Descripción) | 
| --- | --- | 
|   `results`   |  Los datos más recientes de la ejecución de la prueba tienen el mismo formato que `get_test_run`   | 

## get\$1baseline\$1test\$1run
<a name="get-baseline-test-run-tool"></a>

### Description (Descripción)
<a name="get-baseline-test-run-tool-description"></a>

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
<a name="get-baseline-test-run-tool-endpoint"></a>

 `GET /scenarios/<test_id>/baseline` 

### Parámetro de solicitud
<a name="get-baseline-test-run-tool-request"></a>

 `test_id`   
+ El identificador único del escenario de prueba

  Tipo: cadena

  Obligatorio: sí

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


| Name | Description (Descripción) | 
| --- | --- | 
|   `baselineData`   |  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\$1test\$1run\$1artifacts
<a name="get-test-run-artifacts-tool"></a>

### Description (Descripción)
<a name="get-test-run-artifacts-tool-description"></a>

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
<a name="get-test-run-artifacts-tool-endpoint"></a>

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

### Parámetros de solicitud
<a name="get-test-run-artifacts-tool-request"></a>

 `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
<a name="get-test-run-artifacts-tool-response"></a>


| Name | Description (Descripción) | 
| --- | --- | 
|   `bucketName`   |  Nombre del depósito de S3 donde se almacenan los artefactos  | 
|   `testRunPath`   |  Prefijo de ruta para el almacenamiento de artefactos actual (versión 4.0\$1)  | 
|   `testScenarioPath`   |  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.