Investigando execuções

Use o MCP para localizar uma execução, entender seu resultado e analisar os registros que precisam de atenção.

Você pode começar com um pedido como:

Na empresa Acme, ambiente Produção, encontre as execuções com erro da automação de pedidos nas últimas 24 horas. Resuma a mais recente e mostre os registros que falharam.

Substitua os nomes pelos recursos da sua empresa. Informe também o fuso horário quando ele for relevante para o período consultado.

1. Localize a execução

Peça ao assistente para buscar as execuções usando find_execution_tunnelhub. Informe o período, a automação quando conhecida e o status desejado. A consulta inclui o tenantId da empresa e o environmentId do ambiente.

A busca retorna os identificadores usados nas próximas consultas:

Campo	Significado
automationId	Identificador da automação.
executionId	Identificador da execução.
executionPeriod	Período da execução, no formato YYYY-MM.

Use o período retornado pela busca, inclusive ao investigar execuções antigas.

2. Consulte o resumo

Use summarize_execution_tunnelhub para obter uma visão do resultado e dos principais indícios de falha. Para consultar os dados detalhados, use get_execution_tunnelhub.

Exemplo de parâmetros, substituindo os valores entre < > pelos IDs e pelo período retornados:

{
  "tenantId": "<id-da-empresa>",
  "environmentId": "<id-do-ambiente>",
  "automationId": "<id-da-automacao>",
  "executionId": "<id-da-execucao>",
  "executionPeriod": "<periodo-da-execucao>"
}

3. Aprofunde a análise

Escolha a consulta conforme o problema:

O que você quer entender	Ferramenta	Exemplo de pedido
A sequência de eventos e falhas técnicas	get_execution_traces_tunnelhub	“Mostre os eventos com erro e o que aconteceu imediatamente antes.”
O resultado de cada registro processado	get_execution_logs_tunnelhub	“Liste os registros que falharam e a mensagem de erro de cada um.”

Use filtros por nível, status, mensagem ou período quando disponíveis. Para compartilhar uma análise extensa, as ferramentas export_execution_traces_tunnelhub e get_trace_export_tunnelhub permitem solicitar e consultar uma exportação de traces.

4. Organize o resultado

Peça ao assistente para apresentar:

• a automação e a execução analisadas;
• o período e o ambiente;
• os erros encontrados e os registros afetados;
• as evidências que sustentam a análise;
• os pontos que ainda precisam de confirmação.

Logs e traces podem conter informações da sua operação. Revise os dados antes de compartilhar o resultado em chamados ou com outras pessoas.