Pular para o conteúdo
AI Agent
QGIS
Guia

Agente de IA no QGIS: o que é e qual plugin usar

Publicado em

Um agente de IA no QGIS é um plugin que recebe uma tarefa escrita em linguagem natural e a executa no projeto que você tem aberto. Ele lê suas camadas, planeja as etapas, roda as mesmas ferramentas do QGIS que você clicaria, confere o resultado e conta o que fez. A diferença para um chatbot é que o agente age no seu projeto, em vez de entregar instruções para você seguir.

O QGIS com um painel de agente de IA acoplado à direita. O mapa mostra áreas laranja na periferia de Pune sobre um mapa base cinza claro. O painel informa que cerca de 46.363 pessoas vivem nelas, segundo a grade de população GHSL 2025, mostra o GeoPackage salvo, as camadas adicionadas, 14 fontes e 32 ações, depois um novo pedido para apagar as camadas de trabalho e a resposta de que 11 camadas de trabalho foram removidas e as áreas laranja conferidas no mapa.
Uma pergunta, um mapa: as partes de Pune a mais de 2 km de um hospital, encontradas, medidas e mapeadas por um agente dentro do QGIS.

A Anthropic, que faz os modelos de IA Claude, define agentes da mesma forma em seu guia para criar agentes: “sistemas em que LLMs dirigem dinamicamente seus próprios processos e o uso de ferramentas”. Em palavras simples, a IA decide qual ferramenta rodar em seguida com base no que a anterior devolveu, em vez de seguir um roteiro fixo.

Nós criamos um desses, o AI Agent, então leia esta página sabendo de quem ele é. É um dos 38 plugins de agente que contamos na lista oficial de plugins do QGIS, e os outros 37 também estão abaixo.

Agente, chatbot ou copiloto: qual é a diferença?

As páginas de plugins misturam essas três palavras. Elas descrevem quanto do trabalho o software faz sozinho.

ChatbotCopilotoAgente
O que fazResponde perguntas em textoSugere o próximo passo ou escreve código, e você executaExecuta as etapas sozinho e confere o resultado
Vê seu projetoNãoÀs vezes uma parteSim: camadas, campos, SRC, extensão
Quem clicaVocêVocêO agente, com sua aprovação nas etapas de risco
Exemplo no QGIS“Como calculo o NDVI?” respondido numa aba do navegadorCódigo PyQGIS que você cola no Terminal Python“Calcule o NDVI destes talhões” e a camada aparece, estilizada

Um chatbot é útil e muitas vezes gratuito. Mas ele não enxerga seu projeto, então o código que escreve precisa adivinhar os nomes das suas camadas, e os erros ficam para você corrigir. Medi com que frequência isso dá errado no post sobre PyQGIS.

Como um agente de IA funciona no QGIS

Todo plugin de agente roda alguma versão do mesmo ciclo. As duas últimas etapas separam um bom agente de uma demonstração.

Diagrama do ciclo do agente de IA no QGIS. Um pedido pergunta quais partes da cidade ficam a mais de 2 km de um hospital, com um mapa e a população. Cinco cartões se seguem: 1, lê o projeto, suas camadas, campos, SRC, extensão e seleção, como uma descrição, não seus arquivos; 2, planeja: encontrar hospitais, criar áreas de 2 km, subtrair, somar a grade de população; 3, age com ferramentas, baixando dados, rodando o Processamento e estilizando camadas; 4, confere, lendo de volta cada resultado e olhando o mapa renderizado; 5, pergunta e depois responde, parando antes de apagar ou sobrescrever e relatando números, fontes e cada ação. Uma linha tracejada indica que, se uma conferência falha, ele volta à etapa 2 com o que aprendeu.
O ciclo que todo agente do QGIS executa. Conferir e perguntar tornam o uso seguro em trabalho real.
  1. Ele lê seu projeto. Nomes das camadas, campos, sistema de coordenadas, extensão do mapa e seleção. Um bom agente envia à IA uma descrição do projeto, não seus arquivos de dados.
  2. Ele planeja. Uma tarefa grande vira uma lista curta: encontrar os dados, recortar, calcular, estilizar, relatar.
  3. Ele age por meio de ferramentas. Cada etapa roda uma ferramenta real do QGIS: um algoritmo do Processamento, um estilo de camada, um download de dados, um layout de impressão. Alguns agentes também escrevem e executam Python quando nenhuma ferramenta serve.
  4. Ele confere o próprio trabalho. Lê o que cada ferramenta devolveu, e os melhores olham o mapa renderizado antes de responder.
  5. Ele pergunta antes de mudanças de risco. Apagar uma camada ou sobrescrever um arquivo deveria exigir um clique seu.

Veja o ciclo por dentro. Ao receber o pedido de adicionar as principais vias de Pune e achar a área laranja com mais extensão de vias, o agente primeiro diz quais vias vai usar. Depois roda as ferramentas uma a uma e, quando uma falha, lê o erro e tenta de novo.

Uma conversa com o AI Agent no QGIS. O pedido é adicionar as principais vias de Pune do OpenStreetMap, estilizá-las em cinza fino e contornar a área laranja com mais extensão de vias. O agente responde que vai usar vias do tipo motorway, trunk, primary, secondary e tertiary e comparar a extensão em cada uma das 10 áreas laranja. Abaixo, a lista de ações: Somar comprimentos de linhas marcada como não funcionou, depois Estilo, Mostrar ou ocultar camadas e Somar comprimentos de linhas rodando de novo, aos 32,5 segundos.
Apresenta o plano, age e tenta de novo uma etapa que falhou. Este é o ciclo em ação.

Uma execução, conferida à mão

Dá para confiar nos números de um agente? Fiz ao nosso uma pergunta, num projeto vazio: “Quais partes de Pune, na Índia, ficam a mais de 2 km do hospital mais próximo? Use os hospitais do OpenStreetMap, mapeie essas áreas em laranja sobre um mapa base claro e diga quantas pessoas vivem nelas.” Ele encontrou sozinho os distritos da cidade, 645 hospitais e um mapa de população, e executou 32 ações. Trabalhou por cerca de 3,5 minutos. O resto dos 8 min 37 s foram dois cartões de aprovação esperando por mim.

Depois refiz a análise à mão, na mesma sessão:

MedidaAgenteMinha conferência manualDiferença
Área a mais de 2 km de um hospital107,29 km²107,54 km²0,23%
Pessoas que vivem nela46.36346.3720,02%

Os números se confirmaram. O mapa, no começo, não: depois da última conferência, o agente adicionou por cima uma camada verde que escondia as áreas laranja, enquanto a resposta dizia que elas estavam visíveis. Ele corrigiu quando pedi. Ou seja, um agente que confere o próprio trabalho poupa a maior parte do esforço, e você ainda olha o mapa.

Como medimos. QGIS 3.44.7, AI Agent 1.4.1, configurações padrão, 26 de setembro de 2026. Na conferência manual, tracei círculos de 2 km ao redor dos mesmos 645 hospitais, subtraí-os dos 41 distritos da cidade e somei a grade de população dentro deles com as estatísticas zonais do QGIS.

A mesma pergunta funciona no seu QGIS, com a sua cidade: instale o plugin, entre na conta e cole a pergunta no painel.

Experimente o AI Agent grátis no QGIS, sem cartão

Para que as pessoas usam agentes no QGIS

Um agente serve para tarefas com muitas etapas pequenas que você já sabe fazer, em que o tempo vai embora em cliques e pesquisas:

  • Encontrar dados abertos de um lugar, conferir a licença e carregá-los já estilizados.
  • Calcular um índice a partir de imagens de satélite, como o NDVI ou um mapa de severidade de queimadas.
  • Rodar uma cadeia de ferramentas do Processamento, como buffer, recorte, dissolver e contagem, e entregar os números.
  • Montar um layout de impressão com legenda, barra de escala e seta de norte, e exportar um PDF.
  • Resolver os problemas do dia a dia: uma camada no SRC errado, geometria inválida, um CSV que não vira mapa.

O guia do AI Agent percorre dez execuções reais desse tipo, cada uma com o prompt exato e o tempo que levou.

Contamos todos os plugins de agente de IA para QGIS

Ninguém tinha contado esses plugins. Em 26 de setembro de 2026, percorremos a lista oficial de plugins do QGIS e ficamos com todo plugin em que um modelo de linguagem de IA age no QGIS ou responde sobre o seu projeto. São 38.

38

plugins de agente e assistente

58%

publicados pela primeira vez em 2026

47%

exigem sua própria chave de API

21%

são pontes MCP para um app externo

Vinte e dois dos 38 surgiram em 2026. Vinte e três já funcionam com o QGIS 4, e nove são marcados como experimentais pelos próprios autores. Uma chave de API, na tabela abaixo, é uma senha pessoal que você compra de uma empresa de IA como a OpenAI e cola no plugin; MCP é uma forma de um app de IA externo controlar o QGIS.

Os mais baixados:

PluginAutorDownloadsComo obtém um modeloOnde você conversa
QChatGPTKIOS Research Center97.949Sua chave da OpenAIPainel no QGIS
QGIS MCPNicolas Karasiak52.575Seu próprio app de IAFora do QGIS, num cliente MCP
AutonomousGIS Spatial Analysis AgentAkinboyewa, Li, Ning, Lessani21.783Sua chave de APIPainel no QGIS
Ainoaino.world21.032Não informadoPainel no QGIS
KueBunting Labs15.892Conta do fornecedorPainel no QGIS
OpenGeoAgentQiusheng Wu9.853Sua chave, ou um modelo localPainel no QGIS
Geo Knowledge AIphoenix-gis9.794Hospedado pelo fornecedorPainel no QGIS

Plugins antigos acumulam mais downloads, então o ranking diz mais sobre a idade do que sobre a qualidade. O QChatGPT, no topo, não é atualizado desde julho de 2023. O agente AutonomousGIS vem de uma equipe de pesquisa que o testou em mais de 100 tarefas de análise: confiável nas básicas e intermediárias, menos nas complexas. O OpenGeoAgent é de Qiusheng Wu, amigo nosso, cujo plugin GeoAI, gratuito, é a referência em modelos de imagem no QGIS.

Como contamos. Lemos a lista oficial de plugins do QGIS 3.44 e 4.0 em 26 de setembro de 2026, buscamos palavras como agent, LLM, MCP, chatbot e assistant e depois lemos a página de cada plugin. Ficamos só com os plugins em que um modelo de linguagem age no QGIS ou responde sobre ele.

Três formas de um agente obter seu modelo

Pergunte primeiro de onde vem o modelo de IA. Isso define a configuração, a conta a pagar e para onde vão seus pedidos.

ConfiguraçãoComo funcionaVantagemAtenção a
Sua própria chave de APICole uma chave da OpenAI, Anthropic ou Gemini no pluginEscolha qualquer modelo e pague direto ao provedorUma cobrança separada por token e uma chave para proteger
Uma conta do fornecedorEntre na conta e o fornecedor roda o modeloNada para configurar, uma só assinaturaSeus prompts vão para esse fornecedor
Uma ponte MCPO plugin abre um soquete local e um app externo, como o Claude Desktop, controla o QGISUse o app de IA que você já pagaVárias peças para instalar e iniciar, e a conversa fica fora do QGIS
Um modelo localO modelo roda na sua máquina por meio do Ollama ou similarNada sai do computadorModelos locais pequenos planejam mal trabalhos de geoprocessamento com várias etapas, e você precisa do hardware

O caminho do MCP recebe mais buscas e tem a configuração mais difícil, por isso ganhou uma página própria.

Os riscos e como avaliar um agente

Um agente que age também pode agir errado. O principal risco no QGIS é o Python: muitos agentes escrevem e executam código quando nenhuma ferramenta serve, e o Python dentro do QGIS pode alterar ou apagar qualquer arquivo do seu computador.

Equipes de segurança levam isso a sério. A equipe de segurança de IA da NVIDIA encontrou uma falha desse tipo, a CVE-2024-12366, e concluiu que executar código escrito por IA em um ambiente isolado “é essencial” (NVIDIA, 2025). Um plugin da nossa contagem diz no próprio README que sua ferramenta de Python “auto-runs (no per-step confirmation)”, ou seja, executa sozinha, sem confirmação a cada etapa.

Antes de deixar qualquer agente chegar perto de um projeto de cliente, confiro cinco coisas:

  1. Ele pergunta antes de apagar ou sobrescrever? Peça “apague as camadas que você criou” e veja se ele para.
  2. Dá para desfazer uma mensagem inteira? O desfazer do próprio QGIS cobre edições, não camadas adicionadas nem arquivos gravados.
  3. Ele mostra cada ação que executou? Você precisa poder auditar o que aconteceu.
  4. O que sai da sua máquina? Uma descrição do projeto ou os seus dados de verdade?
  5. Quanto custa um dia pesado? A cobrança por token na sua própria chave não tem teto, a menos que você defina um.

Assim é a primeira conferência quando o agente passa. Pedi ao nosso agente que apagasse as camadas de trabalho que ele tinha criado, e ele parou com a lista das onze remoções antes de mexer em qualquer coisa.

Um cartão de aprovação do AI Agent no QGIS com o texto 11 ações aguardam sua aprovação, seguido da lista de camadas a remover, como hospitais do OSM perto de Pune e distritos eleitorais de Pune 2025, com os botões Editar valores, Negar e Permitir.
Ao receber o pedido de apagar camadas, o agente lista cada remoção e espera o Permitir.

O ArcGIS tem um agente de IA?

A Esri, empresa por trás do ArcGIS, oferece cerca de dez pequenos assistentes de IA, a maioria em beta, cada um para um produto como o StoryMaps ou o Survey123. O assistente do ArcGIS Pro era só por convite em janeiro de 2026 e abriu como beta para usuários pagantes do ArcGIS Online em maio. O QGIS foi no sentido oposto: dezenas de plugins da comunidade, a maioria gratuita, vários deles agentes que executam tarefas inteiras. O comparativo entre QGIS e ArcGIS cobre o resto.

Qual agente de IA usar no QGIS?

Depende de onde você quer conversar, de quem paga pela IA e de seus dados poderem ou não sair do seu computador. Eu escolheria assim:

Se você querVejaPor quê
O resultado no seu projeto, sem configurar nadaAI Agent (o nosso)Um só plugin, com o modelo incluído, pergunta antes das etapas de risco, desfazer com um clique por mensagem
O QGIS como mais uma ferramenta no Claude Code ou no CursorQGIS MCPGratuito, usa o plano de IA que você já paga, mais configuração
Nada saindo do seu computadorOpenGeoAgent com um modelo localRoda pelo Ollama; conte com uma GPU forte, pois modelos pequenos sofrem com trabalhos de várias etapas
Sua própria chave da OpenAI ou da AnthropicAutonomousGIS ou OpenGeoAgentPague o provedor por token e escolha qualquer modelo
Avaliação de nível acadêmicoAutonomousGISTestado em mais de 100 tarefas num artigo publicado

A maioria dos usuários de SIG com quem converso quer a primeira linha: digitar a tarefa e receber a camada. Desenvolvedores que já vivem num editor de código costumam preferir a segunda.

Como testar um agente de IA no QGIS

Todo plugin do levantamento se instala do mesmo jeito: Complementos > Gerenciar e Instalar Complementos, procure pelo nome e clique em Instalar complemento.

O agente que nós criamos

Nós criamos o AI Agent, então esta parte fala do nosso próprio plugin. É um painel de conversa dentro do QGIS com a IA incluída: você entra na conta uma vez, sem chave de API e sem app extra. Ele pergunta antes de apagar ou sobrescrever, lista cada ação sob cada resposta e salva uma versão do seu projeto a cada mensagem.

O painel do AI Agent no QGIS com a folha Versões deste projeto aberta. Está escrito Voltar nunca apaga nada, e a folha lista cada mensagem com há quanto tempo foi executada e um link Desfazer, além de Desfazer tudo nesta conversa. Um aviso sob cada item cita uma camada que não volta, como um GeoPackage exportado.
Cada mensagem é uma versão do projeto para a qual você pode voltar.

Voltar restaura as camadas e os estilos do projeto e avisa o que não consegue restaurar, como um arquivo já salvo em disco.

Ele envia uma descrição do seu projeto (nomes das camadas, campos, sistema de coordenadas, extensão), nunca seus arquivos de dados, para um serviço hospedado na UE. Há um plano Free, sem cartão, e uma mensagem conta como uma tarefa, não importa quantas etapas ela leve.

Experimente o AI Agent grátis no QGIS, sem cartão

O que lembrar

Um agente de IA no QGIS recebe uma tarefa em linguagem natural e a executa no seu projeto: lê o projeto, planeja, roda ferramentas do QGIS, confere o resultado e pergunta antes de mudanças de risco.

Um chatbot responde e um copiloto sugere. Só um agente faz os cliques, então suas configurações de segurança importam tanto quanto seu modelo de IA.

Em 26 de setembro de 2026, o repositório oficial do QGIS tinha 38 plugins de agente e assistente. 58% foram publicados pela primeira vez em 2026, 47% exigem sua própria chave de API e 21% são pontes MCP para um app de IA externo.

Antes de confiar em um, confira se ele pergunta antes de apagar, se uma mensagem inteira pode ser desfeita, se mostra cada ação e quais dados saem da sua máquina.

O nosso, o AI Agent, respondeu a uma pergunta sobre acesso a hospitais em Pune com 0,23% de diferença em relação à conferência manual, perguntou antes de apagar camadas e guarda uma versão do projeto por mensagem.

Perguntas frequentes

Existe agente de IA para QGIS?

Sim, vários. Em 26 de setembro de 2026, a lista oficial de plugins tinha 38 plugins em que um modelo de IA age no QGIS ou responde sobre o seu projeto. Alguns exigem sua própria chave da OpenAI ou da Anthropic, outros uma conta do fornecedor, e outros deixam um app externo, como o Claude Desktop, controlar o QGIS. O nosso, o AI Agent, inclui a IA e tem um plano Free.

Qual é a diferença entre um agente de IA e um chatbot?

Um chatbot responde em texto e você faz o trabalho. Um agente executa a tarefa: planeja as etapas, roda ferramentas no seu software, confere o que aconteceu e relata. No QGIS, um chatbot explica como calcular o NDVI, e um agente adiciona a camada de NDVI ao seu mapa.

O ChatGPT consegue controlar o QGIS?

Sozinho, não. O ChatGPT pode escrever código PyQGIS para você colar no Terminal Python do QGIS, mas não age no seu projeto. Ele também não consegue se conectar ao QGIS MCP rodando no seu computador: a central de ajuda da OpenAI diz que o ChatGPT só alcança servidores MCP na internet. Um plugin de agente dentro do QGIS age diretamente no projeto.

Preciso de chave de API para usar um agente de IA no QGIS?

Depende do plugin. Quase metade dos 38 que contamos exige sua própria chave da OpenAI, Anthropic, Google ou OpenRouter, cobrada por uso por esse provedor. Outros usam uma conta do fornecedor com o modelo incluído, e alguns rodam um modelo local na sua máquina.

É seguro deixar um agente de IA rodar Python no QGIS?

O Python no QGIS pode ler, alterar ou apagar qualquer arquivo do seu computador, então um agente que executa código sem perguntar é um risco real. Use um que pergunte antes de rodar código que altera seu projeto, mostre cada ação feita e permita desfazer uma mensagem inteira. Mantenha backup de tudo que for insubstituível.

Um agente de IA funciona com o QGIS 4?

Muitos, sim: 23 dos 38 plugins de agente que contamos constavam como compatíveis com o QGIS 4 em 26 de setembro de 2026. Confira a página do plugin no repositório, onde aparece a versão máxima do QGIS suportada.

Para testar um agente agora, o AI Agent se instala pelo gerenciador de complementos do QGIS e tem um plano Free. Se o caminho do MCP interessa a você, o que é QGIS MCP explica a configuração e os limites. O guia do AI Agent traz dez execuções reais com seus prompts, o que é GeoAI trata dos modelos de imagem que detectam objetos, e os melhores plugins de IA para QGIS e o hub de IA para QGIS comparam o campo mais amplo.