GeoSQL: Biến LLM thành tác nhân phân tích không gian địa lý

GeoSQL là một kỹ năng mã nguồn mở mới, biến các trợ lý lập trình AI như Claude, Codex và GitHub Copilot thành các tác nhân phân tích không gian địa lý. Nó hoạt động với PostGIS, BigQuery, Snowflake và Wherobots — và chạy hoàn toàn cục bộ hoặc tự lưu trữ, không yêu cầu tài khoản SaaS.

Bắt đầu nhanh

Cài đặt qua pip và khởi chạy chế độ tương tác:

pip install geosql && geosql

Hoặc cài đặt trực tiếp vào một tác nhân được hỗ trợ:

geosql install claude
geosql install codex
geosql install copilot

Đối với Claude Code, sử dụng chợ plugin:

/plugin marketplace add dekart-xyz/geosql
/plugin install geosql

Sau khi cài đặt, bạn có thể sử dụng các lời nhắc như:

/geosql Hiển thị mật độ sạc EV dọc theo các con đường chính và hiển thị bản đồ

Cách hoạt động

GeoSQL chạy một vòng lặp tác nhân bao gồm một bản đồ. Quy trình có năm giai đoạn:

1. Khám phá. Kỹ năng khám phá siêu dữ liệu kho dữ liệu của bạn (bảng, cột, kiểu) thay vì đoán lược đồ. Hoạt động với các chia sẻ Overture Maps trên BigQuery và Snowflake, và các bảng riêng tư trên các cơ sở dữ liệu được hỗ trợ.
2. Tạo SQL. Tác nhân viết SQL không gian bằng các hàm chính xác cho engine của bạn (ST_INTERSECTS, ST_DISTANCE, H3, bbox overlap để phân vùng tỉa, v.v.).
3. Kiểm tra chi phí. Trên BigQuery, mọi truy vấn đều được chạy thử trước để ước tính số byte được quét. Một giới hạn thanh toán 10 GiB được áp dụng theo mặc định. Các truy vấn vượt ngân sách được viết lại rẻ hơn (bbox chặt hơn, độ phân giải H3 thấp hơn, nhiều bộ lọc hơn) thay vì thực thi.
4. Xác thực hình học. Tác nhân tính tổng diện tích (đa giác) hoặc tổng chiều dài (đường) như một kiểm tra hợp lý, và đối chiếu với kiến thức miền.
5. Phản hồi bản đồ. Khi có sẵn, tác nhân hiển thị kết quả qua Dekart, nhìn vào hình ảnh đã hiển thị và sửa các lỗi hình học mà vòng lặp chỉ văn bản sẽ bỏ sót. Đây là vòng lặp mang lại cải thiện 4 lần.

Kỹ năng sử dụng xác thực CLI cục bộ của bạn (bq, snow, dekart), vì vậy thông tin đăng nhập kho dữ liệu không bao giờ đến tay tác nhân.

Điểm chuẩn

GeoSQL đi kèm với một bộ đánh giá có thể tái tạo trong evals/. Mỗi trường hợp khẳng định các hành vi cụ thể (lan can chi phí, các bước xác thực, kết quả chính xác), không chỉ là "tác nhân đã trả lời." Kết quả hiện tại trên bộ tích hợp: 8 khẳng định trên 3 trường hợp, tỷ lệ đạt 100%. Trung bình: 3.085 token mỗi lượt, 72 giây mỗi lượt.

Biểu đồ cải thiện 4 lần so sánh cùng một tập nhiệm vụ với và không có bước bản đồ trong vòng lặp. Không có bản đồ, xác thực chỉ văn bản của tác nhân bỏ sót các lỗi lớp hình học (nhầm một đa giác khu phố với chu vi khu vực đô thị, đếm trùng các đối tượng chồng lấn, chọn sai khóa nối trên hệ thống tham chiếu tọa độ). Thêm bản đồ đã hiển thị như một lệnh gọi công cụ cho phép tác nhân thấy những lỗi đó và tự sửa.

Ví dụ lời nhắc

Phân tích bất động sản:

/geosql Hiển thị các tòa nhà có khả năng tiếp cận trường học thấp ở Ottawa, hiển thị dưới dạng bản đồ

Chọn địa điểm:

/geosql Tìm 10 địa điểm hàng đầu cho Cửa hàng đồ thể thao ở Seattle dựa trên vị trí đồng vị trí POI và khoảng cách đến đối thủ cạnh tranh gần nhất. Tạo một bản đồ.

Cơ sở hạ tầng sạc EV:

/geosql tạo bản đồ mật độ sạc EV dọc theo các con đường chính của Romania, làm nổi bật có bao nhiêu trạm sạc trong vòng 5 km của mỗi đoạn đường cao tốc, đường trục hoặc đường chính.