AI Notebooks no ClickStack

AI Notebooks para investigações com IA no ClickStack

AI Notebooks são uma ferramenta interativa de investigação no ClickStack que combina um agente de IA com análise manual. Você pode descrever um problema em linguagem natural, e o agente de IA fará consultas a logs, traces e métricas por você, exibindo dados, gráficos e resumos relevantes como uma série de tiles. Você também pode adicionar seus próprios tiles (gráficos, tabelas, pesquisas e notas em Markdown) junto com a saída gerada pela IA, criando um registro completo de uma investigação.

Somente no Managed ClickStack

AI Notebooks estão disponíveis apenas em implantações do Managed ClickStack.

​

Configuração

AI Notebooks estão atualmente em beta no ClickHouse Cloud. Os modelos e provedores de IA são gerenciados automaticamente pela plataforma.

Antes de usar AI Notebooks:

1. Generative AI habilitado — Um admin da equipe precisa habilitar a opção de consentimento para Generative AI. Consulte Habilitando o Generative AI.
2. Acesso ao Notebooks — Sua função precisa ter permissões de leitura e gravação para Notebooks.

Após a ativação, o item Notebooks aparece na barra lateral esquerda para todos que tiverem a função apropriada.

​

Como ativar o Generative AI

Um administrador da equipe deve ativar a opção de consentimento do Generative AI antes que notebooks (e outros recursos de IA) possam ser usados.

1. Acesse Team Settings > Security Policies.
2. Ative Generative AI.
3. Revise e aceite a caixa de diálogo de consentimento.

​

Como usar o AI Notebooks

​

Criando um notebook

1. Selecione Notebooks na barra lateral à esquerda.
2. Clique em New Private Notebook (visível apenas para você) ou New Shared Notebook (visível para a sua equipe).

A página de lista de notebooks mostra todos os notebooks aos quais você tem acesso. Você pode filtrar por nome, tags ou alternar entre My Notebooks e All Notebooks.

​

Executando uma investigação com IA

Na parte inferior de um notebook, insira um prompt descrevendo o que você quer investigar — por exemplo, “Por que as taxas de erro dispararam no serviço de checkout na última hora?”

Pressione Send (ou Enter). O agente de IA irá:

1. Examinar as fontes de dados disponíveis.
2. Executar consultas de busca e agregação nos seus logs, traces e métricas.
3. Gerar uma série de tiles mostrando seu processo de raciocínio, as consultas executadas, gráficos intermediários e um resumo final com conclusões.

Cada etapa aparece como um tile no notebook. Os tiles de Thought process mostram o raciocínio por trás de cada consulta, e os tiles de Output contêm as conclusões do agente e gráficos opcionais. Diferentemente de um chat de IA comum, os notebooks permitem que você veja exatamente com quais dados a IA está trabalhando em cada etapa — para que possa verificar seu raciocínio, identificar pistas interessantes que ela possa ter deixado passar e ramificar a investigação para conduzi-la em outra direção.

Enquanto a investigação estiver em execução, você pode clicar em Stop para cancelá-la.

​

Criando uma ramificação na investigação

À medida que a IA investiga, você pode notar uma etapa intermediária que traz algo interessante à tona — mas o agente seguiu por outro caminho. Criar uma ramificação permite reiniciar a partir desse ponto com um prompt diferente, sem perder o caminho original da investigação.

Para criar uma ramificação:

1. Expanda um tile de Thought process e clique em Restart from Here.
2. Na caixa de diálogo, insira um prompt modificado que direcione a investigação para esse novo caminho.
3. Clique em Interrupt & Create Branch. A IA inicia uma nova ramificação da investigação a partir desse ponto.

Quando um tile tem várias ramificações, botões de seta para a esquerda e para a direita aparecem no cabeçalho do tile, com um indicador (por exemplo, 1/2) mostrando quantas ramificações existem. Clique nas setas para alternar entre as ramificações.

​

Adicionando tiles manuais

Além dos tiles gerados por IA, você pode adicionar seus próprios tiles de análise usando os botões na parte inferior do notebook:

Button	Shortcut	Description
Search	S	Uma Search view de logs/traces, equivalente à página de pesquisa.
Chart	L	Um gráfico de linha de série temporal, usando o mesmo construtor de visualizações de Dashboards.
Table	T	Uma visualização tabular de agregações.
Markdown	M	Texto livre para notas, hipóteses ou conclusões.

Depois de adicionar um tile, ele é aberto no modo de edição embutida, em que você pode configurar a fonte de dados, os filtros e as agregações — a mesma interface usada ao criar visualizações em dashboards. Clique em Save para finalizar o tile.

Os tiles manuais são adicionados abaixo do último tile visível na ramificação atual. Você pode redimensioná-los verticalmente arrastando a borda inferior.

Se uma investigação de IA estiver em execução, adicionar ou editar um tile manual cancelará a investigação. Uma caixa de diálogo de confirmação será exibida antes de continuar.

​

Compartilhamento e organização

• Privado vs. Compartilhado — Use o ícone de cadeado no cabeçalho do notebook para alternar entre privado (somente você) e compartilhado (visível para a equipe). Somente o criador do notebook pode alterar essa configuração.
• Tags — Adicione tags aos notebooks para facilitar a filtragem na página de listagem.
• Nome — Clique no título do notebook para renomeá-lo. Se você iniciar uma investigação em um notebook sem título, a IA sugerirá um nome automaticamente.

​

Contexto personalizado do agente

Os administradores da equipe podem fornecer contexto adicional, que é incluído em todas as investigações com IA nos notebooks da equipe. Isso é útil para dar à IA mais contexto sobre a arquitetura do seu sistema, convenções de nomenclatura ou problemas conhecidos.

Para configurar isso:

1. Acesse Notebooks na barra lateral esquerda.
2. Abra Agent Settings (disponível para administradores da equipe).
3. Insira seu contexto personalizado (até 50.000 caracteres) e salve.

Esse contexto é acrescentado ao system prompt da IA em todas as investigações de notebook da equipe.