AI Agent para QGIS: guía completa
AI Agent es un panel de chat dentro de 
. Escribes la tarea, y trabaja en el proyecto que ya tienes abierto, con sus layers, su CRS, su selección y la extensión en pantalla. Nosotros lo construimos, así que esta guía trata sobre nuestra propia herramienta.
Cubre tu primera ejecución, lo que el agente alcanza, los dos chips que deciden cómo se comporta, y cómo deshacer una ejecución que no querías.
Lo que hace un solo prompt
Cuatro frases, escritas una tras otra en el mismo panel, en un solo proyecto. Nada de lo de abajo se preparó a mano.
Instalar e iniciar sesión
En QGIS, abre Plugins -> Manage and Install Plugins, busca AI Agent y haz clic en Install. Funciona en QGIS 3.28 y posteriores, QGIS 4 incluido, en Windows, macOS y Linux.
Abre el panel desde la barra de herramientas de TerraLab y haz clic en Sign in / Sign up. Tu navegador se abre, creas una cuenta y el plugin se conecta por sí solo. Sin clave de API, sin tarjeta de crédito, ejecuciones gratuitas para empezar.
Tu primera ejecución
Describe el resultado, no el procedimiento
"Colorea los edificios por altura" es un prompt mejor que "abre las propiedades, elige un renderizador graduado, selecciona el campo de altura". El agente lee el proyecto antes de actuar, así que nombrar layers, campos y rutas suele ser escribir de más.
Lee los pasos, no solo la respuesta
Una línea gris bajo tu mensaje cuenta el trabajo: 4 steps, 39.6s. Despliégala y ahí está cada llamada a herramienta con sus argumentos y lo que devolvió. Así es como distingues un buen resultado de uno plausible.
Responde cuando pregunte
Una ejecución puede detenerse en una pequeña tarjeta con dos a cuatro opciones. La nuestra preguntó dos veces: la vista contenía 6.355 features de OSM, y solo 117 de 3.124 edificios llevaban una etiqueta de altura. Ambas fueron bifurcaciones reales del trabajo, y las dos quedan visibles en la traza después.
Revisa qué cambió
Unos chips bajo la respuesta nombran las layers que la ejecución creó o tocó. Haz clic en uno para el menú habitual de QGIS: mostrar en el panel de Layers, hacer zoom a ella, abrir la tabla de atributos, propiedades de la layer.
Un prompt es una ejecución, sean cuales sean los pasos de QGIS que requiera. Una ejecución se detiene sola a las 60 llamadas a herramientas o a los 40 minutos, así que una tarea que se ha torcido no puede correr para siempre.
Lo que alcanza
Datos. Archivos locales, archivos remotos, WFS, WMS, XYZ, STAC e imágenes COG, extractos de OpenStreetMap, geocodificación, cálculo de rutas. Suelta un GeoPackage en el panel y se carga como layer.
Análisis. Cualquier algoritmo de Processing, con los nombres de parámetros y los problemas conocidos consultados en lugar de adivinados. Buffers, joins, estadísticas zonales, comprobaciones de topología, isócronas a partir de vías de OSM, perfiles de elevación a lo largo de una línea.
Cartografía. Simbología, renderizadores categorizados y graduados, etiquetas, layouts de impresión con un mapa, una leyenda, una escala gráfica y una flecha de norte, y luego una exportación a PDF o PNG.
Edición. Añadir, actualizar y eliminar features, reparación de geometría, edición de vértices, fusiones y divisiones, dentro de una sesión de edición real de QGIS que puedes revertir.
Respuestas. Dónde vive un ajuste de QGIS y cómo hacer algo a mano, a partir de la documentación oficial de QGIS, con el enlace. Pregunta cómo arreglar geometrías inválidas y obtienes una respuesta, no una ejecución.
Si AI Edit o AI Segmentation están instalados, el agente también los maneja: transforma imágenes a partir de un prompt, o vectoriza cada instancia de un objeto dentro de una zona.
Revisa su propio trabajo
En el nivel Medium de esfuerzo y superiores, el agente renderiza el mapa y mira lo que produjo. En la ejecución del layout hizo justo eso, decidió que el resultado no era legible, y corrigió el orden de dibujo antes de terminar.
Eso es el comportamiento que merece atención, en ambos sentidos. Informó de que solo 186 de 3.124 edificios tenían una altura utilizable en lugar de estilizar en silencio un campo lleno de nulos. También puede equivocarse con total confianza, así que la traza sigue siendo lo que hay que leer.
Mantener el control
Tres cosas se sitúan entre el modelo y tu proyecto.
El chip de permisos, junto al + en el compositor, decide cuándo se detiene a preguntar.
| Nivel | Pregunta antes de |
|---|---|
| Ask first | Cada cambio |
| Balanced (por defecto) | Eliminar y sobrescribir |
| Autopilot | Nada, salvo gastar créditos y ejecutar Python |
Autopilot es una elección de sesión: un reinicio de QGIS vuelve a Balanced, sea cual sea el nivel que elegiste la última vez. Dos cosas siempre preguntan, en todos los niveles: cualquier cosa que gaste créditos, y ejecutar Python en bruto, que ves antes de que se ejecute.
La tarjeta de aprobación es el aspecto que tiene preguntar. Una frase que dice lo que está a punto de pasar, tu respuesta, y se reduce a una sola línea una vez decidida, así una ejecución larga sigue siendo legible.
Deshacer. Cada ejecución deja un punto de control. La flecha en la cabecera del panel abre la lista, la más reciente primero, con la fila en la que está tu proyecto marcada.
Elige una fila y el proyecto vuelve a ese punto. La restauración captura primero el estado que deja, así que ella misma puede deshacerse, y Ctrl+Alt+Z retrocede un paso sin abrir nada. Los puntos de control se anclan a ejecuciones, no a llamadas a herramientas individuales.
Darle el contexto correcto
El agente ya lee el proyecto: nombres de layers, tipos, CRS, número de features, nombres de campos, extensiones, el lienzo, tu selección. Lo que añades es lo que no puede ver.
- Adjunta una foto o un archivo de datos, o una layer de este proyecto.
- Arrastra una layer directamente desde el panel de Layers de QGIS hasta el panel.
- Suelta archivos en cualquier parte del panel: los datos se cargan como layer, las imágenes van al modelo.
- Escribe
@para nombrar una fuente de datos o uno de tus plugins de QGIS instalados dentro del mensaje.
Cada proyecto conserva sus propios chats. La lupa en la cabecera los busca por título y por texto del mensaje, y un chat se exporta como Markdown.
Los dos ajustes que vale la pena cambiar
Effort, el chip antes de Send, no es un selector de modelo. Nombra cuánto razonamiento estás comprando.
| Nivel | Qué hace | Plan |
|---|---|---|
| Instant | Empieza a trabajar lo más rápido posible. No planifica ni investiga | Free |
| Medium | Planifica, revisa sus resultados, consulta algoritmos y documentación | Pro |
| High | Planificación más profunda, investigación y dirección independiente en tareas difíciles | Pro |
Instant es lo indicado para "en qué CRS está este proyecto" y para un solo cambio de estilo. Medium produjo cada ejecución de esta guía, preguntas y autorrevisiones incluidas. High es para la tarea para la que de otro modo habrías bloqueado una tarde entera.
Connectors, la primera página de Settings, decide de dónde vienen los datos. Treinta y nueve fuentes, diez activas por defecto: OpenStreetMap, Overture, Natural Earth, NASA, Copernicus, el Planetary Computer, las agencias cartográficas nacionales, y más. Cada una indica lo que necesita antes de que la actives, y la mayoría no necesita nada en absoluto.
Tus plugins de QGIS instalados obtienen filas en la misma página, así el agente puede acceder a ellos por su nombre.
Personalisation es la otra página que vale la pena visitar. Cómo debe llamarte la AI, a qué te dedicas, un párrafo sobre tu trabajo, instrucciones permanentes, tu experiencia en GIS, sistema métrico o imperial, cómo deben nombrarse las nuevas layers, y las notas que conserva entre chats.
Lo que sale de tu máquina
Cada mensaje va a nuestro servicio alojado. Lo que viaja: tu solicitud, una descripción del proyecto (CRS, extensión, y por layer el nombre, el tipo, el tipo de geometría, la visibilidad, el número de features, los nombres de campos y la extensión, además de una fila de muestra de la layer activa), la ruta del archivo de proyecto, tus ejecuciones recientes de Processing, las advertencias más nuevas de QGIS, y lo que hayas adjuntado.
Lo que no: el contenido de tus archivos ráster y vectoriales, tu propio archivo de proyecto, las geometrías de las features, tablas de atributos completas, y cualquier proyecto sobre el que no hayas preguntado. Tu clave de activación nunca aparece en un resultado de herramienta, y las contraseñas de base de datos dentro de las URI de layers se eliminan de cada resultado y traceback.
Free vs Pro
Free te da 10 ejecuciones al mes, en el modelo rápido, con todas las herramientas, todos los conectores y todos los plugins de QGIS, para uso personal. Pro son 250 ejecuciones al mes por 49 EUR: el modelo Pro en tareas difíciles, esfuerzo Medium y High, memoria e instrucciones permanentes, ejecuciones más largas, uso comercial.
Nada se mide por llamada a herramienta. La ejecución de 60 pasos y la de 3 pasos cuestan lo mismo.
Preguntas
¿Puede romper mi proyecto?
Lo cambia, que es justo el objetivo, y el cambio es reversible. Balanced pregunta antes de cualquier cosa destructiva, y el punto de control de la ejecución devuelve el proyecto a su sitio incluso después de que hayas aprobado algo que no deberías. Guarda tu proyecto antes de una sesión larga de todos modos, igual que harías antes de cualquier tanda de ediciones.
¿Escribe Python en mi QGIS?
Puede ejecutar Python cuando una tarea lo necesita, y eso es lo único que pregunta todos los niveles, Autopilot incluido. Ves el código antes de que se ejecute.
¿Qué pasa cuando se equivoca?
Es un modelo de lenguaje, así que puede equivocarse, y con total confianza. Para eso está el bloque de actividad: despliégalo, mira los argumentos que eligió y los recuentos que devolvió. Nuestra propia ejecución dijo que solo 186 de 3.124 edificios tenían una altura utilizable, que es el tipo de línea que vale la pena leer antes de confiar en el mapa.
¿Cuánto tarda una ejecución?
Segundos para una pregunta, minutos para trabajo real. En esta guía: 43 segundos para el mapa base, 6 minutos 30 para los edificios y su rampa de altura, 2 minutos 37 para el layout, menos de un minuto para cada pregunta. QGIS sigue siendo utilizable mientras corre una descarga.
¿Funciona sin conexión?
No. No hay modelo local ni modo sin conexión. El plugin corre en tu máquina, el modelo corre en la nuestra.
¿Se usan mis datos para entrenar un modelo?
No. El servicio planifica los pasos de QGIS, y nada más.
¿Es de código abierto?
El plugin lo es, bajo GPL-2.0-or-later: el ejecutor de herramientas, el modelo de permisos, las protecciones de archivos y red, el panel. Así que lo que corre en tu ordenador se puede auditar por completo. El servicio alojado, su prompt y el catálogo de datos abiertos no lo son.
Qué recordar
Describe el resultado, no el procedimiento. El agente lee el proyecto primero, así que nombrar layers y rutas suele ser escribir de más.
Un prompt es una ejecución, cueste lo que cueste en pasos, y se detiene sola a las 60 llamadas a herramientas o a los 40 minutos.
El bloque de actividad es el producto. Desplegarlo es cómo distingues un buen resultado de uno plausible.
Cada ejecución deja un punto de control, y una restauración puede deshacerse a su vez, así que aprobar algo de lo que te arrepientes no es un callejón sin salida.
El esfuerzo compra planificación y revisión, no una personalidad distinta. Instant responde, Medium trabaja y verifica, High piensa primero.
Los conectores deciden qué datos puede encontrar. Activar tu agencia cartográfica nacional vale más que cualquier redacción de prompt.
