Como Testar e Depurar Conversas de IA no Agent Studio

A Linha do Tempo de Execução de Mensagens e o Chat Emulator do Agent Studio oferecem visibilidade total em cada etapa de uma conversa de IA, permitindo que você depure mais rápido, identifique gargalos e implemente agentes com confiança.

TABLE OF CONTENTS

O que são a Linha do Tempo de Execução de Mensagens e o Chat Emulator?

A Linha do Tempo de Execução de Mensagens e o Chat Emulator são ferramentas integradas no Agent Studio que ajudam você a testar e depurar conversas de IA com visibilidade total. A Linha do Tempo registra cada evento, chamada de ferramenta e decisão que seu agente toma, juntamente com as métricas do modelo, enquanto o Chat Emulator permite simular conversas, reiniciar sessões e pular diretamente para o node responsável por qualquer resposta. Juntos, eles fornecem uma visão clara do comportamento do agente para que você possa identificar problemas, validar a lógica e melhorar o desempenho com confiança.

Essas ferramentas removem o efeito de “caixa preta” frequentemente associado aos Workflows de IA, mostrando exatamente o que acontece em cada etapa da execução, permitindo rastrear a lógica, inspecionar entradas e saídas e fazer melhorias direcionadas com base em dados reais.

Principais Benefícios de Testar e Depurar Conversas de IA

Testar e depurar suas conversas de IA no Agent Studio oferece visibilidade completa sobre como seu agente pensa, responde e se comporta. Ao combinar logs de execução em tempo real com um ambiente de teste semelhante ao de produção, você pode validar a lógica, identificar gargalos e refinar o desempenho antes de entrar no ar.

Linha do Tempo de Execução de Mensagens

A Linha do Tempo aparece ao lado do Chat Emulator e é atualizada em tempo real enquanto seu agente executa.

Screenshot: “Linha do Tempo mostrando selos de latência em nível de etapa”

Botão de Transição de Node

Na Linha do Tempo de Execução, cada etapa exibe um rótulo roxo. Esses rótulos de Transição clicáveis indicam o node exato para o qual a conversa se moveu durante a execução. Clicar no rótulo foca e destaca automaticamente esse node no canvas, permitindo que você revise ou modifique sua lógica imediatamente sem precisar pesquisar manualmente em seu fluxo.

Isso torna a depuração mais rápida, conectando diretamente os logs de execução ao construtor visual.

Painel de Métricas de Desempenho

Abaixo de cada mensagem, o rodapé de métricas exibe:

Esta informação ajuda a avaliar tanto o desempenho quanto a eficiência durante os testes.

Chat Emulator

Um Chat Emulator é uma interface de chat simulada usada para testar conversas de IA com segurança. Ele fornece um ambiente de teste simplificado que espelha cenários de implementação do mundo real.

Como Testar e Depurar Conversas de IA no Agent Studio

Esta seção explica como usar a Linha do Tempo e o Chat Emulator juntos para inspecionar as etapas de execução, identificar problemas e otimizar o desempenho antes de publicar seu agente.

Abra o Ambiente de Teste

Navegue até AI Agents → Agent Studio e abra o agente que deseja testar. Clique na aba Testar no canto superior direito para acessar o Chat Emulator e a visualização de execução.

Inicie uma Sessão de Teste

Clique em Iniciar para abrir o Chat Emulator. A Linha do Tempo de Execução de Mensagens aparecerá automaticamente ao lado da janela de chat.

Envie uma mensagem de teste no emulator ou acione o agente via API. Enquanto o agente processa a solicitação, cada transição de node, chamada de ferramenta e etapa de execução do modelo é registrada em tempo real no painel da Linha do Tempo.

Revise os Logs de Execução

Examine os cartões de evento na Linha do Tempo para entender como o agente lidou com a conversa. Procure por nomes de nodes, atividade de ferramentas, uso de tokens, tempo de execução e quaisquer selos de latência que indiquem etapas mais lentas.

Inspecione as Métricas de Desempenho

Clique em entradas de log individuais para revisar métricas detalhadas, como versão do modelo, tokens de entrada/saída, temperatura e estimativas de custo (se ativado). Use esta informação para avaliar a eficiência e ajustar prompts ou configurações de ferramentas.

Pule para o Node de Origem

Clique no cartão de log para destacar automaticamente o node correspondente no construtor. Isso permite que você ajuste rapidamente a lógica, prompts ou variáveis sem precisar pesquisar manualmente no canvas.

Resete e Reteste

Use o botão Reset no Chat Emulator para limpar a conversa e os logs de execução. Execute a conversa novamente para verificar se suas atualizações resolveram o problema.

Publique com Confiança

Assim que os testes confirmarem que a conversa se comporta como esperado e o desempenho está otimizado, mova seu agente para Staging ou Production como de costume.

Perguntas Frequentes

P: A Linha do Tempo está disponível para agentes de IA de Voz?

Sim. Ao abrir a aba Testar para um agente de IA de Voz, a mesma visualização de log aparece após a conclusão de uma chamada de teste.

P: A Linha do Tempo aumenta o uso de tokens ou o custo?

Não. A Linha do Tempo registra metadados já retornados pelo modelo e pelos nodes de ferramenta.

P: Posso exportar os logs da Linha do Tempo?

Clique no ícone de download no canto superior direito da Linha do Tempo para salvar um arquivo JSON da execução completa.

P: Por que não vejo o botão Ir para Node?

O botão aparece somente depois que o agente foi salvo pelo menos uma vez. Certifique-se de não estar visualizando um Draft não salvo.

P: Resetar o Chat Emulator limpará a Linha do Tempo?

Sim. O Reset limpa tanto o contexto do chat quanto seus logs de execução associados para uma nova sessão.

P: Este recurso é restrito por algum plano?

A Linha do Tempo e o Chat Emulator estão incluídos no Unlimited AI Employee, o mesmo plano exigido para o Agent Studio.

Artigos Relacionados

Fonte original: https://help.gohighlevel.com/support/solutions/articles/155000007425-how-to-test-and-debug-ai-conversations-in-agent-studio