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 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_de_lista
Description
A list_scenarios ferramenta recupera uma lista de todos os cenários de teste disponíveis com metadados básicos.
Endpoint
GET /scenarios
Parameters
Nenhum
Resposta
| Name (Nome) | Description |
|---|---|
|
|
Identificador exclusivo para o cenário de teste |
|
|
Nome do cenário de teste |
|
|
Status atual do cenário de teste |
|
|
Quando o teste foi criado ou executado pela última vez |
|
|
Descrição do cenário de teste |
get_scenario_details
Description
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
GET /scenarios/<test_id>?history=false&results=false
Parâmetro de solicitação
-
test_id -
-
O identificador exclusivo para o cenário de teste
Tipo: string
Obrigatório: Sim
-
Resposta
| Name (Nome) | Description |
|---|---|
|
|
Configuração de tarefas para cada região |
|
|
Definição e parâmetros do teste |
|
|
Status atual do teste |
|
|
Carimbo de data e hora de início do teste |
|
|
Carimbo de data e hora de término do teste (se concluído) |
execuções de teste de lista
Description
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
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
-
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
| Name (Nome) | Description |
|---|---|
|
|
Conjunto de resumos de testes com métricas de desempenho e percentis para cada execução |
get_test_run
Description
A get_test_run ferramenta recupera resultados detalhados de um único teste executado com detalhamentos regionais e de endpoints.
Endpoint
GET /scenarios/<testid>/testruns/<testrunid>
Parâmetros de solicitação
-
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
| Name (Nome) | Description |
|---|---|
|
|
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_latest_test_run
Description
A get_latest_test_run ferramenta recupera a execução de teste mais recente para um cenário de teste específico.
Endpoint
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
-
test_id -
-
O identificador exclusivo para o cenário de teste
Tipo: string
Obrigatório: Sim
-
Resposta
| Name (Nome) | Description |
|---|---|
|
|
Dados de execução de teste mais recentes com o mesmo formato de |
get_baseline_test_run
Description
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
GET /scenarios/<test_id>/baseline
Parâmetro de solicitação
-
test_id -
-
O identificador exclusivo para o cenário de teste
Tipo: string
Obrigatório: Sim
-
Resposta
| Name (Nome) | Description |
|---|---|
|
|
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_test_run_artefacts
Description
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
GET /scenarios/<testid>/testruns/<testrunid>
Parâmetros de solicitação
-
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
| Name (Nome) | Description |
|---|---|
|
|
Nome do bucket do S3 em que os artefatos são armazenados |
|
|
Prefixo do caminho para o armazenamento atual de artefatos (versão 4.0+) |
|
|
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.
