AI Agent no QGIS: guia completo

O AI Agent é um painel de chat dentro do . Você escreve a tarefa, e ele trabalha no projeto que você já tem aberto, com seus layers, seu CRS, sua seleção e a extensão em tela. Nós desenvolvemos a ferramenta, então este guia fala sobre o nosso próprio produto.

Ele aborda sua primeira execução, o que o agente alcança, os dois chips que decidem seu comportamento, e como desfazer uma execução que você não queria.

O que um prompt faz

Quatro frases, digitadas uma após a outra no mesmo painel, em um único projeto. Nada abaixo foi preparado à mão.

Instalar e entrar

No QGIS, abra Plugins -> Manage and Install Plugins, pesquise por AI Agent e clique em Install. Ele funciona no QGIS 3.28 e posterior, QGIS 4 incluso, em Windows, macOS e Linux.

Abra o painel pela barra de ferramentas da TerraLab e clique em Sign in / Sign up. Seu navegador é aberto, você cria uma conta, e o plugin se conecta sozinho. Sem chave de API, sem cartão de crédito, execuções gratuitas para começar.

Sua primeira execução

Um prompt é uma execução, não importa quantos passos do QGIS ela leve. Uma execução para sozinha em 60 chamadas de ferramenta ou 40 minutos, então uma tarefa que saiu do rumo não pode rodar para sempre.

O que ele alcança

Dados. Arquivos locais, arquivos remotos, WFS, WMS, XYZ, imagens STAC e COG, extrações do OpenStreetMap, geocodificação, roteamento. Solte um GeoPackage no painel e ele carrega como um layer.

Análise. Qualquer algoritmo do Processing, com os nomes dos parâmetros e as armadilhas conhecidas consultados em vez de adivinhados. Buffers, joins, estatísticas zonais, checagens de topologia, isócronas a partir de vias do OSM, perfis de elevação ao longo de uma linha.

Cartografia. Simbologia, renderizadores categorizados e graduados, rótulos, layouts de impressão com um mapa, uma legenda, uma escala gráfica e uma rosa dos ventos, depois uma exportação para PDF ou PNG.

Edição. Adicionar, atualizar e excluir feições, reparo de geometria, edição de vértices, uniões e divisões, dentro de uma sessão de edição real do QGIS que você pode reverter.

Respostas. Onde vive uma configuração do QGIS e como fazer algo manualmente, a partir da documentação oficial do QGIS, com o link. Pergunte como corrigir geometrias inválidas e você recebe uma resposta, não uma execução.

Se o AI Edit ou o AI Segmentation estiver instalado, o agente também os conduz: transformar imagens a partir de um prompt, ou vetorizar cada instância de um objeto dentro de uma zona.

Ele confere o próprio trabalho

No nível de esforço Medium e acima, o agente renderiza o mapa e observa o que produziu. Na execução do layout foi exatamente isso que aconteceu: ele decidiu que o resultado não estava legível e corrigiu a ordem de desenho antes de terminar.

É esse o comportamento que vale a pena observar, nas duas direções. Ele relatou que apenas 186 dos 3.124 edifícios tinham uma altura utilizável em vez de silenciosamente estilizar um campo cheio de nulos. Ele também pode errar com confiança, então o rastro continua sendo o que vale a pena ler.

Mantendo o controle

Três coisas ficam entre o modelo e seu projeto.

O chip de permissão, ao lado do + no compositor, decide quando ele para para perguntar.

Autopilot é uma escolha da sessão: reiniciar o QGIS volta para Balanced, independentemente do que foi escolhido da última vez. Duas coisas sempre perguntam, em todos os níveis: qualquer coisa que gaste créditos, e a execução de Python bruto, que você vê antes de rodar.

O cartão de aprovação é a cara que essa pergunta assume. Uma frase dizendo o que está prestes a acontecer, sua resposta, e ele se recolhe a uma única linha assim que decidido, para que uma execução longa continue legível.

Desfazer. Cada execução deixa um checkpoint. A seta no cabeçalho do painel abre a lista, mais recente primeiro, com a linha em que seu projeto está marcada.

Escolha uma linha e o projeto volta a ela. A restauração captura primeiro o estado que deixa para trás, então ela própria pode ser desfeita, e Ctrl+Alt+Z retrocede um passo sem abrir nada. Checkpoints são ancorados em execuções, não em chamadas de ferramenta isoladas.

Dando o contexto certo

O agente já lê o projeto: nomes de layers, tipos, CRS, contagens de feições, nomes de campos, extensões, o canvas, sua seleção. O que você adiciona é o que ele não consegue ver.

• Anexe uma foto ou um arquivo de dados, ou um layer deste projeto.
• Arraste um layer diretamente do painel Layers do QGIS para o painel.
• Solte arquivos em qualquer lugar do painel: dados carregam como layer, imagens vão para o modelo.
• Digite @ para nomear uma fonte de dados ou um dos seus plugins QGIS instalados dentro da mensagem.

Cada projeto mantém seus próprios chats. A lupa no cabeçalho os pesquisa por título e por texto da mensagem, e um chat é exportado como Markdown.

As duas configurações que valem a pena mudar

Effort, o chip antes de Send, não é um seletor de modelo. Ele nomeia quanto raciocínio você está comprando.

Instant é certo para "em que CRS está este projeto" e para uma única alteração de estilo. Medium produziu cada execução deste guia, incluindo perguntas e autoconferências. High é para a tarefa que, de outro modo, você teria bloqueado uma tarde inteira para fazer.

Connectors, a primeira página das Settings, decide de onde vêm os dados. Trinta e nove fontes, dez ativadas por padrão: OpenStreetMap, Overture, Natural Earth, NASA, Copernicus, o Planetary Computer, as agências de mapeamento nacionais, e mais. Cada uma informa o que precisa antes de você ativá-la, e a maioria não precisa de nada.

Seus plugins QGIS instalados ganham linhas na mesma página, então o agente pode alcançá-los pelo nome.

Personalisation é a outra página que vale a pena visitar. Como a IA deve chamá-lo, o que você faz, um parágrafo sobre seu trabalho, instruções permanentes, sua experiência em SIG, métrico ou imperial, como novos layers devem ser nomeados, e as anotações que ela mantém entre chats.

O que sai da sua máquina

Cada mensagem vai para o nosso serviço hospedado. O que viaja: sua solicitação, uma descrição do projeto (CRS, extensão e, por layer, o nome, tipo, tipo de geometria, visibilidade, contagem de feições, nomes de campos e extensão, além de uma linha de amostra do layer ativo), o caminho do arquivo do projeto, suas execuções recentes do Processing, os avisos mais recentes do QGIS, e o que você anexou.

O que não sai: o conteúdo dos seus arquivos raster e vetoriais, o próprio arquivo do projeto, geometrias das feições, tabelas de atributos inteiras, e qualquer projeto sobre o qual você não perguntou. Sua chave de ativação nunca aparece em um resultado de ferramenta, e senhas de banco de dados dentro de URIs de layer são removidas de todo resultado e traceback.

Free vs Pro

O Free dá 10 execuções por mês, no modelo rápido, com todas as ferramentas, todos os connectors e todos os plugins QGIS, para uso pessoal. O Pro é 250 execuções por mês por 49 EUR: o modelo Pro em tarefas difíceis, esforço Medium e High, memória e instruções permanentes, execuções mais longas, uso comercial.

Nada é medido por chamada de ferramenta. A execução de 60 passos e a de 3 passos custam o mesmo.

Perguntas

Ele pode quebrar meu projeto?

Ele o altera, que é o propósito, e a alteração é reversível. O Balanced pergunta antes de qualquer coisa destrutiva, e o checkpoint da execução devolve o projeto mesmo depois de você ter aprovado algo que não devia. Salve seu projeto antes de uma sessão longa de qualquer forma, como faria antes de qualquer lote de edições.

Ele escreve Python no meu QGIS?

Ele pode executar Python quando uma tarefa precisa disso, e essa é a única coisa sobre a qual todo nível pergunta, Autopilot incluído. Você vê o código antes de ele rodar.

O que acontece quando ele erra?

É um modelo de linguagem, então ele pode errar, e com confiança. É para isso que serve o bloco de atividade: abra-o, olhe os argumentos que ele escolheu e as contagens que voltaram. A nossa própria execução disse que apenas 186 dos 3.124 edifícios tinham uma altura utilizável, que é o tipo de linha que vale a pena ler antes de confiar no mapa.

Quanto tempo leva uma execução?

Segundos para uma pergunta, minutos para trabalho de verdade. Neste guia: 43 segundos para o basemap, 6 minutos e 30 para os edifícios e sua rampa de altura, 2 minutos e 37 para o layout, menos de um minuto para cada pergunta. O QGIS continua utilizável enquanto uma busca roda.

Ele funciona offline?

Não. Não há modelo local nem modo offline. O plugin roda na sua máquina, o modelo roda na nossa.

Meus dados são usados para treinar um modelo?

Não. O serviço planeja os passos do QGIS, e nada mais.

É código aberto?

O plugin é, sob GPL-2.0-or-later: o executor de ferramentas, o modelo de permissões, as proteções de arquivo e rede, o painel. Então o que roda no seu computador é auditável por completo. O serviço hospedado, seu prompt e o catálogo de dados abertos não são.

O que lembrar

Descreva o resultado, não o procedimento. O agente lê o projeto primeiro, então nomear layers e caminhos costuma ser digitação desperdiçada.

Um prompt é uma execução, não importa quantos passos custe, e ela se interrompe sozinha em 60 chamadas de ferramenta ou 40 minutos.

O bloco de atividade é o produto. Abri-lo é como você distingue um bom resultado de um resultado plausível.

Cada execução deixa um checkpoint, e uma restauração pode ela própria ser desfeita, então aprovar algo do qual você se arrepende não é um beco sem saída.

O Effort compra planejamento e conferência, não uma personalidade diferente. Instant responde, Medium trabalha e verifica, High pensa primeiro.

Os connectors decidem que dados ele consegue encontrar. Ativar a agência de mapeamento do seu país vale mais do que qualquer texto de prompt.

See plans and pricing