AI Agent untuk QGIS: Panduan Lengkap
AI Agent adalah panel chat di dalam 
. Anda menulis tugasnya, dan tugas itu berjalan di proyek yang sudah Anda buka, lengkap dengan layer, CRS, seleksi, dan extent di layarnya. Kami yang membangunnya, jadi panduan ini membahas tool kami sendiri.
Panduan ini mencakup run pertama Anda, apa yang bisa dijangkau agent, dua chip yang menentukan cara kerjanya, dan cara membatalkan run yang tidak Anda inginkan.
Yang dilakukan satu prompt
Empat kalimat, diketik satu demi satu di panel yang sama, dalam satu proyek. Tidak ada yang di bawah ini disiapkan secara manual.
Instal dan masuk
Di QGIS, buka Plugins -> Manage and Install Plugins, cari AI Agent, lalu klik Install. Plugin ini berjalan di QGIS 3.28 ke atas, termasuk QGIS 4, pada Windows, macOS, dan Linux.
Buka panel dari toolbar TerraLab dan klik Sign in / Sign up. Browser Anda terbuka, Anda membuat akun, lalu plugin terhubung sendiri. Tanpa API key, tanpa kartu kredit, dengan run gratis untuk memulai.
Run pertama Anda
Jelaskan hasilnya, bukan prosedurnya
"Beri warna bangunan berdasarkan ketinggian" adalah prompt yang lebih baik daripada "buka properties, pilih graduated renderer, pilih field ketinggian". Agent membaca proyek sebelum bertindak, jadi menyebutkan nama layer, field, dan path biasanya hanya membuang waktu ketik.
Baca langkah-langkahnya, bukan hanya jawabannya
Baris abu-abu di bawah pesan Anda menghitung pekerjaannya: 4 steps, 39.6s. Buka lipatannya dan setiap tool call ada di sana, lengkap dengan argumen dan hasilnya. Begitulah cara Anda membedakan hasil yang bagus dari hasil yang sekadar terlihat masuk akal.
Jawab ketika ditanya
Sebuah run bisa berhenti pada kartu kecil dengan dua sampai empat pilihan. Milik kami bertanya dua kali: tampilan berisi 6.355 fitur OSM, dan hanya 117 dari 3.124 bangunan yang membawa tag ketinggian. Keduanya adalah percabangan nyata dalam pekerjaan, dan keduanya terlihat di trace setelahnya.
Periksa apa yang berubah
Chip di bawah jawaban menyebutkan layer yang dibuat atau disentuh oleh run tersebut. Klik salah satunya untuk menu QGIS yang biasa: tampilkan di panel Layers, zoom ke situ, buka attribute table, layer properties.
Satu prompt adalah satu run, berapa pun langkah QGIS yang dibutuhkannya. Sebuah run berhenti sendiri pada 60 tool call atau 40 menit, sehingga tugas yang melenceng tidak bisa berjalan selamanya.
Yang bisa dijangkaunya
Data. File lokal, file jarak jauh, WFS, WMS, XYZ, citra STAC dan COG, ekstrak OpenStreetMap, geocoding, routing. Jatuhkan sebuah GeoPackage ke panel dan file itu akan dimuat sebagai layer.
Analisis. Semua algoritma Processing, dengan nama parameter dan jebakan yang sudah dikenal dicari lebih dulu, bukan ditebak. Buffer, join, statistik zonal, pemeriksaan topologi, isochrone dari jalan OSM, profil elevasi di sepanjang garis.
Kartografi. Simbologi, renderer categorized dan graduated, label, layout cetak dengan peta, legenda, skala bar, dan panah utara, lalu ekspor ke PDF atau PNG.
Editing. Menambah, memperbarui, dan menghapus fitur, perbaikan geometri, edit vertex, merge dan split, di dalam sesi edit QGIS sungguhan yang bisa Anda batalkan.
Jawaban. Tempat sebuah pengaturan QGIS berada dan cara melakukannya secara manual, diambil dari dokumentasi resmi QGIS, lengkap dengan tautannya. Tanyakan cara memperbaiki geometri yang tidak valid dan Anda mendapat jawaban, bukan sebuah run.
Jika AI Edit atau AI Segmentation terinstal, agent juga mengendalikan keduanya: mengubah citra dari sebuah prompt, atau memvektorkan setiap instance sebuah objek di dalam zona.
Ia memeriksa pekerjaannya sendiri
Pada effort Medium ke atas, agent merender peta dan melihat apa yang dihasilkannya. Dalam run layout, agent melakukan persis itu, memutuskan hasilnya tidak terbaca, lalu memperbaiki urutan gambar sebelum menyelesaikan.
Itulah perilaku yang layak diperhatikan, dalam dua arah. Agent melaporkan bahwa hanya 186 dari 3.124 bangunan yang punya ketinggian yang bisa dipakai, alih-alih diam-diam memberi gaya pada field yang penuh nilai kosong. Ia juga bisa saja salah dengan percaya diri, sehingga trace tetap menjadi hal yang perlu dibaca.
Tetap terkendali
Tiga hal berdiri di antara model dan proyek Anda.
Chip izin, di sebelah tombol + pada composer, menentukan kapan ia berhenti untuk bertanya.
| Level | Ia bertanya sebelum |
|---|---|
| Ask first | Setiap perubahan |
| Balanced (default) | Menghapus dan menimpa |
| Autopilot | Tidak ada, kecuali menggunakan kredit dan menjalankan Python |
Autopilot adalah pilihan per sesi: restart QGIS akan kembali ke Balanced, apa pun yang Anda pilih terakhir. Dua hal selalu bertanya, di setiap level: apa pun yang menggunakan kredit, dan menjalankan Python mentah, yang Anda lihat sebelum dijalankan.
Kartu persetujuan adalah rupa dari pertanyaan itu. Satu kalimat yang menyebutkan apa yang akan terjadi, jawaban Anda, lalu kartu itu terlipat jadi satu baris begitu diputuskan, sehingga run yang panjang tetap mudah dibaca.
Undo. Setiap run meninggalkan checkpoint. Panah di header panel membuka daftarnya, terbaru lebih dulu, dengan baris tempat proyek Anda berada saat ini bercentang.
Pilih satu baris dan proyek akan kembali ke titik itu. Restore menangkap dulu keadaan yang ditinggalkannya, sehingga restore itu sendiri bisa dibatalkan, dan Ctrl+Alt+Z melangkah mundur tanpa membuka apa pun. Checkpoint dipatok pada run, bukan pada tool call satuan.
Memberinya konteks yang tepat
Agent sudah membaca proyek: nama layer, tipe, CRS, jumlah fitur, nama field, extent, kanvas, seleksi Anda. Yang Anda tambahkan adalah yang tidak bisa dilihatnya.
- Lampirkan foto atau file data, atau sebuah layer dari proyek ini.
- Seret layer langsung dari panel Layers QGIS ke panel ini.
- Jatuhkan file di mana pun pada panel: data dimuat sebagai layer, gambar dikirim ke model.
- Ketik
@untuk menyebutkan sumber data atau salah satu plugin QGIS terinstal Anda di dalam pesan.
Setiap proyek menyimpan chat-nya sendiri. Kaca pembesar di header mencari berdasarkan judul dan teks pesan, dan sebuah chat bisa diekspor sebagai Markdown.
Dua pengaturan yang layak diubah
Effort, chip sebelum Send, bukan pemilih model. Ia menyebutkan seberapa banyak pemikiran yang Anda beli.
| Level | Yang dilakukannya | Paket |
|---|---|---|
| Instant | Mulai bekerja secepat mungkin. Tidak merencanakan atau meneliti | Free |
| Medium | Merencanakan, memeriksa hasilnya, mencari algoritma dan dokumentasi | Pro |
| High | Perencanaan lebih dalam, riset, dan arah independen pada tugas yang lebih sulit | Pro |
Instant cocok untuk "CRS proyek ini apa" dan untuk satu perubahan styling. Medium menghasilkan setiap run di panduan ini, termasuk pertanyaan dan pemeriksaan mandirinya. High untuk tugas yang kalau tidak begitu akan Anda sisihkan waktu satu sore penuh.
Connectors, halaman pertama Settings, menentukan dari mana data berasal. Tiga puluh sembilan sumber, sepuluh aktif secara default: OpenStreetMap, Overture, Natural Earth, NASA, Copernicus, Planetary Computer, badan pemetaan nasional, dan lainnya. Masing-masing menyebutkan apa yang dibutuhkannya sebelum Anda mengaktifkannya, dan kebanyakan tidak butuh apa-apa sama sekali.
Plugin QGIS terinstal Anda mendapat baris di halaman yang sama, sehingga agent bisa menjangkaunya dengan nama.
Personalisation adalah halaman lain yang layak dikunjungi. Apa yang harus dipanggilkan AI kepada Anda, apa pekerjaan Anda, satu paragraf tentang pekerjaan Anda, instruksi tetap, pengalaman GIS Anda, metrik atau imperial, cara layer baru harus dinamai, dan catatan yang disimpannya antar-chat.
Yang keluar dari komputer Anda
Setiap pesan pergi ke layanan hosted kami. Yang dikirim: permintaan Anda, deskripsi proyek (CRS, extent, dan per layer nama, tipe, tipe geometri, visibilitas, jumlah fitur, nama field dan extent, plus satu baris contoh dari layer aktif), path file proyek, run Processing terbaru Anda, peringatan QGIS terbaru, dan apa pun yang Anda lampirkan.
Yang tidak: isi file raster dan vector Anda, file proyek itu sendiri, geometri fitur, seluruh attribute table, dan proyek mana pun yang belum Anda tanyakan. Activation key Anda tidak pernah muncul dalam hasil tool, dan password database di dalam layer URI dibersihkan dari setiap hasil dan traceback.
Free vs Pro
Free memberi Anda 10 run per bulan, dengan model cepat, lengkap dengan semua tool, semua connector, dan semua plugin QGIS, untuk pemakaian pribadi. Pro adalah 250 run per bulan seharga 49 EUR: model Pro untuk tugas sulit, effort Medium dan High, memori dan instruksi tetap, run yang lebih panjang, pemakaian komersial.
Tidak ada yang diukur per tool call. Run 60 langkah dan run 3 langkah berbiaya sama.
Pertanyaan
Bisakah ia merusak proyek saya?
Ia mengubahnya, itulah intinya, dan perubahan itu bisa dibatalkan. Balanced bertanya sebelum apa pun yang destruktif, dan run checkpoint mengembalikan proyek bahkan setelah Anda menyetujui sesuatu yang seharusnya tidak Anda setujui. Simpan proyek Anda sebelum sesi panjang, sama seperti sebelum batch edit apa pun.
Apa yang terjadi ketika ia salah?
Ia adalah model bahasa, jadi ia bisa salah, dan dengan percaya diri. Untuk itulah activity block ada: buka lipatannya, lihat argumen yang dipilihnya dan angka yang dihasilkannya. Run kami sendiri menyatakan bahwa hanya 186 dari 3.124 bangunan yang punya ketinggian yang bisa dipakai, jenis baris yang layak dibaca sebelum Anda mempercayai petanya.
Berapa lama sebuah run berjalan?
Beberapa detik untuk pertanyaan, beberapa menit untuk pekerjaan sungguhan. Dalam panduan ini: 43 detik untuk basemap, 6 menit 30 detik untuk bangunan dan gradasi ketinggiannya, 2 menit 37 detik untuk layout, kurang dari satu menit untuk setiap pertanyaan. QGIS tetap bisa dipakai selagi sebuah fetch berjalan.
Apakah ia bekerja secara offline?
Tidak. Tidak ada model lokal dan tidak ada mode offline. Plugin berjalan di komputer Anda, model berjalan di komputer kami.
Apakah data saya dipakai untuk melatih model?
Tidak. Layanan ini merencanakan langkah QGIS, dan tidak ada yang lain.
Apakah ini open source?
Plugin-nya, ya, di bawah GPL-2.0-or-later: tool executor, model izin, guard file dan network, panel. Jadi apa yang berjalan di komputer Anda sepenuhnya bisa diaudit. Layanan hosted, prompt-nya, dan katalog data terbuka tidak.
Yang perlu diingat
Jelaskan hasilnya, bukan prosedurnya. Agent membaca proyek lebih dulu, jadi menyebutkan nama layer dan path biasanya hanya membuang waktu ketik.
Satu prompt adalah satu run, berapa pun biayanya dalam langkah, dan ia berhenti sendiri pada 60 tool call atau 40 menit.
Activity block adalah produknya. Membuka lipatannya adalah cara Anda membedakan hasil yang bagus dari hasil yang sekadar terlihat masuk akal.
Setiap run meninggalkan checkpoint, dan sebuah restore bisa dibatalkan sendiri, sehingga menyetujui sesuatu yang Anda sesali bukanlah jalan buntu.
Effort membeli perencanaan dan pemeriksaan, bukan kepribadian yang berbeda. Instant menjawab, Medium bekerja dan memverifikasi, High berpikir lebih dulu.
Connectors menentukan data apa yang bisa ditemukannya. Mengaktifkan badan pemetaan nasional Anda lebih berharga daripada susunan kata prompt apa pun.
