04 ClickHouse Agents
Notas do instrutor para o módulo 04 — cronograma, roteiro de apresentação, falhas comuns e etapas de redefinição.
Terminal do macOS: Execute os comandos do workshop no Terminal usando zsh ou bash.
Material do facilitador correspondente à lição 04 ClickHouse Agents do participante.
Cronograma
Cerca de 10 minutos. Mantenha o ritmo; este módulo é uma exploração e o resultado é imediato.
Roteiro de apresentação
- Apresente a BI conversacional: faça uma pergunta em inglês e receba uma resposta fundamentada, acompanhada do SQL.
- Explique que a ferramenta usa o Claude e está em versão beta, portanto os resultados podem variar.
- Tenha uma boa pergunta de exemplo pronta para mostrar no projetor.
- PENDENTE: expandir.
Falhas comuns
- Ponto de entrada (barra lateral do serviço -> ClickHouse agents -> Launch, ou ai.clickhouse.cloud): a interface beta pode mudar; portanto, confirme o caminho no dia do evento.
- O agente não enxerga as tabelas de táxi porque o serviço/banco de dados não foi conectado.
- O ensaio em ambiente limpo de julho de 2026 abrangeu este módulo; os modos de falha, tempos e etapas com intervenção humana foram validados nesse ensaio.
Etapas de redefinição
- Recrie o agente e reconecte-o ao serviço e às tabelas.
- PENDENTE: confirmar os comandos de redefinição.