Os Logs do Agente oferecem uma maneira centralizada de analisar como seus agentes de I.A. estão se comportando nas experiências suportadas do HighLevel. Ao reunir a atividade de execução, o contexto da conversa e os detalhes no nível da etapa em um só lugar, os Logs do Agente facilitam o entendimento do que aconteceu, a identificação mais rápida de problemas e a melhoria do desempenho do agente ao longo do tempo. Este artigo explica o que são os Logs do Agente, por que eles são importantes e como usar sua experiência de diagnóstico em três níveis para investigar a atividade do agente no HighLevel.
O que são os Logs do Agente?
Os Logs do Agente são a experiência centralizada de registro e rastreamento do HighLevel para agentes de I.A. Foram projetados para fornecer um local unificado para analisar logs e rastreamentos (traces) para aplicativos agênticos suportados no ecossistema HighLevel, ajudando você a entender o que está acontecendo nos bastidores durante cada interação. Essa visibilidade adicional torna mais fácil ir além das suposições, solucionar problemas com confiança e melhorar o comportamento do agente com uma visão mais clara de como as decisões foram tomadas. No momento, os Logs do Agente estão ativos para o Agent Studio e Voice AI, com suporte para outros produtos de I.A. em breve.
Os Logs do Agente foram desenvolvidos para suportar uma experiência de diagnóstico em três níveis:
- Uma visão de alto nível da atividade do agente
- Uma linha do tempo detalhada da conversa e execução para uma interação selecionada
- Uma visualização granular de etapas com detalhes técnicos mais profundos para depuração (debugging)
Principais Benefícios dos Logs do Agente
- Visibilidade centralizada: Analise a atividade suportada do agente de I.A. em um só lugar, em vez de depender apenas de visualizações de teste isoladas.
- Solução de problemas mais rápida: Mova-se de uma visualização ampla de atividades para uma conversa específica e, em seguida, para as etapas de execução individuais para identificar onde algo deu errado.
- Melhor contexto para depuração: Compare a resposta do agente com a linha do tempo de execução para entender como a resposta final foi produzida.
- Consciência de desempenho: Use o tempo de execução no nível da etapa para identificar áreas lentas que podem precisar de atenção.
- Maior confiança: Inspecione os detalhes técnicos mais de perto ao solucionar problemas de prompts, lógica, variáveis ou comportamento da ferramenta.
Visão Geral da Atividade Global
A Visão Geral da Atividade Global oferece uma visão ampla da atividade recente do agente, para que você possa identificar rapidamente onde focar sua atenção. Essa perspectiva de nível superior é útil quando você deseja monitorar a atividade em escala, restringir um problema ou localizar uma interação específica para inspecionar mais de perto.
A Visão Geral da Atividade Global serve como a experiência de Nível 1 nos Logs do Agente. A partir daqui, os usuários podem analisar as execuções recentes e começar a restringir a investigação.
Esta visualização é útil para:
- Monitorar atividades recentes em experiências de agentes suportadas
- Restringir qual execução investigar
- Localizar uma interação específica mais rapidamente
- Analisar conversas com mais eficiência em ambientes de maior volume
Itens e ações comuns nesta visualização podem incluir: Timestamp, Nome do Agente, ID do Agente, Produto de I.A., Canal, Status, Filtros e Pesquisas.
Contexto Conversacional e Linha do Tempo
Ver a conversa e o histórico de execução juntos ajuda você a entender tanto a experiência do usuário quanto a lógica por trás dela. Essa visualização é útil quando você precisa responder a perguntas como por que o agente respondeu de uma determinada maneira, onde uma decisão mudou ou quando uma ferramenta foi envolvida.
O Contexto Conversacional e a Linha do Tempo representam a experiência de Nível 2 nos Logs do Agente. Depois de selecionar uma interação específica, você pode analisar a conversa junto com a linha do tempo de execução.
Esta visualização ajuda você a:
- Ler a interação em um formato de conversa familiar
- Comparar a resposta do agente com as etapas que levaram a ela
- Rastrear o fluxo desde a mensagem original do usuário até a resposta final
A linha do tempo de execução foi projetada para mostrar o caminho ordenado que o agente seguiu durante a interação, oferecendo uma visão mais clara de como a conversa progrediu nos bastidores.
Execução Granular de Etapas
O detalhe no nível da etapa é onde a solução de problemas se torna muito mais precisa. Quando uma conversa parece incorreta ou incompleta, inspecionar uma etapa de execução individual pode ajudar a revelar se o problema ocorreu devido à lógica, ao tempo, ao tratamento de dados ou a uma ação relacionada à ferramenta.
Dependendo da etapa, os usuários também podem analisar a saída em diferentes formatos, incluindo uma visualização no estilo JSON bruto ou uma visualização analisada mais legível.
A Execução Granular de Etapas é a experiência de Nível 3 nos Logs do Agente. Esta visão mais profunda é útil para examinar:
- O modelo usado para a etapa
- Latência e tempo de execução
- Detalhes do timestamp
- Entrada e saída para a etapa selecionada
- Detalhes do prompt, onde aplicável
- Metadados técnicos adicionais que suportam a depuração
Como Usar os Logs do Agente
Os Logs do Agente não exigem instalação separada. A parte mais importante da configuração é garantir que você tenha atividade de agente suportada para analisar e que saiba como passar da visualização de alto nível para as visualizações de execução detalhadas.
- Abra AI Agents > Agent Logs na sua conta do HighLevel.
- Analise a lista de atividades e escolha a interação que deseja inspecionar. Use filtros como Nome do Agente, Produto de I.A., Canal ou Status para refinar seus resultados.
- Abra a interação para visualizar a conversa e a linha do tempo de execução.
- Selecione uma mensagem ou etapa para ver informações de execução mais detalhadas. Use esses detalhes para melhorar seu agente.
- Teste novamente e analise a atividade atualizada nos Logs do Agente.
Aba de Métricas (Visão do Painel/Dashboard)
A guia Métricas (Metrics) resume os dados dos Logs do Agente em um painel personalizável. Use-o para monitorar o volume, o desempenho e as tendências operacionais entre os agentes, em vez de analisar uma única sessão.
Perguntas Frequentes
P: Qual é o objetivo principal dos Logs do Agente?
Os Logs do Agente ajudam você a entender como um agente de I.A. lidou com uma interação, combinando o contexto da conversa com os detalhes de execução em uma visualização centralizada.
P: Os Logs do Agente são o mesmo que a Linha do Tempo de Execução de Mensagens no Agent Studio?
Não. Os Logs do Agente são uma experiência centralizada de registro e rastreamento, enquanto a Linha do Tempo de Execução de Mensagens faz parte da experiência de teste e depuração do Agent Studio.
P: Quando devo usar os Logs do Agente?
Use os Logs do Agente quando quiser investigar como um agente respondeu, revisar o caminho de uma interação ou solucionar problemas de uma etapa específica no fluxo de execução.
P: Os Logs do Agente apoiarão outros produtos de I.A. no futuro?
Sim. Os Logs do Agente estão ativos para o Agent Studio e Voice AI no lançamento, com suporte para produtos de I.A. adicionais em breve.