• TRACE
  • SPAN
  • LOGIC
  • HUMAN

Como depurar falhas de agentes com sua IA

Conecte o AgentOps ao seu cliente de IA para inspecionar a lógica interna dos seus agentes. Você verá o momento exato em que um loop quebra ou ocorre um erro de raciocínio.

Pergunte à IA sobre esta página

Resposta rápida

Como minha IA encontra onde um agente falhou?

Sua IA utiliza a telemetria do AgentOps para extrair traces e spans específicos que mapeiam o caminho de decisão do agente. Isso permite identificar o passo exato onde ocorreu uma alucinação ou erro de loop, dando uma visão clara do ponto de falha.

Onde os erros são encontrados.

Resultados da depuração.

A IA usa dados de telemetria para identificar a causa raiz de erros de agentes.

TRACE

Caminhos de execução completos

A IA extrai toda a sequência de eventos para mostrar o caminho completo que o agente percorreu antes de falhar.

SPAN

Análise granular de etapas

A IA isola sub-tarefas específicas para mostrar qual função ou chamada individual causou o erro.

LOGIC

Detecção de alucinação

A IA compara o raciocínio do agente com os dados do trace para encontrar onde ele se desviou do plano.

HUMAN

Ajustes manuais necessários

A IA identifica lacunas na lógica que exigem que você reescreva o prompt ou ajuste as instruções do agente.

O fluxo

O que sua IA faz quando o erro acontece.

A IA atua como sua investigadora, extraindo telemetria para explicar por que um loop de agente saiu do controle.

  1. Recuperar o trace

    A IA extrai o histórico completo de execução de uma execução específica para entender o contexto da falha.

    get_trace

  2. Inspecionar spans específicos

    A IA analisa segmentos individuais da execução para encontrar o momento exato da falha.

    get_span

  3. Mapear o caminho do erro

    A IA usa os dados do trace para reconstruir a sequência de eventos que levou a uma alucinação.

    get_trace

  4. Isolar a falha

    A IA identifica o span específico que falhou para que você possa focar na correção.

    get_span

Teste

Copie estes comandos para começar.

Cole estes comandos no seu chat para iniciar a depuração.

Pontos de partida

Substitua os IDs de trace ou span pelos IDs reais do seu painel AgentOps.

AgentOps Connector

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

Link do conectorhttps://edge.vinkius.com/vk_preview_OCln8CM8I7G7rNCo6QKijZPwPeMGY7W7gj6qBqEG/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 — AgentOps capabilities are ready to use.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "agentops-agent-telemetry-and-monitoring-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_OCln8CM8I7G7rNCo6QKijZPwPeMGY7W7gj6qBqEG/mcp"
    }
  }
}
Copie no chat04

  • Obtenha o trace para run_id_8821 e me diga por que o agente falhou.

  • Analise os spans deste trace para encontrar onde ocorreu a alucinação.

  • Verifique o span para 'tool_call' no trace_abc_123 para ver por que retornou um erro.

  • Analise o trace de execução da última falha de loop e explique o erro de lógica.

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

Comece aqui

Conecte o AgentOps uma vez e pronto.

Vincule sua conta do AgentOps ao Vinkius. Suas credenciais ficam criptografadas do nosso lado e você pode começar imediatamente a perguntar à sua IA sobre a telemetria do seu agente.

Conectar AgentOps à sua IA

FAQ

Como funciona esta tarefa.

  • 01

    A IA pode consertar o código do meu agente?

    Não. A IA só consegue ler os traces e spans para explicar o que deu errado. Você precisará corrigir o código ou os prompts por conta própria.

  • 02

    A IA pode deletar traces do AgentOps?

    Não. As ferramentas permitem apenas que a IA leia os dados. Ela não pode deletar ou modificar nenhuma telemetria na sua conta do AgentOps.

  • 03

    Preciso fornecer um ID de trace?

    Sim. Para analisar uma falha específica, você deve informar à IA qual ID de trace ou span deve ser recuperado.

  • 04

    A IA consegue ver todos os dados do meu agente?

    Não. A IA só vê os traces e spans específicos que você solicitar explicitamente.

  • 05

    Isso funciona com qualquer agente?

    Funciona com qualquer agente que esteja configurado para enviar telemetria para o AgentOps.

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

Conecte AgentOps ao Claude, Cursor, ChatGPT e outros