Introdução aos Registros
Os Registros são páginas dentro de cada projeto (workspace) que expõem registros operacionais detalhados, permitindo investigar eventos específicos e monitorar a atividade do workspace.
O que são Registros?
Registros são páginas detalhadas que complementam o Painel de analytics, fornecendo acesso granular a eventos e atividades específicas do workspace. Enquanto o Painel oferece uma visão agregada através de gráficos e métricas, os Registros permitem investigar cada evento individualmente.
Através dos Registros, você pode:
- Investigar eventos específicos: Acesse informações detalhadas sobre conversas, avaliações e execuções
- Monitorar atividade: Acompanhe o uso da plataforma em nível operacional
- Analisar qualidade: Identifique padrões, problemas e oportunidades de melhoria
- Auditar ações: Tenha rastreabilidade completa das atividades do workspace
Acessando os Registros
Para acessar os Registros:
- Navegue até a seção Projetos no menu lateral
- Selecione o projeto desejado
- No menu lateral do projeto, você encontrará as opções de registros logo abaixo de Painel:
- Conversas
- Avaliação de Respostas
- Métricas e Eventos
Conversas
A seção de Conversas lista todas as conversas realizadas pelos usuários do workspace.
O que você encontra:
- Lista completa de conversas: Todas as interações com assistentes do workspace
- Informações detalhadas: Para cada conversa, você verá:
- Assistente utilizado
- Participantes da conversa
- Data e hora de início e fim
- Duração da conversa
- Status (ativa, finalizada, etc.)
- Visualização completa: Ao abrir uma conversa, você pode:
- Ver o histórico completo de mensagens
- Visualizar o contexto e prompts utilizados
- Exportar logs para auditoria e análise
Casos de Uso:
- Auditoria: Rastreie todas as interações dos usuários
- Análise de uso: Entenda como os assistentes estão sendo utilizados
- Suporte: Acesse conversas específicas para ajudar usuários
- Melhoria contínua: Identifique padrões de uso e necessidades dos usuários
Avaliação de Respostas
A seção de Avaliação de Respostas centraliza todos os feedbacks dados pelos usuários sobre as respostas dos assistentes.
O que você encontra:
- Feedbacks positivos e negativos: Avaliações com 👍 (positivo) e 👎 (negativo)
- Contexto completo: Para cada avaliação, você verá:
- O prompt enviado pelo usuário
- A resposta gerada pelo assistente
- Comentários adicionais do usuário (quando disponíveis)
- Data e hora da avaliação
- Assistente utilizado
- Análise agregada: Visualize tendências de satisfação e padrões de feedback
Casos de Uso:
- Melhoria de qualidade: Identifique respostas que precisam ser melhoradas
- Identificação de lacunas: Descubra perguntas que os assistentes não conseguem responder bem
- Otimização de prompts: Use os feedbacks para ajustar prompts e configurações
- Treinamento: Identifique áreas onde os assistentes precisam de mais conhecimento
Métricas e Eventos
A seção de Métricas e Eventos registra cronologicamente todas as execuções e eventos operacionais do workspace.
O que você encontra:
- Registro cronológico: Eventos ordenados por data e hora
- Tipos de eventos registrados:
- Execuções de assistentes
- Uploads de arquivos
- Sincronizações de fontes de conhecimento
- Chamadas a servidores MCP
- Outros eventos do sistema
- Detalhes de cada evento:
- Usuário responsável pela ação
- Tempo de execução
- Status (sucesso, erro, etc.)
- Mensagens de erro (quando aplicável)
- Recursos utilizados
Casos de Uso:
- Monitoramento operacional: Acompanhe a saúde do workspace em tempo real
- Investigação de incidentes: Identifique a causa raiz de problemas
- Otimização de performance: Identifique operações lentas ou com problemas
- Análise de uso: Entenda quais recursos são mais utilizados
- Auditoria de segurança: Rastreie todas as ações realizadas no workspace
Integração com o Painel
Os Registros trabalham em conjunto com o Painel:
- Painel: Fornece visão agregada e tendências através de gráficos
- Registros: Fornecem detalhes específicos e permitem investigação profunda
Use o Painel para identificar tendências e padrões, e os Registros para investigar eventos específicos e entender o contexto detalhado.
Próximos Passos
- Explore as diferentes seções de registros disponíveis
- Combine informações do Painel com os Registros para análises completas
- Exporte dados quando necessário para análises externas ou auditoria