Pipeline Logs
Saiba como inspecionar os logs de execução de pipelines e agentes na Digibee, filtrando por pipeline, agente ou conteúdo do log para solucionar problemas e monitorar seus pipelines em tempo real.
Os logs do pipeline são registros detalhados que permitem inspecionar o que está acontecendo em cada etapa do ciclo de execução de um pipeline. Na aba Pipeline Logs, na área Monitor, você pode acompanhar os logs de eventos registrados durante a execução do pipeline, tanto no nível do pipeline quanto no nível do agente.
Ambiente
Selecione o ambiente desejado no canto superior esquerdo da página. Ao selecionar um ambiente, a página é atualizada para exibir os dados correspondentes.
Modos de visualização Pipelines e Agentes
Use o toggle no topo da aba Pipeline Logs para alternar entre duas visões:
Pipelines: Logs gerados durante a execução do pipeline.
Agentes: Os mesmos logs de Pipelines, filtrados para mostrar apenas os logs gerados por agentes criados com o Agent Component.
Pipelines
Campos de busca
Use os campos abaixo para filtrar os logs do pipeline. A lista de resultados exibe os logs que correspondem aos critérios selecionados.
Mensagem do log
A informação enviada por um conector que retorna logs durante a execução do pipeline. A busca considera apenas palavras completas.
Nome
O nome do pipeline definido pelo usuário. Digite o nome do pipeline e selecione-o na lista suspensa para filtrar os resultados.
Versão
O número da versão do pipeline. Deve ser usado em conjunto com o nome do pipeline, caso contrário a busca não retorna resultados.
Chave de execução do pipeline
O identificador único de uma execução de pipeline.
Filtros
Severidade
Filtre os resultados por classificação do log:
Todas as severidas: Qualquer tipo de informação de log.
Info: Informações sobre eventos comuns durante a execução do pipeline.
Error: Informações sobre erros durante a execução do pipeline.
Warn: Informações sobre possíveis problemas durante a execução do pipeline.
Fonte
Filtre os resultados pela origem do log:
Todas as fontes: Qualquer tipo de origem.
Digibee internal: Apenas logs internos da plataforma.
Log connector: Apenas logs adicionados explicitamente pelo usuário no pipeline.
Período de tempo
Filtre os resultados pelo horário de execução. Selecione os últimos 5, 15, 60 minutos, 1 dia, ou defina um intervalo de tempo personalizado.
Tabela de logs
A tabela de logs exibe os resultados de acordo com os filtros selecionados. Clique em um log para abrir seus detalhes em um painel lateral.
Agentes
A visualização de Agentes parte da mesma base de logs que a visualização de Pipelines, mas exibe apenas os logs gerados por agentes criados com o Agent Component.
Campos de busca
Use os campos abaixo para filtrar os logs dos agentes. A lista de resultados exibe os logs que correspondem aos critérios selecionados.
Pipeline
O nome do pipeline que contém o agente.
Nome do agente
O nome do agente conforme definido no Agent Component.
Conteúdo
O conteúdo da mensagem do log do agente.
Você também pode filtrar por período de tempo (últimos 5, 15, 60 minutos, ou um intervalo personalizado), da mesma forma que em Pipelines.
Tabela de logs
A tabela de logs exibe uma linha para cada execução de agent, com as seguintes colunas:
Timestamp: Data e hora em que a execução do agente ocorreu.
Nome do agente: O nome do Agent Component.
Chave de execução do agente: O identificador único de uma execução de agente. Uma chave de pipeline pode ter múltiplas chaves de execução de agente, vindas de agentes diferentes ou de um único agente executado em loop.
Nome do pipeline: O nome e a versão do pipeline que contém o agente.
Chave do pipeline: Identificador único de uma execução de pipeline. Incluída em cada linha de execução de agente para que você consiga rastreá-la até o pipeline que a executou.
Prévia do conteúdo: Uma prévia da mensagem retornada pelo agente.
Clique em um log para abrir o painel Detalhes do log de agente.
Detalhes do log de agente
O painel Detalhes do log de agente exibe o ID da execução, o horário e a duração da execução do agente selecionado, seguidos por dois grupos expansíveis.
Logs de execução
Expanda cada seção para inspecionar uma etapa específica da execução do agente:
Configuração: Configurações de provider e modelo.
Entrada: Contexto, configuração de tools e status de retrieval.
Mensagem do sistema: O prompt de sistema enviado ao modelo. É possível visualizá-lo como Texto, Markdown ou JSON.
Mensagem do usuário: O prompt de usuário enviado ao modelo, como o claim context pack ou outros dados contextuais. É possível visualizá-lo como Texto, Markdown ou JSON.
Ferramentas: As chamadas de ferramentas, seus argumentos e resultados.
Guardrail de entrada/saída: Os guardrails aplicados e seu impacto.
Use esses logs para validar o comportamento e solucionar problemas.
Saída
A seção Saída exibe o resultado final retornado pela execução do agente, formatado como JSON. Clique no ícone de cópia para copiar o output completo. Você também pode usar o campo Busque por JSONPath para procurar informações específicas na saída.
Salve esta execução como um Caso de Teste
Na parte inferior do painel, clique em Criar caso de teste para transformar esta execução em um Caso de Teste, em vez de construir um cenário de teste do zero. Isso permite validar seu agente com base em entradas que realmente ocorreram em produção, em vez de entradas simuladas.
Selecione o Dataset no qual deseja salvar esta execução e, em seguida, mapeie as variáveis pré-preenchidas.
Use a aba Avaliações para adicionar ou editar os valores das avaliações já configuradas no Dataset. Não é possível criar novas avaliações a partir dessa aba; para adicionar uma nova avaliação, configure-a diretamente no Dataset dentro do Agent Component.
Clique em Salvar para concluir o Caso de Teste.
O novo Caso de Teste é adicionado ao Dataset selecionado e fica disponível na próxima vez que você executar suas Avaliações no Agent Component dentro do pipeline. Para mais detalhes sobre Datasets, Casos de Teste e Avaliações, leia Construindo testes no Agent: Datasets, Casos de Teste e Avaliações.
Atualizado
Isto foi útil?