As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Especificação de ferramentas MCP
<a name="mcp-tools-specification"></a>

A solução Distributed Load Testing expõe um conjunto de ferramentas MCP que permitem que agentes de IA interajam com cenários e resultados de testes. Essas ferramentas fornecem recursos abstratos de alto nível que se alinham à forma como os agentes de IA processam as informações, permitindo que eles se concentrem em análises e insights em vez de contratos detalhados de API.

**nota**  
Todas as ferramentas MCP fornecem acesso somente de leitura aos dados da solução. Nenhuma modificação nos cenários ou configurações de teste é suportada pela interface MCP.

## cenários\$1de\$1lista
<a name="list-scenarios-tool"></a>

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

A `list_scenarios` ferramenta recupera uma lista de todos os cenários de teste disponíveis com metadados básicos.

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

 `GET /scenarios` 

### Parâmetros
<a name="list-scenarios-tool-parameters"></a>

Nenhum

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


| Name (Nome) | Description | 
| --- | --- | 
|   `testId`   |  Identificador exclusivo para o cenário de teste  | 
|   `testName`   |  Nome do cenário de teste  | 
|   `status`   |  Status atual do cenário de teste  | 
|   `startTime`   |  Quando o teste foi criado ou executado pela última vez  | 
|   `testDescription`   |  Descrição do cenário de teste  | 

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

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

A `get_scenario_details` ferramenta recupera a configuração do teste e a execução mais recente do teste para um único cenário de teste.

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

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

### Parâmetro de solicitação
<a name="get-scenario-details-tool-request"></a>

 `test_id`   
+ O identificador exclusivo para o cenário de teste

  Tipo: String

  Obrigatório: Sim

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


| Name (Nome) | Description | 
| --- | --- | 
|   `testTaskConfigs`   |  Configuração de tarefas para cada região  | 
|   `testScenario`   |  Definição e parâmetros do teste  | 
|   `status`   |  Status atual do teste  | 
|   `startTime`   |  Carimbo de data e hora de início do teste  | 
|   `endTime`   |  Carimbo de data e hora de término do teste (se concluído)  | 

## execuções de teste de lista
<a name="list-test-runs-tool"></a>

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

A `list_test_runs` ferramenta recupera uma lista de execuções de teste para um cenário de teste específico, classificadas da mais recente para a mais antiga. Retorna no máximo 30 resultados.

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

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

or

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

### Parâmetros de solicitação
<a name="list-test-runs-tool-request"></a>

 `test_id`   
+ O identificador exclusivo para o cenário de teste

  Tipo: String

  Obrigatório: Sim

 `limit`   
+ Número máximo de execuções de teste a serem retornadas

  Tipo: inteiro

  Padrão: 20

  Máximo: 30

  Obrigatório: não

 `start_date`   
+ Registro de data e hora ISO 8601 para filtrar execuções a partir de uma data específica

  Tipo: Cadeia de caracteres (formato de data e hora)

  Obrigatório: não

 `end_date`   
+ Carimbo de data/hora ISO 8601 para filtrar execuções até uma data específica

  Tipo: Cadeia de caracteres (formato de data e hora)

  Obrigatório: não

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


| Name (Nome) | Description | 
| --- | --- | 
|   `testRuns`   |  Conjunto de resumos de testes com métricas de desempenho e percentis para cada execução  | 

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

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

A `get_test_run` ferramenta recupera resultados detalhados de um único teste executado com detalhamentos regionais e de endpoints.

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

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

### Parâmetros de solicitação
<a name="get-test-run-tool-request"></a>

 `test_id`   
+ O identificador exclusivo para o cenário de teste

  Tipo: String

  Obrigatório: Sim

 `test_run_id`   
+ O identificador exclusivo para a execução de teste específica

  Tipo: String

  Obrigatório: Sim

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


| Name (Nome) | Description | 
| --- | --- | 
|   `results`   |  Dados completos da execução do teste, incluindo análise dos resultados regionais, métricas específicas do endpoint, percentis de desempenho (p50, p90, p95, p99), contagens de sucesso e falha, tempos de resposta e latência e configuração de teste usada para a execução  | 

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

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

A `get_latest_test_run` ferramenta recupera o teste mais recente para um cenário de teste específico.

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

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

**nota**  
Os resultados são classificados por tempo usando um Índice Secundário Global (GSI), garantindo que o teste mais recente seja retornado.

### Parâmetro de solicitação
<a name="get-latest-test-run-tool-request"></a>

 `test_id`   
+ O identificador exclusivo para o cenário de teste

  Tipo: String

  Obrigatório: Sim

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


| Name (Nome) | Description | 
| --- | --- | 
|   `results`   |  Dados de execução de teste mais recentes com o mesmo formato de `get_test_run`   | 

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

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

A `get_baseline_test_run` ferramenta recupera a execução do teste de linha de base para um cenário de teste específico. A linha de base é usada para fins de comparação de desempenho.

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

 `GET /scenarios/<test_id>/baseline` 

### Parâmetro de solicitação
<a name="get-baseline-test-run-tool-request"></a>

 `test_id`   
+ O identificador exclusivo para o cenário de teste

  Tipo: String

  Obrigatório: Sim

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


| Name (Nome) | Description | 
| --- | --- | 
|   `baselineData`   |  Dados de execução de teste de linha de base para fins de comparação, incluindo todas as métricas e configurações da execução de linha de base designada  | 

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

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

A `get_test_run_artifacts` ferramenta recupera informações do bucket do Amazon S3 para acessar artefatos de teste, incluindo registros, arquivos de erro e resultados.

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

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

### Parâmetros de solicitação
<a name="get-test-run-artifacts-tool-request"></a>

 `test_id`   
+ O identificador exclusivo para o cenário de teste

  Tipo: String

  Obrigatório: Sim

 `test_run_id`   
+ O identificador exclusivo para a execução de teste específica

  Tipo: String

  Obrigatório: Sim

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


| Name (Nome) | Description | 
| --- | --- | 
|   `bucketName`   |  Nome do bucket do S3 em que os artefatos são armazenados  | 
|   `testRunPath`   |  Prefixo de caminho para o armazenamento atual de artefatos (versão 4.0\$1)  | 
|   `testScenarioPath`   |  Prefixo de caminho para armazenamento de artefatos legados (pré-versão 4.0)  | 

**nota**  
Todas as ferramentas MCP aproveitam os endpoints de API existentes. Nenhuma modificação no subjacente APIs é necessária para oferecer suporte à funcionalidade MCP.