Câu hỏi thường gặp (FAQ)

Bài viết này tổng hợp các câu hỏi thường gặp nhất về TLGeo Agent. Nếu bạn không tìm thấy câu trả lời, hãy xem Bài 14: Khắc phục sự cố hoặc liên hệ hỗ trợ.

Tổng quan & Giới thiệu

TLGeo Agent là gì?

TLGeo Agent là trợ lý AI giúp bạn tương tác với QGIS bằng ngôn ngữ tự nhiên (tiếng Việt hoặc tiếng Anh). Thay vì phải nhớ menu, plugin, expression phức tạp, bạn chỉ cần đặt câu hỏi — Agent sẽ tự động thực thi trong QGIS.

Xem chi tiết tại Bài 1: Giới thiệu.

TLGeo Agent khác gì với TLGeo2QGIS?

TLGeo Agent có phải là phiên bản nâng cấp của TLGeo2QGIS không?

Không hoàn toàn. Hai sản phẩm có cách tiếp cận khác nhau:

• TLGeo2QGIS: Plugin truyền thống, hoạt động ngay trong QGIS, dễ dùng cho người quen UI
• TLGeo Agent: AI assistant, mạnh hơn cho tác vụ phức tạp và tự động hóa

TODO: Có kế hoạch hợp nhất 2 sản phẩm không?

Cài đặt & Sử dụng

Cần những gì để bắt đầu?

1. QGIS 3.x đã cài trên máy (Desktop)
2. Python 3.10+ để chạy Agent Server
3. API key của LLM provider (MiniMax, OpenAI, Anthropic, hoặc local)
4. Kết nối Internet ổn định

QGIS có phải mở khi dùng Agent không?

Có. Agent điều khiển QGIS thông qua QGIS Plugin, nên QGIS phải đang chạy.

Có thể dùng Agent mà không mở QGIS không?

Có, dùng CLI mode (python agent.py) để test nhanh. Nhưng để Agent thực sự điều khiển QGIS, cần mở QGIS.

Có cần cài QGIS Plugin riêng không?

Có. TODO: Link tải QGIS Plugin chính thức.

Xem hướng dẫn tại Bài 1: Giới thiệu → Bước 4.

Dùng được trên Windows, Mac, Linux không?

• QGIS: Có (3 hệ điều hành)
• Agent Server: Có (Python chạy được trên cả 3)
• QGIS Plugin: TODO - xác nhận hỗ trợ từng OS

Giá cả & Gói dịch vụ

TLGeo Agent có miễn phí không?

TODO: Chưa có thông tin giá chính thức. Cập nhật sau khi có pricing.

Có bản dùng thử miễn phí không?

TODO: TODO.

Chi phí LLM API có tính vào giá sản phẩm không?

TODO: TODO. Có thể có 2 mô hình:

• Tự trả phí API (BYOK - Bring Your Own Key)
• Bao gồm trong gói (giá cao hơn)

Có cần tài khoản TLGeo không?

TODO: Xác nhận. Có thể cần tài khoản TLGeo Cloud cho tính năng sync.

Bảo mật & Riêng tư

Dữ liệu của tôi có được gửi lên cloud không?

Có, nhưng qua LLM provider thôi. Agent gửi câu hỏi + context (như tên layer, expression) tới LLM provider (vd: OpenAI) để xử lý. Dữ liệu bản đồ của bạn không được upload lên đâu cả — Agent chỉ gửi “câu hỏi” chứ không gửi toàn bộ dataset.

LLM API key có an toàn không?

• File .env chứa API key không được commit lên Git
• Có thể rotate API key bất kỳ lúc nào
• TODO: Hỗ trợ secret manager (Vault, AWS Secrets) cho production?

Có log lịch sử hội thoại không?

Có, lưu trong file conversations.db (SQLite). Bạn có thể xóa file này để xóa lịch sử.

Có thể dùng local LLM (không gửi data ra ngoài) không?

Có! Dùng Ollama hoặc các local LLM khác. Xem Bài 12: Cấu hình môi trường → Local Ollama configuration.

Có GDPR/privacy compliance không?

TODO: TODO. Tùy thuộc vào LLM provider bạn dùng.

Tính năng & Khả năng

Agent có thể làm gì?

Xem Bài 11: Danh sách tools để biết 19 tools hiện có.

Tóm tắt:

• ✅ Điều khiển bản đồ (zoom, pan)
• ✅ Select, highlight theo thuộc tính
• ✅ Style, label, layout
• ✅ Phân tích SQL, geoprocessing
• ✅ Chạy Python script tùy chỉnh
• ✅ Thống kê, tổng hợp dữ liệu

Agent KHÔNG thể làm gì?

TODO: Liệt kê giới hạn hiện tại (cần bổ sung tools cho view data, create/edit/export nâng cao).

Hỗ trợ tiếng Việt không?

Có. Agent được train để hiểu tiếng Việt tốt. Bạn có thể gõ câu hỏi tiếng Việt tự nhiên.

Hỗ trợ tiếng Anh không?

Có. Bạn có thể dùng tiếng Anh nếu muốn.

Có thể dùng cả tiếng Việt và tiếng Anh trong cùng 1 session không?

Có, Agent hiểu cả hai. Bạn có thể trộn ngôn ngữ tùy ý.

Agent có thể tạo plugin QGIS mới không?

Không trực tiếp. Nhưng Agent có thể giúp bạn viết code Python script, từ đó bạn có thể đóng gói thành plugin.

Tích hợp & Liên kết

Tích hợp với TLGeo Cloud như thế nào?

TODO: TODO. Bao gồm:

• Sync dữ liệu
• Chia sẻ dự án
• Phân quyền theo license tier

Có API cho developer không?

TODO: TODO. Có thể expose các tools qua REST API không?

Có dùng chung với Geocollect mobile không?

Có, thông qua TLGeo Cloud:

• Desktop: Chuẩn bị basemap, MBTiles
• Mobile (Geocollect): Sync từ Cloud, thu thập dữ liệu thực địa

Hiệu năng & Giới hạn

Câu hỏi phức tạp mất bao lâu?

• Câu đơn giản: 2-5 giây
• Câu trung bình: 5-15 giây
• Câu phức tạp (cần chạy Python script): 10-30 giây

Có giới hạn số câu hỏi không?

Phụ thuộc vào LLM provider:

• OpenAI: Rate limit theo tier (vd: 60 req/min cho tier 1)
• Local Ollama: Không giới hạn, nhưng chậm hơn

Xử lý dataset lớn (triệu features) được không?

Được, nhưng:

• Câu hỏi có thể mất 30 giây - vài phút
• Nên dùng PostGIS thay shapefile
• TODO: Có cần pagination/streaming response không?

Agent có thể chạy trên cloud không?

Có! Agent Server có thể deploy lên:

• VPS (DigitalOcean, AWS EC2, …)
• Docker container
• Kubernetes cluster

Xem Bài 8: Publish cho hướng dẫn production.

Xử lý sự cố

Agent không phản hồi?

Xem Bài 14: Khắc phục sự cố:

1. Kiểm tra server có chạy không
2. Kiểm tra QGIS Plugin có kết nối không
3. Kiểm tra API key còn hạn không
4. Xem log trong terminal

Kết quả sai?

Xem Bài 13: Viết câu hỏi hiệu quả:

• Câu hỏi cần cụ thể, rõ ràng
• Chỉ định rõ layer, cột
• Kiểm tra lại kết quả

Hỗ trợ & Cộng đồng

Liên hệ hỗ trợ ở đâu?

TODO: TODO. Cập nhật:

• Hotline/Zalo
• Email support
• Issue tracker
• Cộng đồng

Có tài liệu kỹ thuật cho developer không?

Có:

• Source code: /Users/taluan/Workshop/TLGeo/GEOADMIN_WORKSPACE/SRC/TLGEO_PROJECTS/tlgeo2qgis_agent/
• PyQGIS documentation: https://qgis.org/pyqgis/3.44/
• LangChain documentation: https://python.langchain.com/

Có thể đóng góp (contribute) không?

TODO: TODO. Có GitHub repo public không?

So sánh với các sản phẩm khác

TLGeo Agent vs ChatGPT/Claude thông thường?

TLGeo Agent vs ArcGIS Pro với AI?

Lộ trình phát triển

Sắp tới có gì mới?

TODO: TODO. Roadmap chính thức.

Có lộ trình tích hợp với các sản phẩm TLGeo khác không?

TODO: TODO.

TODO cần bạn xác nhận

• Bảng giá chính thức
• Lộ trình phát triển (roadmap)
• Thông tin liên hệ hỗ trợ
• Câu hỏi thường gặp thực tế từ khách hàng
• So sánh chi tiết với các sản phẩm cạnh tranh
• GDPR/privacy compliance

Liên kết

• Bài 1: Giới thiệu
• Bài 14: Khắc phục sự cố
• Bài 13: Viết câu hỏi hiệu quả