AI Agent per QGIS: guida completa

AI Agent è un pannello di chat all'interno di
. Scrivi l'attività e lavora nel progetto che hai già aperto, con i suoi layer, il suo CRS, la sua selezione e l'estensione a schermo. Lo sviluppiamo noi, quindi questa guida riguarda il nostro strumento.
Copre la tua prima esecuzione, cosa può raggiungere l'agente, i due chip che decidono il suo comportamento e come annullare un'esecuzione che non volevi.
Cosa fa un prompt
Quattro frasi, digitate una dopo l'altra nello stesso pannello, in un unico progetto. Niente di quanto segue è stato preparato a mano.




Installazione e accesso
In QGIS, apri Plugins -> Manage and Install Plugins, cerca AI Agent e fai clic su Installa. Funziona su QGIS 3.28 e versioni successive, QGIS 4 incluso, su Windows, macOS e Linux.
Apri il pannello dalla barra degli strumenti TerraLab e fai clic su Accedi / Registrati. Si apre il browser, crei un account e il plugin si collega automaticamente. Nessuna API key, nessuna carta di credito, esecuzioni gratuite per iniziare.
La tua prima esecuzione
Descrivi il risultato, non la procedura
"Colora gli edifici in base all'altezza" è un prompt migliore di "apri le proprietà, scegli un renderer graduato, seleziona il campo altezza". L'agente legge il progetto prima di agire, quindi nominare layer, campi e percorsi è spesso tempo sprecato a digitare.
Leggi i passaggi, non solo la risposta
Una riga grigia sotto il tuo messaggio conta il lavoro svolto: 4 steps, 39.6s. Aprila e trovi ogni chiamata agli strumenti, con i suoi argomenti e ciò che è tornato. È così che distingui un buon risultato da uno solo plausibile.
Rispondi quando te lo chiede
Un'esecuzione può fermarsi su una piccola scheda con due o quattro opzioni. La nostra ha chiesto due volte: la vista conteneva 6,355 elementi OSM, e solo 117 dei 3,124 edifici avevano un tag di altezza. Erano entrambi veri bivi nel lavoro, e restano entrambi visibili nella traccia in seguito.
Controlla cosa è cambiato
I chip sotto la risposta indicano i layer che l'esecuzione ha creato o modificato. Fai clic su uno per il consueto menu di QGIS: mostra nel pannello Layer, ingrandisci su di esso, apri la tabella degli attributi, proprietà del layer.

Un prompt è un'esecuzione, indipendentemente da quanti passaggi QGIS richieda. Un'esecuzione si ferma da sola dopo 60 chiamate agli strumenti o 40 minuti, così un'attività andata storta non può proseguire all'infinito.
Cosa può raggiungere
Dati. File locali, file remoti, WFS, WMS, XYZ, immagini STAC e COG, estratti OpenStreetMap, geocodifica, instradamento. Trascina un GeoPackage sul pannello e viene caricato come layer.
Analisi. Qualsiasi algoritmo di Processing, con i nomi dei parametri e le insidie note verificate anziché indovinate. Buffer, join, statistiche zonali, controlli di topologia, isocrone dalle strade OSM, profili altimetrici lungo una linea.
Cartografia. Simbologia, renderer per categorie e graduati, etichette, layout di stampa con una mappa, una legenda, una barra di scala e una freccia del nord, poi un'esportazione in PDF o PNG.
Modifica. Aggiunta, aggiornamento ed eliminazione di feature, riparazione della geometria, modifica dei vertici, unioni e divisioni, all'interno di una vera sessione di modifica QGIS che puoi annullare.
Risposte. Dove si trova un'impostazione di QGIS e come fare la cosa a mano, tratte dalla documentazione ufficiale di QGIS, con il link. Chiedi come correggere geometrie non valide e ottieni una risposta, non un'esecuzione.

Se AI Edit o AI Segmentation sono installati, l'agente li guida anche: trasforma immagini a partire da un prompt, oppure vettorializza ogni istanza di un oggetto all'interno di una zona.
Controlla da solo il proprio lavoro
A partire dal livello di impegno Medium, l'agente renderizza la mappa e osserva cosa ha prodotto. Nell'esecuzione del layout ha fatto esattamente questo, ha deciso che il risultato non era leggibile e ha corretto l'ordine di disegno prima di terminare.

È il comportamento su cui vale la pena prestare attenzione, in entrambe le direzioni. Ha segnalato che solo 186 dei 3,124 edifici avevano un'altezza utilizzabile, invece di stilizzare in silenzio un campo pieno di valori nulli. Può anche sbagliarsi con sicurezza, quindi la traccia resta la cosa da leggere.
Mantenere il controllo
Tre cose si frappongono tra il modello e il tuo progetto.
Il chip dei permessi, accanto al + nel compositore, decide quando si ferma per chiedere.
| Livello | Chiede prima di |
|---|---|
| Ask first | Ogni modifica |
| Balanced (predefinito) | Eliminare e sovrascrivere |
| Autopilot | Niente, tranne spendere crediti ed eseguire Python |

Autopilot è una scelta di sessione: un riavvio di QGIS torna a Balanced, qualunque cosa avessi scelto l'ultima volta. Due cose chiedono sempre conferma, a ogni livello: qualsiasi cosa spenda crediti, e l'esecuzione di Python grezzo, che vedi prima che venga eseguito.
La scheda di approvazione è l'aspetto che assume la richiesta. Una frase che dice cosa sta per accadere, la tua risposta, e si riduce a una singola riga una volta deciso, così un'esecuzione lunga resta leggibile.
Annulla. Ogni esecuzione lascia un checkpoint. La freccia nell'intestazione del pannello apre l'elenco, dal più recente, con la riga su cui si trova il tuo progetto contrassegnata.

Scegli una riga e il progetto torna a quello stato. Il ripristino cattura prima lo stato che lascia, così può a sua volta essere annullato, e Ctrl+Alt+Z torna indietro senza aprire nulla. I checkpoint sono ancorati alle esecuzioni, non alle singole chiamate agli strumenti.
Fornire il contesto giusto
L'agente legge già il progetto: nomi dei layer, tipi, CRS, conteggio delle feature, nomi dei campi, estensioni, il canvas, la tua selezione. Ciò che aggiungi è ciò che non può vedere.

- Allega una foto o un file di dati, oppure un layer di questo progetto.
- Trascina un layer direttamente dal pannello Layer di QGIS sul pannello.
- Trascina i file ovunque sul pannello: i dati vengono caricati come layer, le immagini vengono inviate al modello.
- Digita
@per nominare una fonte dati o uno dei tuoi plugin QGIS installati all'interno del messaggio.
Ogni progetto mantiene le proprie chat. La lente d'ingrandimento nell'intestazione le cerca per titolo e per testo dei messaggi, e una chat si esporta come Markdown.
Le due impostazioni che vale la pena cambiare
Effort, il chip prima di Invio, non è un selettore di modello. Indica quanto ragionamento stai acquistando.
| Livello | Cosa fa | Piano |
|---|---|---|
| Instant | Inizia a lavorare il più rapidamente possibile. Non pianifica né fa ricerche | Free |
| Medium | Pianifica, verifica i risultati, consulta algoritmi e documentazione | Pro |
| High | Pianificazione più approfondita, ricerca e autonomia decisionale sui compiti più difficili | Pro |

Instant è adatto per "in che CRS è questo progetto" e per una singola modifica di stile. Medium ha prodotto ogni esecuzione di questa guida, domande e autoverifiche incluse. High è per l'attività per cui avresti altrimenti bloccato un intero pomeriggio.
Connectors, la prima pagina di Impostazioni, decide da dove arrivano i dati. Trentanove fonti, dieci attive per impostazione predefinita: OpenStreetMap, Overture, Natural Earth, NASA, Copernicus, il Planetary Computer, le agenzie cartografiche nazionali e altro ancora. Ognuna indica cosa serve prima di attivarla, e la maggior parte non richiede nulla.

I tuoi plugin QGIS installati ottengono righe nella stessa pagina, così l'agente può raggiungerli per nome.
Personalizzazione è l'altra pagina che vale la pena visitare. Come deve chiamarti l'AI, cosa fai, un paragrafo sul tuo lavoro, istruzioni permanenti, la tua esperienza con il GIS, sistema metrico o imperiale, come devono essere nominati i nuovi layer, e le note che conserva tra una chat e l'altra.

Cosa lascia il tuo computer
Ogni messaggio va al nostro servizio ospitato. Cosa viaggia: la tua richiesta, una descrizione del progetto (CRS, estensione e per ogni layer il nome, il tipo, il tipo di geometria, la visibilità, il conteggio delle feature, i nomi dei campi e l'estensione, più una riga di esempio del layer attivo), il percorso del file di progetto, le tue esecuzioni recenti di Processing, gli avvisi QGIS più recenti, e qualsiasi cosa tu abbia allegato.
Cosa non lo fa: il contenuto dei tuoi file raster e vettoriali, il file di progetto in sé, le geometrie delle feature, le tabelle degli attributi complete, e qualsiasi progetto di cui non hai chiesto. La tua chiave di attivazione non appare mai in un risultato di uno strumento, e le password dei database contenute negli URI dei layer vengono rimosse da ogni risultato e traceback.
Free vs Pro
Free ti dà 10 esecuzioni al mese, sul modello veloce, con tutti gli strumenti, tutti i connettori e tutti i plugin QGIS, per uso personale. Pro è 250 esecuzioni al mese a 49 EUR: il modello Pro sui compiti difficili, effort Medium e High, memoria e istruzioni permanenti, esecuzioni più lunghe, uso commerciale.
Niente viene misurato per chiamata a uno strumento. L'esecuzione da 60 passaggi e quella da 3 passaggi costano lo stesso.
Domande
Può danneggiare il mio progetto?
Lo modifica, ed è proprio questo il punto, e la modifica è reversibile. Balanced chiede conferma prima di qualsiasi azione distruttiva, e il checkpoint dell'esecuzione riporta indietro il progetto anche dopo che hai approvato qualcosa che non avresti dovuto. Salva comunque il tuo progetto prima di una sessione lunga, come faresti prima di qualsiasi serie di modifiche.
Scrive Python nel mio QGIS?
Può eseguire Python quando un'attività lo richiede, ed è l'unica cosa su cui ogni livello chiede conferma, Autopilot incluso. Vedi il codice prima che venga eseguito.
Cosa succede quando sbaglia?
È un modello linguistico, quindi può sbagliare, e con sicurezza. È a questo che serve il blocco di attività: aprilo, guarda gli argomenti che ha scelto e i conteggi che sono tornati. La nostra esecuzione ha detto che solo 186 dei 3,124 edifici avevano un'altezza utilizzabile, il genere di riga che vale la pena leggere prima di fidarsi della mappa.
Quanto dura un'esecuzione?
Secondi per una domanda, minuti per un lavoro vero. In questa guida: 43 secondi per la base cartografica, 6 minuti e 30 per gli edifici e la loro rampa di altezza, 2 minuti e 37 per il layout, meno di un minuto per ogni domanda. QGIS resta utilizzabile mentre un recupero dati è in corso.
Funziona offline?
No. Non c'è un modello locale né una modalità offline. Il plugin viene eseguito sulla tua macchina, il modello viene eseguito sulla nostra.
I miei dati vengono usati per addestrare un modello?
No. Il servizio pianifica i passaggi QGIS, e nient'altro.
È open source?
Il plugin sì, sotto licenza GPL-2.0-or-later: l'esecutore degli strumenti, il modello dei permessi, le protezioni su file e rete, il pannello. Quindi ciò che gira sul tuo computer è verificabile per intero. Il servizio ospitato, il suo prompt e il catalogo dei dati aperti no.
Cosa ricordare
Descrivi il risultato, non la procedura. L'agente legge prima il progetto, quindi nominare layer e percorsi è di solito tempo sprecato a digitare.
Un prompt è un'esecuzione, qualunque sia il suo costo in passaggi, e si ferma da sola dopo 60 chiamate agli strumenti o 40 minuti.
Il blocco di attività è il prodotto. Aprirlo è il modo in cui distingui un buon risultato da uno solo plausibile.
Ogni esecuzione lascia un checkpoint, e un ripristino può a sua volta essere annullato, quindi approvare qualcosa di cui ti penti non è un vicolo cieco.
Effort compra pianificazione e verifica, non una personalità diversa. Instant risponde, Medium lavora e verifica, High pensa prima.
Connectors decide quali dati può trovare. Attivare la tua agenzia cartografica nazionale vale più di qualsiasi formulazione del prompt.


