AI Agent dla QGIS: kompletny przewodnik
AI Agent to panel czatu wewnątrz 
. Piszesz zadanie, a on pracuje w projekcie, który masz już otwarty, z jego warstwami, jego CRS, jego selekcją i zasięgiem na ekranie. Budujemy go, więc ten przewodnik dotyczy naszego własnego narzędzia.
Obejmuje pierwsze uruchomienie, to, do czego agent sięga, dwa chipy decydujące o jego zachowaniu oraz jak cofnąć uruchomienie, którego nie chciałeś.
Co robi jeden prompt
Cztery zdania, wpisane jedno po drugim do tego samego panelu, w jednym projekcie. Nic poniżej nie zostało przygotowane ręcznie.
Instalacja i logowanie
W QGIS otwórz Plugins -> Manage and Install Plugins, wyszukaj AI Agent i kliknij Install. Działa na QGIS 3.28 i nowszych, w tym QGIS 4, na Windows, macOS i Linux.
Otwórz panel z paska narzędzi TerraLab i kliknij Sign in / Sign up. Otworzy się przeglądarka, zakładasz konto, a plugin łączy się sam. Bez klucza API, bez karty kredytowej, darmowe uruchomienia na start.
Pierwsze uruchomienie
Opisz wynik, nie procedurę
„Colour the buildings by height” to lepszy prompt niż „open the properties, pick a graduated renderer, choose the height field”. Agent czyta projekt przed działaniem, więc nazywanie warstw, pól i ścieżek to zwykle stracone pisanie.
Czytaj kroki, nie tylko odpowiedź
Szara linia pod Twoją wiadomością liczy pracę: 4 steps, 39.6s. Rozwiń ją, a każde wywołanie narzędzia jest tam wraz z argumentami i tym, co wróciło. Tak odróżnisz dobry wynik od prawdopodobnego.
Odpowiadaj, gdy pyta
Uruchomienie może zatrzymać się na małej karcie z dwiema do czterech opcji. Nasze zapytało dwa razy: widok zawierał 6 355 obiektów OSM, a tylko 117 z 3 124 budynków miało tag wysokości. Oba były prawdziwymi rozwidleniami w pracy i oba widać potem w śladzie.
Sprawdź, co się zmieniło
Chipy pod odpowiedzią nazywają warstwy, które uruchomienie utworzyło lub ruszyło. Kliknij jeden dla zwykłego menu QGIS: pokaż w panelu Warstwy, przybliż do niej, otwórz tabelę atrybutów, właściwości warstwy.
Jeden prompt to jedno uruchomienie, niezależnie od liczby kroków QGIS. Uruchomienie zatrzymuje się samo po 60 wywołaniach narzędzi lub 40 minutach, więc zadanie, które poszło w bok, nie może działać w nieskończoność.
Do czego sięga
Dane. Lokalne pliki, zdalne pliki, WFS, WMS, XYZ, zobrazowania STAC i COG, wycinki OpenStreetMap, geokodowanie, routing. Upuść GeoPackage na panel, a wczyta się jako warstwa.
Analiza. Dowolny algorytm Processing, z nazwami parametrów i znanymi pułapkami wyszukanymi, a nie zgadniętymi. Bufory, łączenia, statystyki strefowe, kontrole topologii, izochrony z dróg OSM, profile wysokościowe wzdłuż linii.
Kartografia. Symbolika, renderery skategoryzowane i stopniowane, etykiety, układy do druku z mapą, legendą, skalą liniową i strzałką północy, potem eksport do PDF lub PNG.
Edycja. Dodawanie, aktualizacja i usuwanie obiektów, naprawa geometrii, edycja wierzchołków, łączenie i dzielenie, w ramach prawdziwej sesji edycyjnej QGIS, którą możesz wycofać.
Odpowiedzi. Gdzie mieszka ustawienie QGIS i jak zrobić rzecz ręcznie, z oficjalnej dokumentacji QGIS, wraz z linkiem. Zapytaj, jak naprawić nieprawidłowe geometrie, a dostaniesz odpowiedź, nie uruchomienie.
Jeśli zainstalowane są AI Edit lub AI Segmentation, agent steruje też nimi: przekształca zobrazowanie z prompt, albo wektoryzuje każde wystąpienie obiektu wewnątrz strefy.
Sprawdza własną pracę
Na poziomie Medium i wyżej agent renderuje mapę i patrzy na to, co wytworzył. W uruchomieniu układu zrobił dokładnie to, uznał wynik za nieczytelny i poprawił kolejność rysowania przed zakończeniem.
To zachowanie warte uwagi, w obie strony. Zgłosił, że tylko 186 z 3 124 budynków miało użyteczną wysokość, zamiast po cichu stylizować pole pełne nulli. Może też być pewnie błędny, więc ślad pozostaje rzeczą do czytania.
Zachowaj kontrolę
Trzy rzeczy stoją między modelem a Twoim projektem.
Chip uprawnień, obok + w kompozytorze, decyduje, kiedy zatrzymuje się, by zapytać.
| Poziom | Pyta przed |
|---|---|
| Ask first | Każdą zmianą |
| Balanced (default) | Usuwaniem i nadpisywaniem |
| Autopilot | Niczym, z wyjątkiem wydawania kredytów i uruchamiania Python |
Autopilot to wybór na sesję: restart QGIS wraca do Balanced, niezależnie od tego, co wybrałeś ostatnio. Dwie rzeczy zawsze pytają, na każdym poziomie: wszystko, co wydaje kredyty, oraz uruchamianie surowego Python, które widzisz przed wykonaniem.
Karta zatwierdzenia to tak wygląda pytanie. Jedno zdanie mówiące, co zaraz się wydarzy, Twoja odpowiedź, i zwija się do jednej linii po decyzji, więc długie uruchomienie pozostaje czytelne.
Cofnij. Każde uruchomienie zostawia checkpoint. Strzałka w nagłówku panelu otwiera listę, od najnowszych, z odhaczonym wierszem, na którym jest Twój projekt.
Wybierz wiersz, a projekt wraca do niego. Przywracanie najpierw przechwytuje stan, który opuszcza, więc samo może zostać cofnięte, a Ctrl+Alt+Z cofa bez otwierania czegokolwiek. Checkpointy są zakotwiczone na uruchomieniach, nie na pojedynczych wywołaniach narzędzi.
Daj mu właściwy kontekst
Agent już czyta projekt: nazwy warstw, typy, CRS, liczby obiektów, nazwy pól, zasięgi, kanwę, Twoją selekcję. To, co dodajesz, to to, czego nie widzi.
- Załącz zdjęcie lub plik z danymi, albo warstwę tego projektu.
- Przeciągnij warstwę prosto z panelu Warstwy QGIS na panel.
- Upuść pliki gdziekolwiek na panel: dane wczytują się jako warstwa, zdjęcia idą do modelu.
- Wpisz
@, aby nazwać źródło danych lub jeden z Twoich zainstalowanych pluginów QGIS wewnątrz wiadomości.
Każdy projekt trzyma własne czaty. Lupka w nagłówku przeszukuje je po tytule i po tekście wiadomości, a czat eksportuje się jako Markdown.
Dwa ustawienia warte zmiany
Effort, chip przed Send, to nie selektor modelu. Nazywa, ile myślenia kupujesz.
| Poziom | Co robi | Plan |
|---|---|---|
| Instant | Zaczyna pracę tak szybko, jak to możliwe. Nie planuje ani nie researchuje | Free |
| Medium | Planuje, sprawdza wyniki, wyszukuje algorytmy i dokumentację | Pro |
| High | Głębsze planowanie, research i samodzielne prowadzenie w trudniejszych zadaniach | Pro |
Instant jest dobry do „what CRS is this project in” i do pojedynczej zmiany stylizacji. Medium wytworzył każde uruchomienie w tym przewodniku, w tym pytania i samokontrole. High jest do zadania, na które inaczej zarezerwowałbyś popołudnie.
Connectors, pierwsza strona Settings, decyduje, skąd pochodzą dane. Trzydzieści dziewięć źródeł, dziesięć włączonych domyślnie: OpenStreetMap, Overture, Natural Earth, NASA, Copernicus, Planetary Computer, krajowe agencje kartograficzne i inne. Każde mówi, czego potrzebuje przed włączeniem, a większość nie potrzebuje niczego.
Twoje zainstalowane pluginy QGIS dostają wiersze na tej samej stronie, więc agent może sięgać do nich po nazwie.
Personalisation to druga strona warta wizyty. Jak AI powinno Cię nazywać, czym się zajmujesz, akapit o Twojej pracy, stałe instrukcje, Twoje doświadczenie GIS, metryczne czy imperialne, jak powinny nazywać się nowe warstwy oraz notatki, które trzyma między czatami.
Co opuszcza Twój komputer
Każda wiadomość idzie do naszej hostowanej usługi. Co podróżuje: Twoje żądanie, opis projektu (CRS, zasięg, a dla każdej warstwy nazwa, typ, typ geometrii, widoczność, liczba obiektów, nazwy pól i zasięg, plus jeden przykładowy wiersz aktywnej warstwy), ścieżka pliku projektu, Twoje ostatnie uruchomienia Processing, najnowsze ostrzeżenia QGIS i wszystko, co załączyłeś.
Co nie: zawartość Twoich plików raster i wektorowych, sam plik projektu, geometrie obiektów, całe tabele atrybutów oraz żaden projekt, o który nie pytałeś. Twój klucz aktywacyjny nigdy nie pojawia się w wyniku narzędzia, a hasła do baz danych wewnątrz URI warstw są wymazywane z każdego wyniku i traceback.
Free vs Pro
Free daje Ci 10 uruchomień miesięcznie, na szybkim modelu, z każdym narzędziem, każdym konektorem i każdym pluginem QGIS, do użytku osobistego. Pro to 250 uruchomień miesięcznie za 49 EUR: model Pro do trudnych zadań, Effort Medium i High, pamięć i stałe instrukcje, dłuższe uruchomienia, użytek komercyjny.
Nic nie jest mierzone na wywołanie narzędzia. Uruchomienie 60-krokowe i 3-krokowe kosztują tyle samo.
Pytania
Czy może zepsuć mój projekt?
Zmienia go, w tym rzecz, a zmiana jest odwracalna. Balanced pyta przed wszystkim destrukcyjnym, a checkpoint uruchomienia przywraca projekt nawet po zatwierdzeniu czegoś, czego nie powinieneś. Mimo to zapisz projekt przed długą sesją, tak jak przed każdą partią edycji.
Czy zapisuje Python w moim QGIS?
Może uruchamiać Python, gdy zadanie tego potrzebuje, i to jedyna rzecz, o którą pyta każdy poziom, w tym Autopilot. Widzisz kod przed wykonaniem.
Co się dzieje, gdy się myli?
To model językowy, więc może się mylić, i to pewnie. Do tego służy blok aktywności: rozwiń go, popatrz na wybrane argumenty i zwrócone liczby. Nasze własne uruchomienie powiedziało, że tylko 186 z 3 124 budynków miało użyteczną wysokość, a to zdanie warte przeczytania przed zaufaniem mapie.
Ile trwa uruchomienie?
Sekundy dla pytania, minuty dla prawdziwej pracy. W tym przewodniku: 43 sekundy dla mapy bazowej, 6 minut 30 dla budynków i ich rampy wysokości, 2 minuty 37 dla układu, poniżej minuty dla każdego pytania. QGIS pozostaje używalny podczas pobierania.
Czy działa offline?
Nie. Nie ma lokalnego modelu ani trybu offline. plugin działa na Twojej maszynie, model działa na naszej.
Czy moje dane są używane do trenowania modelu?
Nie. Usługa planuje kroki QGIS i nic więcej.
Czy to open source?
plugin tak, na GPL-2.0-or-later: executor narzędzi, model uprawnień, strażnicy plików i sieci, panel. Więc to, co działa na Twoim komputerze, jest w pełni audytowalne. Hostowana usługa, jej prompt i katalog otwartych danych nie.
Co zapamiętać
Opisz wynik, nie procedurę. Agent najpierw czyta projekt, więc nazywanie warstw i ścieżek to zwykle stracone pisanie.
Jeden prompt to jedno uruchomienie, niezależnie od kosztu w krokach, i zatrzymuje się samo po 60 wywołaniach narzędzi lub 40 minutach.
Blok aktywności to produkt. Rozwijanie go to sposób, by odróżnić dobry wynik od prawdopodobnego.
Każde uruchomienie zostawia checkpoint, a przywracanie samo może zostać cofnięte, więc zatwierdzenie czegoś, czego żałujesz, nie jest ślepą uliczką.
Effort kupuje planowanie i sprawdzanie, nie inną osobowość. Instant odpowiada, Medium pracuje i weryfikuje, High najpierw myśli.
Connectors decydują, jakie dane może znaleźć. Włączenie krajowej agencji kartograficznej jest warte więcej niż jakiekolwiek sformułowanie prompt.
