AI Agent pour QGIS : guide complet

AI Agent est un panneau de chat dans . Vous écrivez la tâche, il travaille dans le projet déjà ouvert, avec ses layers, son CRS, sa sélection et l'emprise à l'écran. Nous développons cet outil, ce guide porte donc sur notre propre solution.

Il couvre votre première exécution, ce que l'agent peut atteindre, les deux chips qui décident de son comportement, et comment annuler une exécution que vous ne vouliez pas.

Ce que fait un prompt

Quatre phrases, tapées l'une après l'autre dans le même panneau, dans un seul projet. Rien ci-dessous n'a été préparé à la main.

Installer et se connecter

Dans QGIS, ouvrez Plugins -> Manage and Install Plugins, recherchez AI Agent, puis cliquez sur Install. Il fonctionne sur QGIS 3.28 et au-delà, QGIS 4 inclus, sous Windows, macOS et Linux.

Ouvrez le panneau depuis la barre d'outils TerraLab et cliquez sur Sign in / Sign up. Votre navigateur s'ouvre, vous créez un compte, et le plugin se connecte automatiquement. Aucune clé API, aucune carte bancaire, des exécutions gratuites pour commencer.

Votre première exécution

Un prompt est une exécution, quel que soit le nombre d'étapes QGIS que cela demande. Une exécution s'arrête d'elle-même à 60 appels d'outil ou 40 minutes, pour qu'une tâche partie en vrille ne puisse pas tourner indéfiniment.

Ce qu'il peut atteindre

Données. Fichiers locaux, fichiers distants, WFS, WMS, XYZ, STAC et imagerie COG, extraits OpenStreetMap, géocodage, itinéraires. Déposez un GeoPackage sur le panneau et il se charge comme layer.

Analyse. N'importe quel algorithme Processing, avec les noms de paramètres et les pièges connus recherchés plutôt que devinés. Buffers, jointures, statistiques zonales, contrôles de topologie, isochrones à partir des routes OSM, profils altimétriques le long d'une ligne.

Cartographie. Symbologie, rendus catégorisés et gradués, étiquettes, mises en page avec une carte, une légende, une échelle et une flèche du nord, puis un export en PDF ou PNG.

Édition. Ajout, mise à jour et suppression d'entités, réparation de géométrie, édition de sommets, fusions et découpages, dans une vraie session d'édition QGIS que vous pouvez annuler.

Réponses. Où se trouve un réglage QGIS et comment faire la chose à la main, tiré de la documentation officielle de QGIS, avec le lien. Demandez comment corriger des géométries invalides et vous obtenez une réponse, pas une exécution.

Si AI Edit ou AI Segmentation est installé, l'agent les pilote aussi : transformer une image à partir d'un prompt, ou vectoriser chaque occurrence d'un objet à l'intérieur d'une zone.

Il vérifie son propre travail

À partir de l'effort Medium, l'agent rend la carte et regarde ce qu'il a produit. Dans l'exécution de la mise en page, il a fait exactement cela, jugé le résultat peu lisible, et corrigé l'ordre d'affichage avant de terminer.

C'est le comportement qui mérite attention, dans les deux sens. Il a signalé que seuls 186 des 3 124 bâtiments avaient une hauteur exploitable, plutôt que de styliser silencieusement un champ plein de valeurs nulles. Il peut aussi se tromper avec assurance, donc la trace reste ce qu'il faut lire.

Garder le contrôle

Trois choses se placent entre le modèle et votre projet.

Le chip de permission, à côté du + dans le composer, décide quand il s'arrête pour demander.

Autopilot est un choix de session : un redémarrage de QGIS revient à Balanced, quel qu'ait été votre dernier choix. Deux choses demandent toujours, à tous les niveaux : tout ce qui dépense des crédits, et l'exécution de Python brut, que vous voyez avant qu'il ne s'exécute.

La carte d'approbation est ce à quoi ressemble une demande. Une phrase disant ce qui va se passer, votre réponse, et elle se replie en une seule ligne une fois décidée, pour qu'une longue exécution reste lisible.

Annuler. Chaque exécution laisse un point de contrôle. La flèche dans l'en-tête du panneau ouvre la liste, la plus récente en premier, avec la ligne où se trouve votre projet cochée.

Choisissez une ligne et le projet y revient. La restauration capture d'abord l'état qu'elle laisse, elle peut donc elle-même être annulée, et Ctrl+Alt+Z recule d'un cran sans rien ouvrir. Les points de contrôle sont ancrés sur les exécutions, pas sur les appels d'outil individuels.

Lui donner le bon contexte

L'agent lit déjà le projet : noms des layers, types, CRS, nombre d'entités, noms de champs, emprises, le canevas, votre sélection. Ce que vous ajoutez est ce qu'il ne peut pas voir.

• Joindre une photo ou un fichier de données, ou un layer de ce projet.
• Faire glisser un layer directement depuis le panneau Layers de QGIS vers le panneau.
• Déposer des fichiers n'importe où sur le panneau : les données se chargent comme layer, les images vont au modèle.
• Taper @ pour nommer une source de données ou l'un de vos plugins QGIS installés dans le message.

Chaque projet garde ses propres chats. La loupe dans l'en-tête les recherche par titre et par texte de message, et un chat s'exporte en Markdown.

Les deux réglages qui valent la peine d'être changés

Effort, le chip avant Send, n'est pas un sélecteur de modèle. Il indique combien de réflexion vous achetez.

Instant convient pour « quel est le CRS de ce projet » et pour un simple changement de style. Medium a produit chaque exécution de ce guide, questions et auto-vérifications comprises. High est pour la tâche pour laquelle vous auriez sinon bloqué une après-midi.

Connectors, la première page des Settings, décide d'où viennent les données. Trente-neuf sources, dix activées par défaut : OpenStreetMap, Overture, Natural Earth, la NASA, Copernicus, le Planetary Computer, les agences cartographiques nationales, et d'autres. Chacune indique ce dont elle a besoin avant que vous ne l'activiez, et la plupart n'ont besoin de rien du tout.

Vos plugins QGIS installés obtiennent des lignes sur la même page, l'agent peut donc les atteindre par leur nom.

Personalisation est l'autre page qui vaut une visite. Comment l'IA doit vous appeler, ce que vous faites, un paragraphe sur votre travail, des instructions permanentes, votre expérience en SIG, métrique ou impérial, comment les nouveaux layers doivent être nommés, et les notes qu'il garde entre les chats.

Ce qui quitte votre machine

Chaque message part vers notre service hébergé. Ce qui voyage : votre requête, une description du projet (CRS, emprise, et par layer le nom, le type, le type de géométrie, la visibilité, le nombre d'entités, les noms de champs et l'emprise, plus une ligne d'exemple du layer actif), le chemin du fichier projet, vos exécutions Processing récentes, les derniers avertissements QGIS, et tout ce que vous avez joint.

Ce qui ne voyage pas : le contenu de vos fichiers raster et vecteur, votre fichier projet lui-même, les géométries des entités, les tables attributaires entières, et tout projet que vous n'avez pas mentionné. Votre clé d'activation n'apparaît jamais dans un résultat d'outil, et les mots de passe de base de données contenus dans les URI de layer sont retirés de chaque résultat et de chaque traceback.

Free vs Pro

Free vous donne 10 exécutions par mois, sur le modèle rapide, avec chaque outil, chaque connecteur et chaque plugin QGIS, pour un usage personnel. Pro, c'est 250 exécutions par mois à 49 EUR : le modèle Pro sur les tâches difficiles, les efforts Medium et High, la mémoire et les instructions permanentes, des exécutions plus longues, un usage commercial.

Rien n'est facturé par appel d'outil. L'exécution à 60 étapes et l'exécution à 3 étapes coûtent la même chose.

Questions

Peut-il casser mon projet ?

Il le change, c'est le but, et le changement est réversible. Balanced demande avant tout ce qui est destructeur, et le point de contrôle de l'exécution remet le projet en place même après avoir approuvé quelque chose qu'il ne fallait pas. Enregistrez tout de même votre projet avant une longue session, comme vous le feriez avant tout lot de modifications.

Écrit-il du Python dans mon QGIS ?

Il peut exécuter du Python quand une tâche en a besoin, et c'est la seule chose que tous les niveaux demandent, Autopilot inclus. Vous voyez le code avant qu'il ne s'exécute.

Que se passe-t-il quand il se trompe ?

C'est un modèle de langage, il peut donc se tromper, et avec assurance. C'est à cela que sert le bloc d'activité : dépliez-le, regardez les arguments choisis et les décomptes obtenus. Notre propre exécution a indiqué que seuls 186 des 3 124 bâtiments avaient une hauteur exploitable, le genre de ligne qui vaut la peine d'être lue avant de faire confiance à la carte.

Combien de temps prend une exécution ?

Des secondes pour une question, des minutes pour du vrai travail. Dans ce guide : 43 secondes pour le fond de carte, 6 minutes 30 pour les bâtiments et leur dégradé de hauteur, 2 minutes 37 pour la mise en page, moins d'une minute pour chaque question. QGIS reste utilisable pendant qu'une récupération de données tourne.

Fonctionne-t-il hors ligne ?

Non. Il n'y a ni modèle local ni mode hors ligne. Le plugin tourne sur votre machine, le modèle tourne sur la nôtre.

Mes données servent-elles à entraîner un modèle ?

Non. Le service planifie les étapes QGIS, et rien d'autre.

Est-ce open source ?

Le plugin l'est, sous GPL-2.0-or-later : l'exécuteur d'outils, le modèle de permissions, les garde-fous fichiers et réseau, le panneau. Ce qui tourne sur votre ordinateur est donc entièrement auditable. Le service hébergé, son prompt et le catalogue de données ouvertes ne le sont pas.

À retenir

Décrivez le résultat, pas la procédure. L'agent lit le projet en premier, donc nommer les layers et les chemins est en général du temps perdu.

Un prompt est une exécution, quel qu'en soit le coût en étapes, et elle s'arrête d'elle-même à 60 appels d'outil ou 40 minutes.

Le bloc d'activité est le produit. Le déplier permet de distinguer un bon résultat d'un résultat plausible.

Chaque exécution laisse un point de contrôle, et une restauration peut elle-même être annulée, approuver quelque chose que vous regrettez n'est donc pas une impasse.

L'effort achète de la planification et de la vérification, pas une personnalité différente. Instant répond, Medium travaille et vérifie, High réfléchit d'abord.

Les connecteurs décident des données qu'il peut trouver. Activer votre agence cartographique nationale vaut plus qu'aucune formulation de prompt.

See plans and pricing