• TRACE
  • LATENCY
  • ERROR
  • HUMAN

Como depurar a execução de ferramentas com sua IA

Conecte o Metorial ao seu agente para acessar logs de execução em tempo real. Você verá exatamente os dados que fluem em cada chamada de ferramenta.

Pergunte à IA sobre esta página

Resposta rápida

Como posso depurar as chamadas de ferramentas do meu agente?

Seu agente usa o Metorial para extrair rastros detalhados que mostram onde as chamadas de ferramentas falham ou travam. Você terá uma visão clara das entradas e saídas de cada etapa.

Resultados da depuração.

Onde seus dados chegam.

A IA organiza as informações de rastreamento em categorias específicas para você.

TRACE

Identificar falhas de lógica

A IA extrai logs de rastreamento para mostrar onde o raciocínio do agente divergiu do caminho pretendido.

LATENCY

Encontrar chamadas lentas

A IA analisa o tempo de execução para destacar quais ferramentas específicas estão causando atrasos.

ERROR

Localizar falhas

A IA isola a chamada de ferramenta exata que retornou um erro e explica o motivo.

HUMAN

Revisão manual necessária

A IA sinaliza rastros que exigem sua intervenção para corrigir manualmente a lógica ou os parâmetros do agente.

O fluxo

O que sua IA faz ao receber um pedido de depuração.

A IA atua como uma ponte entre os logs do seu agente e sua janela de chat.

  1. Escanear atividade recente

    A IA analisa os logs de execução recentes para encontrar as interações de ferramentas relevantes.

    metorial_list_traces

  2. Isolar rastros específicos

    A IA seleciona o rastro exato que corresponde ao seu erro ou relatório de latência.

    metorial_get_trace_details

  3. Inspecionar dados da ferramenta

    A IA lê as entradas e saídas específicas usadas durante a chamada lenta ou com erro.

    metorial_get_trace_details

  4. Resumir o problema

    A IA fornece uma explicação clara de por que a chamada da ferramenta falhou com base nos dados do rastro.

    metorial_get_trace_details

Teste

Copie estes comandos para começar.

Use estes prompts para iniciar sua sessão de depuração.

Pontos de partida

Substitua os nomes das ferramentas ou as descrições de erro pelos seus detalhes específicos.

Metorial Connector

Tudo pronto. Escolha seu cliente MCP e siga as instruções de configuração.

Link do conectorhttps://edge.vinkius.com/vk_preview_u9gVDS60iTHUlTLh8tFcQxn710vU1GGlSnGwhKcw/mcp

Claude Desktop

Siga os passos abaixo para conectar em segundos.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Metorial capabilities are ready to use.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "metorial-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_u9gVDS60iTHUlTLh8tFcQxn710vU1GGlSnGwhKcw/mcp"
    }
  }
}
Copie no chat04

  • Liste os rastros de execução mais recentes do meu agente.

  • Mostre-me os detalhes da última chamada que falhou na ferramenta 'stripe_payment'.

  • Encontre o rastro onde a ferramenta 'search_docs' demorou mais de 3 segundos.

  • Por que a ferramenta 'send_email' retornou um erro no último rastro?

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Comece aqui

Conecte o Metorial uma vez e comece a perguntar.

Vincule sua conta apenas uma vez. Suas credenciais ficam criptografadas e você pode começar imediatamente a perguntar ao seu agente sobre os rastros de execução.

Conectar Metorial à sua IA

FAQ

Como funciona a depuração com o Metorial

  • 01

    A IA pode consertar o código da ferramenta para mim?

    Não. A IA apenas lê os rastros para dizer o que deu errado. Você precisa corrigir o código por conta própria.

  • 02

    A IA pode excluir meus rastros de execução?

    Não. As ferramentas permitem apenas que a IA liste e recupere detalhes dos rastros. Ela não pode excluir nenhum log.

  • 03

    Como a IA sabe qual rastro deve analisar?

    A IA usa a ferramenta de listagem para encontrar rastros relevantes e depois busca os detalhes específicos do rastro que você solicitou.

  • 04

    Isso funciona com qualquer cliente MCP?

    Sim. Funciona com qualquer cliente que suporte o Model Context Protocol, como Claude, Cursor ou Windsurf.

  • 05

    Posso ver os argumentos exatos usados em uma chamada de ferramenta?

    Sim. A IA pode extrair os detalhes do rastro para mostrar as entradas exatas enviadas para uma ferramenta.

  • Mais dúvidas sobre o Metorial? A página do Connector responde. Veja tudo o que o Metorial Connector pode fazer

Conecte Metorial ao Claude, Cursor, ChatGPT e outros