04 ClickHouse Agents

Buat sebuah ClickHouse Agent di atas data taksi Anda dan telusuri secara konversasional di ai.clickhouse.cloud.

Titik awal

Anda berada di build-workshop-v1 — tidak perlu checkout. Siapkan sekitar 10 menit. Modul ini seluruhnya berada di konsol ClickHouse Cloud; tidak ada yang perlu dijalankan secara lokal.

Prasyarat: modul 01 dan 03 selesai (riwayat yang sudah terisi ditambah aliran CDC langsung di layanan Cloud Anda).

Sekarang Anda punya dataset yang kaya. ClickHouse Agents memungkinkan Anda mengajukan pertanyaan padanya dalam bahasa biasa dan mendapatkan SQL serta jawaban yang berlandas — BI konversasional tanpa menuliskan setiap kueri sendiri. Ini adalah cara tercepat menelusuri data yang baru saja Anda susun.

Tujuan

Sebuah ClickHouse Agent yang dibuat di atas tabel taksi Anda dan menjawab setidaknya satu pertanyaan analitik yang tidak sepele, sekaligus menampilkan SQL yang dihasilkannya.

Langkah 1 — Buka ClickHouse Agents

Dua titik masuk, keduanya memakai identitas ClickHouse Cloud Anda yang sudah ada:

Console - layanan Anda -> ClickHouse agents -> Launch
Atau langsung ke ai.clickhouse.cloud.

Temukan ClickHouse Agents di sidebar kiri konsol Cloud (atau langsung ke ai.clickhouse.cloud).

Langkah 2 — Buat sebuah agent di atas data taksi Anda

Klik Create New Agent, beri Name, Instructions (misalnya: jawab pertanyaan tentang data taksi NYC di nyc_tlc_data), dan pilih sebuah Model.

Tambahkan tool bernama ClickHouse dan pastikan ia tampil sebagai Connected — inilah yang memungkinkan agent memeriksa skema Anda dan menjalankan SQL terhadap layanan Anda. Tanpa tool ClickHouse yang terhubung, agent tidak punya apa pun untuk di-query.

Lalu mulai mengobrol. Agent memeriksa skema Anda sehingga SQL-nya berlandas.

Langkah 3 — Telusuri secara konversasional

Ajukan pertanyaan yang makin sulit dan baca SQL yang dihasilkannya. Misalnya:

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

Lalu ajukan pertanyaan Anda sendiri tentang bisnis ride-hailing itu — ini langkah bebas Anda.

Anda seharusnya melihat agent mengembalikan jawaban tertulis dengan SQL yang dihasilkan ditampilkan di sebelahnya, dan angkanya seharusnya sejalan dengan apa yang ditampilkan dashboard Historical untuk periode yang sama.

Langkah 4 — Periksa silang melalui ClickHouse MCP

Gunakan koneksi dari Modul 00 untuk memverifikasi satu angka secara independen:

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.

Nilainya seharusnya sama. Jika tidak, bandingkan filter dan rentang waktunya sebelum menerima jawaban bahasa alaminya.

Cara memverifikasi Anda sudah selesai

Agent Anda menjawab sebuah pertanyaan atas data taksi dan menampilkan SQL yang dihasilkan.
Pemeriksaan silang ClickHouse MCP mengembalikan hasil yang sama.

Penutup

Anda punya akses konversasional ke data yang sama dengan yang dilayani aplikasi Anda, ditopang riwayat dan aliran langsung yang Anda bangun. Berikutnya Anda mengalihkan perhatian dari data ke kesehatan aplikasi itu sendiri.

Kondisi akhir

Anda dapat menelusuri data Anda dalam bahasa alami. Lanjutkan ke 05 ClickStack untuk mulai mengamati aplikasinya sendiri.