AI Agent voor QGIS: complete handleiding
AI Agent is een chatpaneel in 
. Je schrijft de taak, en die wordt uitgevoerd in het project dat je al open hebt, met zijn lagen, zijn CRS, zijn selectie en de extent die op het scherm staat. We bouwen het zelf, dus deze handleiding gaat over onze eigen tool.
Ze behandelt je eerste run, wat de agent kan bereiken, de twee chips die bepalen hoe hij zich gedraagt, en hoe je een run die je niet wilde ongedaan maakt.
Wat één prompt doet
Vier zinnen, na elkaar getypt in hetzelfde paneel, in één project. Niets hieronder is met de hand voorbereid.
Installeren en inloggen
Open in QGIS Plugins -> Manage and Install Plugins, zoek naar AI Agent, en klik op Install. Het werkt op QGIS 3.28 en later, QGIS 4 inbegrepen, op Windows, macOS en Linux.
Open het paneel via de TerraLab-toolbar en klik op Sign in / Sign up. Je browser opent, je maakt een account aan, en de plugin verbindt zichzelf. Geen API-sleutel, geen creditcard, gratis runs om te beginnen.
Je eerste run
Beschrijf het resultaat, niet de procedure
"Kleur de gebouwen op hoogte" is een betere prompt dan "open de eigenschappen, kies een graduated renderer, kies het hoogteveld". De agent leest het project voordat hij handelt, dus lagen, velden en paden benoemen is meestal verspilde moeite.
Lees de stappen, niet alleen het antwoord
Een grijze regel onder je bericht telt het werk: 4 steps, 39.6s. Vouw ze open en elke tool-aanroep staat er, met zijn argumenten en wat eruit kwam. Zo onderscheid je een goed resultaat van een plausibel resultaat.
Antwoord wanneer erom gevraagd wordt
Een run kan stoppen bij een klein kaartje met twee tot vier opties. Bij ons gebeurde dat twee keer: de weergave bevatte 6,355 OSM-features, en slechts 117 van 3,124 gebouwen hadden een hoogtelabel. Beide waren echte vertakkingen in het werk, en beide zijn achteraf zichtbaar in de trace.
Controleer wat er is veranderd
Chips onder het antwoord noemen de lagen die de run heeft gemaakt of aangeraakt. Klik op een chip voor het gebruikelijke QGIS-menu: tonen in het Layers-paneel, ernaartoe zoomen, de attributentabel openen, laageigenschappen.
Eén prompt is één run, hoeveel QGIS-stappen die ook vergt. Een run stopt vanzelf bij 60 tool-aanroepen of 40 minuten, zodat een taak die is misgelopen niet eeuwig kan doorlopen.
Wat hij kan bereiken
Gegevens. Lokale bestanden, externe bestanden, WFS, WMS, XYZ, STAC en COG-beelden, OpenStreetMap-extracten, geocoding, routering. Zet een GeoPackage op het paneel en het laadt als laag.
Analyse. Elk Processing-algoritme, met de parameternamen en de bekende valkuilen opgezocht in plaats van geraden. Buffers, joins, zonal statistics, topologiecontroles, isochronen op basis van OSM-wegen, hoogteprofielen langs een lijn.
Cartografie. Symbologie, gecategoriseerde en gegradueerde renderers, labels, afdruklayouts met een kaart, een legenda, een schaalbalk en een noordpijl, en vervolgens een export naar PDF of PNG.
Bewerken. Features toevoegen, bijwerken en verwijderen, geometrieherstel, vertex-bewerkingen, samenvoegen en splitsen, binnen een echte QGIS-bewerkingssessie die je kunt terugdraaien.
Antwoorden. Waar een QGIS-instelling zich bevindt en hoe je iets met de hand doet, uit de officiële QGIS-documentatie, met de link. Vraag hoe je ongeldige geometrieën herstelt en je krijgt een antwoord, geen run.
Als AI Edit of AI Segmentation geïnstalleerd is, stuurt de agent die ook aan: beelden transformeren vanuit een prompt, of elk voorbeeld van een object binnen een zone vectoriseren.
Hij controleert zijn eigen werk
Vanaf Medium effort en hoger rendert de agent de kaart en bekijkt hij wat hij heeft gemaakt. In de layout-run deed hij precies dat, oordeelde dat het resultaat niet leesbaar was, en herstelde de tekenvolgorde voordat hij afrondde.
Dat is het gedrag dat de moeite waard is om op te letten, in beide richtingen. Hij meldde dat slechts 186 van 3,124 gebouwen een bruikbare hoogte hadden, in plaats van stilzwijgend een veld vol nulls te stylen. Hij kan ook overtuigd fout zitten, dus de trace blijft het ding om te lezen.
De controle houden
Drie dingen staan tussen het model en je project.
De permission chip, naast de + in de composer, bepaalt wanneer hij stopt om te vragen.
| Niveau | Hij vraagt vóór |
|---|---|
| Ask first | Elke wijziging |
| Balanced (standaard) | Verwijderen en overschrijven |
| Autopilot | Niets, behalve het uitgeven van credits en het uitvoeren van Python |
Autopilot is een sessiekeuze: een herstart van QGIS keert terug naar Balanced, ongeacht wat je de vorige keer koos. Twee dingen vragen altijd om bevestiging, op elk niveau: alles wat credits uitgeeft, en het uitvoeren van ruwe Python, wat je te zien krijgt voordat het draait.
De approval card is hoe vragen eruitziet. Eén zin die zegt wat er staat te gebeuren, jouw antwoord, en het klapt in tot één regel zodra er een beslissing is, zodat een lange run leesbaar blijft.
Ongedaan maken. Elke run laat een checkpoint achter. De pijl in de paneelkop opent de lijst, nieuwste eerst, met de regel waarop je project staat aangevinkt.
Kies een regel en het project keert ernaar terug. De restore legt eerst de staat vast die hij achterlaat, zodat hij zelf ook ongedaan gemaakt kan worden, en Ctrl+Alt+Z stapt terug zonder iets te openen. Checkpoints zijn verankerd aan runs, niet aan losse tool-aanroepen.
Hem de juiste context geven
De agent leest het project al: laagnamen, types, CRS, aantal features, veldnamen, extents, het canvas, je selectie. Wat je toevoegt, is wat hij niet kan zien.
- Voeg een foto of een gegevensbestand toe, of een laag van dit project.
- Sleep een laag rechtstreeks vanuit het QGIS Layers-paneel naar het paneel.
- Zet bestanden neer waar dan ook op het paneel: gegevens laden als laag, afbeeldingen gaan naar het model.
- Typ
@om een gegevensbron of een van je geïnstalleerde QGIS-plugins in het bericht te noemen.
Elk project houdt zijn eigen gesprekken bij. Het vergrootglas in de kop doorzoekt ze op titel en op berichttekst, en een gesprek exporteert als Markdown.
De twee instellingen die het waard zijn om te veranderen
Effort, de chip vóór Send, is geen modelkiezer. Ze benoemt hoeveel denkwerk je koopt.
| Niveau | Wat het doet | Plan |
|---|---|---|
| Instant | Begint zo snel mogelijk te werken. Plant of onderzoekt niet | Free |
| Medium | Plant, controleert zijn resultaten, zoekt algoritmes en documentatie op | Pro |
| High | Dieper plannen, onderzoek en eigen koers bij moeilijkere taken | Pro |
Instant is de juiste keuze voor "in welk CRS staat dit project" en voor een enkele stylingwijziging. Medium leverde elke run in deze handleiding, vragen en zelfcontroles inbegrepen. High is voor de taak waar je anders een middag voor had vrijgemaakt.
Connectors, de eerste pagina van Settings, bepaalt waar gegevens vandaan komen. Negenendertig bronnen, tien standaard aan: OpenStreetMap, Overture, Natural Earth, NASA, Copernicus, de Planetary Computer, de nationale karteringsdiensten, en meer. Elke bron vermeldt wat ze nodig heeft voordat je ze inschakelt, en de meeste hebben niets nodig.
Je geïnstalleerde QGIS-plugins krijgen rijen op dezelfde pagina, zodat de agent ze bij naam kan bereiken.
Personalisation is de andere pagina die een bezoek waard is. Hoe de AI je moet noemen, wat je doet, een alinea over je werk, vaste instructies, je GIS-ervaring, metrisch of imperiaal, hoe nieuwe lagen genoemd moeten worden, en de notities die hij tussen gesprekken bijhoudt.
Wat je machine verlaat
Elk bericht gaat naar onze gehoste dienst. Wat meereist: je verzoek, een beschrijving van het project (CRS, extent, en per laag de naam, het type, het geometrietype, de zichtbaarheid, het aantal features, de veldnamen en de extent, plus één voorbeeldrij van de actieve laag), het pad naar het projectbestand, je recente Processing-runs, de nieuwste QGIS-waarschuwingen, en wat je hebt bijgevoegd.
Wat niet: de inhoud van je raster- en vectorbestanden, je projectbestand zelf, feature-geometrieën, volledige attributentabellen, en elk project waarover je niets hebt gevraagd. Je activeringssleutel verschijnt nooit in een tool-resultaat, en databasewachtwoorden in laag-URI's worden uit elk resultaat en elke traceback geschrapt.
Free vs Pro
Free geeft je 10 runs per maand, op het snelle model, met elke tool, elke connector en elke QGIS-plugin, voor persoonlijk gebruik. Pro is 250 runs per maand voor 49 EUR: het Pro-model voor moeilijke taken, Medium en High effort, geheugen en vaste instructies, langere runs, commercieel gebruik.
Niets wordt per tool-aanroep gemeten. De run met 60 stappen en de run met 3 stappen kosten evenveel.
Vragen
Kan het mijn project stukmaken?
Het verandert het project, dat is het hele punt, en de wijziging is omkeerbaar. Balanced vraagt vóór alles wat destructief is, en het run-checkpoint zet het project terug, zelfs nadat je iets hebt goedgekeurd wat je niet had moeten goedkeuren. Sla je project toch op voor een lange sessie, zoals je zou doen vóór elke reeks bewerkingen.
Schrijft het Python in mijn QGIS?
Het kan Python uitvoeren wanneer een taak dat vereist, en dat is het enige waarover elk niveau vraagt, Autopilot inbegrepen. Je ziet de code voordat ze draait.
Wat gebeurt er als het fout zit?
Het is een taalmodel, dus het kan fout zitten, en dat overtuigend. Daarvoor dient het activiteitenblok: vouw het open, bekijk de argumenten die het koos en de aantallen die eruit kwamen. Onze eigen run meldde dat slechts 186 van 3,124 gebouwen een bruikbare hoogte hadden, het soort regel dat de moeite waard is om te lezen voordat je de kaart vertrouwt.
Hoe lang duurt een run?
Seconden voor een vraag, minuten voor echt werk. In deze handleiding: 43 seconden voor de basiskaart, 6 minuten 30 voor de gebouwen en hun hoogte-schaal, 2 minuten 37 voor de layout, minder dan een minuut voor elke vraag. QGIS blijft bruikbaar terwijl een fetch loopt.
Werkt het offline?
Nee. Er is geen lokaal model en geen offline modus. De plugin draait op jouw machine, het model draait op de onze.
Worden mijn gegevens gebruikt om een model te trainen?
Nee. De dienst plant de QGIS-stappen, en niets anders.
Is het open source?
De plugin is dat, onder GPL-2.0-or-later: de tool-executor, het permissiemodel, de bestands- en netwerkbeveiligingen, het paneel. Wat op jouw computer draait, is dus volledig controleerbaar. De gehoste dienst, haar prompt en de open-datacatalogus zijn dat niet.
Wat je moet onthouden
Beschrijf het resultaat, niet de procedure. De agent leest het project eerst, dus lagen en paden benoemen is meestal verspilde moeite.
Eén prompt is één run, wat die ook kost aan stappen, en hij stopt zichzelf bij 60 tool-aanroepen of 40 minuten.
Het activiteitenblok is het product. Het openvouwen is hoe je een goed resultaat onderscheidt van een plausibel resultaat.
Elke run laat een checkpoint achter, en een restore kan zelf ook ongedaan worden gemaakt, dus iets goedkeuren waar je spijt van krijgt is geen doodlopende weg.
Effort koopt planning en controle, geen ander karakter. Instant antwoordt, Medium werkt en verifieert, High denkt eerst na.
Connectors bepalen welke gegevens hij kan vinden. Je nationale karteringsdienst inschakelen is meer waard dan welke promptformulering ook.
