AI Agent für QGIS: Der komplette Leitfaden
AI Agent ist ein Chat-Panel in 
. Du schreibst die Aufgabe, und die Arbeit läuft im bereits geöffneten Projekt, mit seinen Layern, seinem CRS, seiner Auswahl und dem Ausschnitt auf dem Bildschirm. Wir entwickeln das Tool selbst, daher geht es in diesem Leitfaden um unser eigenes Werkzeug.
Dieser Leitfaden behandelt deinen ersten Lauf, was der Agent erreicht, die zwei Chips, die sein Verhalten bestimmen, und wie du einen unerwünschten Lauf rückgängig machst.
Was ein Prompt bewirkt
Vier Sätze, nacheinander in dasselbe Panel getippt, in einem Projekt. Nichts davon wurde von Hand vorbereitet.
Installieren und anmelden
Öffne in QGIS Plugins -> Manage and Install Plugins, suche nach AI Agent und klicke auf Install. Es läuft ab QGIS 3.28, QGIS 4 eingeschlossen, unter Windows, macOS und Linux.
Öffne das Panel über die TerraLab-Symbolleiste und klicke auf Sign in / Sign up. Dein Browser öffnet sich, du erstellst ein Konto, und das plugin verbindet sich selbst. Kein API-Key, keine Kreditkarte, kostenlose Läufe zum Einstieg.
Dein erster Lauf
Beschreibe das Ergebnis, nicht den Ablauf
"Färbe die Gebäude nach Höhe ein" ist ein besserer prompt als "öffne die Eigenschaften, wähle einen abgestuften Renderer, wähle das Höhenfeld". Der Agent liest das Projekt, bevor er handelt, daher ist das Nennen von layer-Namen, Feldern und Pfaden meist verschwendete Tipparbeit.
Lies die Schritte, nicht nur die Antwort
Eine graue Zeile unter deiner Nachricht zählt die Arbeit: 4 steps, 39.6s. Klappe sie auf, und jeder Werkzeugaufruf steht dort mit seinen Argumenten und dem, was zurückkam. So unterscheidest du ein gutes Ergebnis von einem bloß plausiblen.
Antworte, wenn er fragt
Ein Lauf kann bei einer kleinen Karte mit zwei bis vier Optionen anhalten. Bei uns geschah das zweimal: Die Ansicht enthielt 6,355 OSM-Objekte, und nur 117 von 3,124 Gebäuden trugen ein Höhen-Tag. Beide waren echte Weggabelungen in der Arbeit, und beide sind danach in der Spur sichtbar.
Prüfe, was sich geändert hat
Chips unter der Antwort nennen die layer, die der Lauf erstellt oder verändert hat. Klicke auf einen für das übliche QGIS-Menü: im Layers panel anzeigen, dorthin zoomen, die Attributtabelle öffnen, layer-Eigenschaften.
Ein prompt ist ein Lauf, egal wie viele QGIS-Schritte er braucht. Ein Lauf hält von selbst bei 60 Werkzeugaufrufen oder 40 Minuten an, damit eine entgleiste Aufgabe nicht endlos weiterlaufen kann.
Was er erreicht
Daten. Lokale Dateien, entfernte Dateien, WFS, WMS, XYZ, STAC- und COG-Bilder, OpenStreetMap-Auszüge, Geokodierung, Routing. Ziehe ein GeoPackage auf das Panel, und es lädt als layer.
Analyse. Jeder Processing-Algorithmus, mit Parameternamen und bekannten Fallstricken, die nachgeschlagen statt geraten werden. Puffer, Verknüpfungen, zonale Statistiken, Topologieprüfungen, Isochronen aus OSM-Straßen, Höhenprofile entlang einer Linie.
Kartografie. Symbolisierung, kategorisierte und abgestufte Renderer, Beschriftungen, Drucklayouts mit Karte, Legende, Maßstabsleiste und Nordpfeil, dann ein Export nach PDF oder PNG.
Bearbeitung. Objekte hinzufügen, aktualisieren und löschen, Geometrie reparieren, Stützpunkte bearbeiten, zusammenführen und teilen, innerhalb einer echten QGIS-Bearbeitungssitzung, die du zurückrollen kannst.
Antworten. Wo eine QGIS-Einstellung liegt und wie man die Sache von Hand erledigt, aus der offiziellen QGIS-Dokumentation, mit Link. Frag, wie man ungültige Geometrien repariert, und du bekommst eine Antwort, keinen Lauf.
Sind AI Edit oder AI Segmentation installiert, steuert der Agent auch diese: Bilder per prompt transformieren oder jede Instanz eines Objekts innerhalb einer Zone vektorisieren.
Er prüft seine eigene Arbeit
Ab Effort-Stufe Medium rendert der Agent die Karte und betrachtet, was er erzeugt hat. Im Layout-Lauf tat er genau das, entschied, dass das Ergebnis nicht lesbar war, und korrigierte die Zeichenreihenfolge vor dem Abschluss.
Das ist das Verhalten, auf das es ankommt, in beide Richtungen. Er meldete, dass nur 186 von 3,124 Gebäuden eine brauchbare Höhe hatten, statt stillschweigend ein Feld voller Nullwerte zu stylen. Er kann aber auch selbstsicher falschliegen, daher bleibt die Spur die Sache, die man lesen sollte.
Die Kontrolle behalten
Drei Dinge stehen zwischen dem Modell und deinem Projekt.
Der Berechtigungs-Chip, neben dem + im Composer, entscheidet, wann er anhält, um zu fragen.
| Stufe | Fragt nach vor |
|---|---|
| Ask first | Jeder Änderung |
| Balanced (Standard) | Löschen und Überschreiben |
| Autopilot | Nichts, außer dem Ausgeben von Credits und dem Ausführen von Python |
Autopilot gilt nur für die laufende Sitzung: Ein QGIS-Neustart kehrt zu Balanced zurück, unabhängig davon, was du zuletzt gewählt hattest. Zwei Dinge fragen immer, auf jeder Stufe: alles, was Credits ausgibt, und das Ausführen von rohem Python, das du siehst, bevor es läuft.
Die Zustimmungskarte ist das, wie das Fragen aussieht. Ein Satz, der sagt, was gleich passiert, deine Antwort, und sie klappt nach der Entscheidung zu einer einzigen Zeile zusammen, damit ein langer Lauf lesbar bleibt.
Rückgängig machen. Jeder Lauf hinterlässt einen Checkpoint. Der Pfeil im Panel-Header öffnet die Liste, neueste zuerst, mit der Zeile angehakt, auf der dein Projekt steht.
Wähle eine Zeile, und das Projekt kehrt dorthin zurück. Die Wiederherstellung hält zuerst den Zustand fest, den sie verlässt, sodass sie sich selbst wieder rückgängig machen lässt, und Ctrl+Alt+Z geht einen Schritt zurück, ohne etwas zu öffnen. Checkpoints sind an Läufen verankert, nicht an einzelnen Werkzeugaufrufen.
Ihm den richtigen Kontext geben
Der Agent liest das Projekt bereits: layer-Namen, -Typen, CRS, Objektanzahlen, Feldnamen, Ausdehnungen, den Kartenbereich, deine Auswahl. Was du hinzufügst, ist das, was er nicht sehen kann.
- Hänge ein Foto oder eine Datendatei an, oder einen layer dieses Projekts.
- Ziehe einen layer direkt aus dem QGIS Layers panel auf das Panel.
- Lass Dateien irgendwo auf dem Panel fallen: Daten laden als layer, Bilder gehen an das Modell.
- Tippe
@, um eine Datenquelle oder eines deiner installierten QGIS-plugins in der Nachricht zu benennen.
Jedes Projekt führt seine eigenen Chats. Die Lupe im Header durchsucht sie nach Titel und Nachrichtentext, und ein Chat lässt sich als Markdown exportieren.
Die zwei Einstellungen, die es wert sind, geändert zu werden
Effort, der Chip vor Send, ist keine Modellauswahl. Er benennt, wie viel Denkarbeit du kaufst.
| Stufe | Was sie bewirkt | Tarif |
|---|---|---|
| Instant | Beginnt so schnell wie möglich zu arbeiten. Plant nicht und recherchiert nicht | Free |
| Medium | Plant, prüft seine Ergebnisse, schlägt Algorithmen und Dokumentation nach | Pro |
| High | Tiefere Planung, Recherche und eigenständige Ausrichtung bei schwierigeren Aufgaben | Pro |
Instant passt zu "in welchem CRS ist dieses Projekt" und zu einer einzelnen Stiländerung. Medium erzeugte jeden Lauf in diesem Leitfaden, Fragen und Selbstprüfungen eingeschlossen. High ist für die Aufgabe, für die du sonst einen Nachmittag geblockt hättest.
Connectors, die erste Seite der Einstellungen, entscheidet, woher Daten kommen. Neununddreißig Quellen, zehn standardmäßig aktiv: OpenStreetMap, Overture, Natural Earth, NASA, Copernicus, der Planetary Computer, die nationalen Kartierungsbehörden und mehr. Jede nennt, was sie braucht, bevor du sie einschaltest, und die meisten brauchen gar nichts.
Deine installierten QGIS-plugins bekommen Zeilen auf derselben Seite, damit der Agent sie namentlich erreichen kann.
Personalisierung ist die andere Seite, die einen Besuch wert ist. Wie die AI dich nennen soll, was du machst, ein Absatz über deine Arbeit, feste Anweisungen, deine GIS-Erfahrung, metrisch oder imperial, wie neue layer benannt werden sollen, und die Notizen, die sie zwischen Chats behält.
Was dein Gerät verlässt
Jede Nachricht geht an unseren gehosteten Dienst. Was mitreist: deine Anfrage, eine Beschreibung des Projekts (CRS, Ausdehnung und pro layer der Name, Typ, Geometrietyp, Sichtbarkeit, Objektanzahl, Feldnamen und Ausdehnung, plus eine Beispielzeile des aktiven layers), der Projektdateipfad, deine letzten Processing-Läufe, die neuesten QGIS-Warnungen, und alles, was du angehängt hast.
Was nicht: der Inhalt deiner Raster- und Vektordateien, deine Projektdatei selbst, Objektgeometrien, ganze Attributtabellen, und jedes Projekt, nach dem du nicht gefragt hast. Dein Activation Key erscheint nie in einem Werkzeugergebnis, und Datenbankpasswörter in layer-URIs werden aus jedem Ergebnis und jedem Traceback entfernt.
Free vs Pro
Free gibt dir 10 Läufe pro Monat, auf dem schnellen Modell, mit jedem Werkzeug, jedem Connector und jedem QGIS-plugin, für die private Nutzung. Pro sind 250 Läufe pro Monat für 49 EUR: das Pro-Modell für schwierige Aufgaben, Effort-Stufen Medium und High, Gedächtnis und feste Anweisungen, längere Läufe, kommerzielle Nutzung.
Nichts wird pro Werkzeugaufruf abgerechnet. Der Lauf mit 60 Schritten und der Lauf mit 3 Schritten kosten gleich viel.
Fragen
Kann er mein Projekt kaputt machen?
Er verändert es, das ist der Sinn der Sache, und die Änderung ist umkehrbar. Balanced fragt vor allem Destruktiven nach, und der Lauf-Checkpoint setzt das Projekt selbst dann zurück, wenn du etwas genehmigt hast, das du nicht hättest genehmigen sollen. Speichere dein Projekt trotzdem vor einer langen Sitzung, so wie du es vor jeder Reihe von Bearbeitungen tun würdest.
Schreibt er Python in mein QGIS?
Er kann Python ausführen, wenn eine Aufgabe es braucht, und das ist die eine Sache, nach der jede Stufe fragt, Autopilot eingeschlossen. Du siehst den Code, bevor er läuft.
Was passiert, wenn er falschliegt?
Er ist ein Sprachmodell, kann also falschliegen, und zwar selbstsicher. Dafür ist der Aktivitätsblock da: aufklappen, die gewählten Argumente und die zurückgekommenen Zahlen ansehen. Unser eigener Lauf gab an, dass nur 186 von 3,124 Gebäuden eine brauchbare Höhe hatten, die Art von Zeile, die es wert ist, gelesen zu werden, bevor du der Karte vertraust.
Wie lange dauert ein Lauf?
Sekunden für eine Frage, Minuten für echte Arbeit. In diesem Leitfaden: 43 Sekunden für die Basiskarte, 6 Minuten 30 für die Gebäude und ihre Höhenrampe, 2 Minuten 37 für das Layout, unter einer Minute für jede Frage. QGIS bleibt nutzbar, während ein Abruf läuft.
Funktioniert er offline?
Nein. Es gibt kein lokales Modell und keinen Offline-Modus. Das plugin läuft auf deinem Gerät, das Modell läuft auf unserem.
Werden meine Daten zum Trainieren eines Modells verwendet?
Nein. Der Dienst plant die QGIS-Schritte, und sonst nichts.
Ist es Open Source?
Das plugin ist es, unter GPL-2.0-or-later: der Tool-Executor, das Berechtigungsmodell, die Datei- und Netzwerkschutzmaßnahmen, das Panel. Was auf deinem Rechner läuft, ist also vollständig überprüfbar. Der gehostete Dienst, sein prompt und der Katalog offener Daten sind es nicht.
Was du dir merken solltest
Beschreibe das Ergebnis, nicht den Ablauf. Der Agent liest das Projekt zuerst, daher ist das Nennen von layern und Pfaden meist verschwendete Tipparbeit.
Ein prompt ist ein Lauf, egal was er an Schritten kostet, und er hält von selbst bei 60 Werkzeugaufrufen oder 40 Minuten an.
Der Aktivitätsblock ist das Produkt. Ihn aufzuklappen, ist die Art, wie du ein gutes Ergebnis von einem bloß plausiblen unterscheidest.
Jeder Lauf hinterlässt einen Checkpoint, und eine Wiederherstellung lässt sich selbst rückgängig machen, sodass etwas zu genehmigen, das du bereust, keine Sackgasse ist.
Effort kauft Planung und Prüfung, keine andere Persönlichkeit. Instant antwortet, Medium arbeitet und prüft, High denkt zuerst nach.
Connectors entscheiden, welche Daten er finden kann. Die Kartierungsbehörde deines Landes einzuschalten, ist mehr wert als jede prompt-Formulierung.
