04 ClickHouse Agents

Điểm khởi đầu

Bạn đang ở build-workshop-v1 — không cần checkout. Hãy dự trù khoảng 10 phút. Module này diễn ra hoàn toàn trong console ClickHouse Cloud; không có gì phải chạy ở local.

Yêu cầu tiên quyết: module 01 và 03 đã hoàn thành (dữ liệu lịch sử đã nạp mồi cùng một luồng CDC trực tiếp trong service Cloud của bạn).

Vì sao

Giờ bạn đã có một tập dữ liệu phong phú. ClickHouse Agents cho phép bạn đặt câu hỏi về nó bằng ngôn ngữ thường ngày và nhận lại SQL cùng câu trả lời có căn cứ — BI hội thoại mà không cần tự viết từng truy vấn. Đây là cách nhanh nhất để khám phá dữ liệu bạn vừa lắp ghép.

Mục tiêu

Một ClickHouse Agent được tạo trên các bảng taxi của bạn, trả lời được ít nhất một câu hỏi phân tích không tầm thường, và cho thấy SQL mà nó đã sinh ra.

Bước 1 — Mở ClickHouse Agents

Hai điểm vào, cả hai đều dùng danh tính ClickHouse Cloud hiện có của bạn:

• Console - service của bạn -> ClickHouse agents -> Launch
• Hoặc vào thẳng ai.clickhouse.cloud.

Tìm ClickHouse Agents trong sidebar bên trái của console Cloud (hoặc vào thẳng ai.clickhouse.cloud).

Bước 2 — Tạo một agent trên dữ liệu taxi của bạn

Nhấn Create New Agent, đặt cho nó một Name, phần Instructions (ví dụ: trả lời các câu hỏi về dữ liệu taxi NYC trong nyc_tlc_data), và chọn một Model.

Hãy thêm một tool tên ClickHouse và xác nhận nó hiển thị là Connected — đây là thứ cho phép agent nội soi schema của bạn và chạy SQL trên service của bạn. Không có tool ClickHouse đã kết nối thì agent chẳng có gì để truy vấn.

Sau đó hãy bắt đầu chat. Agent nội soi schema của bạn nên SQL của nó có căn cứ.

Bước 3 — Khám phá theo kiểu hội thoại

Hãy đặt các câu hỏi khó dần và đọc SQL mà nó sinh ra. Ví dụ:

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

Sau đó hãy đặt câu hỏi của riêng bạn về hoạt động kinh doanh gọi xe — đây là bước mở của bạn.

Bạn sẽ thấy agent trả về một câu trả lời viết ra kèm SQL đã sinh hiển thị bên cạnh nó, và các con số của nó phải khớp với những gì dashboard Historical hiển thị cho cùng giai đoạn đó.

Bước 4 — Đối chiếu chéo qua ClickHouse MCP

Hãy dùng kết nối từ Module 00 để kiểm chứng độc lập một con số:

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.

Các giá trị phải khớp nhau. Nếu không khớp, hãy so sánh các filter và khoảng thời gian trước khi chấp nhận câu trả lời bằng ngôn ngữ tự nhiên.

Cách kiểm chứng bạn đã hoàn thành

• Agent của bạn trả lời một câu hỏi trên dữ liệu taxi và hiển thị SQL đã sinh.
• Phép đối chiếu chéo qua ClickHouse MCP trả về cùng kết quả.

Tổng kết

Bạn đã có quyền truy cập theo kiểu hội thoại vào chính dữ liệu mà ứng dụng của bạn phục vụ, dựa trên dữ liệu lịch sử và luồng dữ liệu trực tiếp bạn đã xây. Tiếp theo, bạn sẽ chuyển sự chú ý từ dữ liệu sang sức khỏe của chính ứng dụng.

Trạng thái kết thúc

Bạn có thể khám phá dữ liệu của mình bằng ngôn ngữ tự nhiên. Tiếp tục tới 05 ClickStack để bắt đầu quan sát chính ứng dụng.