04 ClickHouse Agents

Ponto de partida

Você está em build-workshop-v1 — não é necessário fazer checkout. Reserve cerca de 10 minutos. Este módulo acontece inteiramente no console do ClickHouse Cloud; não há nada para executar localmente.

Pré-requisitos: módulos 01 e 03 concluídos (histórico carregado e fluxo de CDC ao vivo em seu serviço na nuvem).

Por quê

Agora você tem um conjunto de dados completo. O ClickHouse Agents permite fazer perguntas sobre ele em linguagem natural e receber SQL e respostas fundamentadas — BI conversacional sem precisar escrever todas as consultas. Essa é a maneira mais rápida de explorar os dados que você acabou de reunir.

Objetivo

Um ClickHouse Agent criado sobre suas tabelas de táxi, capaz de responder a pelo menos uma pergunta analítica não trivial e mostrar o SQL que gerou.

Etapa 1 — Abra o ClickHouse Agents

Há dois pontos de entrada, ambos usando sua identidade existente no ClickHouse Cloud:

• Console - seu serviço -> ClickHouse agents -> Launch
• Ou acesse diretamente ai.clickhouse.cloud.

Encontre ClickHouse Agents na barra lateral esquerda do console do Cloud (ou acesse diretamente ai.clickhouse.cloud).

Etapa 2 — Crie um agente sobre seus dados de táxi

Clique em Create New Agent, informe Name e Instructions (por exemplo: responder a perguntas sobre os dados de táxi de Nova York em nyc_tlc_data) e escolha um Model.

Adicione uma ferramenta chamada ClickHouse e confirme que ela aparece como Connected — é isso que permite ao agente examinar seu esquema e executar SQL no serviço. Sem uma ferramenta ClickHouse conectada, o agente não tem o que consultar.

Depois, comece a conversar. O agente examina seu esquema para fundamentar o SQL.

Etapa 3 — Explore de forma conversacional

Faça perguntas progressivamente mais difíceis e leia o SQL gerado. Por exemplo:

Which pickup zones had the highest average fare from July 18–24, 2022, and how did that
change versus July 11–17, 2022?

Depois, faça sua própria pergunta sobre o negócio de corridas por aplicativo — esta etapa é aberta.

O agente deve retornar uma resposta escrita, com o SQL gerado exibido ao lado, e os números devem corresponder ao que o painel Historical mostra no mesmo período.

Etapa 4 — Faça uma verificação independente pelo ClickHouse MCP

Use a conexão do módulo 00 para verificar um número de forma independente:

Use the clickhouse-cloud MCP to run the generated SELECT as read-only SQL. Compare its
result with the ClickHouse Agent answer and report any difference.

Os valores devem ser iguais. Caso não sejam, compare os filtros e os intervalos de tempo antes de aceitar a resposta em linguagem natural.

Como verificar se você terminou

• Seu agente responde a uma pergunta sobre os dados de táxi e mostra o SQL gerado.
• A verificação independente pelo ClickHouse MCP retorna o mesmo resultado.

Resumo

Agora você tem acesso conversacional aos mesmos dados servidos pelo aplicativo, com base no histórico e no fluxo ao vivo que construiu. Em seguida, a atenção passa dos dados para a integridade do próprio aplicativo.

Estado final

Você pode explorar seus dados em linguagem natural. Continue em 05 ClickStack para começar a observar o próprio aplicativo.