Vai al contenuto
Torna al blog
AI Agent
QGIS
Tutorial

AI Agent per QGIS: guida completa

QGIS con il pannello AI Agent aperto a destra ed edifici del centro di Bordeaux colorati in base all'altezza su immagini satellitari
Due frasi, partendo da un progetto vuoto: una base cartografica satellitare, poi 3,124 edifici OpenStreetMap colorati in base all'altezza.

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.

Il blocco di attività di un'esecuzione, con chiamate agli strumenti, tempi, due domande a cui è stato risposto e un riepilogo
Un'esecuzione, aperta. Le due righe grigie con un segno di spunta sono le domande poste e le risposte scelte.

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.

L'agente risponde a una domanda pratica su QGIS con tre metodi e un link alla documentazione di QGIS
Una domanda su QGIS stesso: i menu da usare, in ordine, e la pagina di documentazione da cui proviene.

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.

L'agente renderizza la mappa, giudica il risultato non leggibile e corregge lo stile del layer
Senza che gli venga chiesto, a metà esecuzione: renderizza, giudica, corregge. Le parole sono quelle dell'agente.

È 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.

LivelloChiede prima di
Ask firstOgni modifica
Balanced (predefinito)Eliminare e sovrascrivere
AutopilotNiente, tranne spendere crediti ed eseguire Python
Il popover dei permessi con Ask first, Balanced e Autopilot
Un clic, tre livelli, applicati in tempo reale nel mezzo di un'esecuzione.

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.

Il foglio di ripristino che elenca After run 3, Before run 3, fino all'inizio della conversazione
Checkpoint reali dalla sessione di questa guida. L'ultima riga scarta tutto ciò che ha fatto la conversazione.

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.

Il menu degli allegati con Aggiungi foto e file, e Allega un layer di questo progetto
Il pulsante +. I file trascinati ovunque sul pannello seguono lo stesso percorso.
  • 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.

LivelloCosa faPiano
InstantInizia a lavorare il più rapidamente possibile. Non pianifica né fa ricercheFree
MediumPianifica, verifica i risultati, consulta algoritmi e documentazionePro
HighPianificazione più approfondita, ricerca e autonomia decisionale sui compiti più difficiliPro
Il popover di Effort, uno slider a tre posizioni impostato su Medium
Lo slider è l'intero controllo. Un livello indica un risultato, non un modello.

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.

La pagina Connectors nelle impostazioni di AI Agent, con pillole di categoria e un interruttore per fonte
Attivare l'agenzia cartografica del tuo paese cambia le risposte più di qualsiasi formulazione del prompt.

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.

La pagina di personalizzazione con identità, chi sei, istruzioni e come lavori
Scritta una volta, letta all'inizio di ogni conversazione.

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.

See plans and pricing