CTRL LOGICTesela · Manual do usuário

Capítulo 10

Assistente “Perguntar ao mapa”

O assistente é um painel de conversa dentro do visualizador. Você pergunta em linguagem corrente sobre as camadas, sobre os elementos que elas contêm ou sobre um lugar, e ele responde com o que encontra no sistema. É a única parte do Tesela que usa inteligência artificial: a detecção de mudanças é matemática e não depende dela.

Abrir o assistente

  1. Na barra de ferramentas do visualizador, clique no botão “Assistente” (sua ajuda diz “Perguntar ao mapa sobre as camadas e as análises”).
  2. Digite sua pergunta na caixa “Pergunte ao mapa…” e clique em “Enviar”. Enquanto ele responde, você verá “Pensando…”.
  3. Para começar outro assunto, clique em “Nova conversa”. O assistente considera apenas as últimas mensagens da conversa em andamento.
Painel Assistente aberto no visualizador, com a caixa Pergunte ao mapa
Painel “Assistente” no visualizador. O texto de boas-vindas lembra que ele responde com indícios, nunca com determinações.

O botão só aparece se o seu perfil tiver a permissão “Usar o assistente” e o administrador tiver deixado a opção “Assistente” visível para você.

O que ele pode fazer

O assistente dispõe de cinco ferramentas, deliberadamente poucas:

FerramentaO que faz
Listar camadasMostra as camadas do catálogo que você pode ver, com seu nome, tipo e categoria.
Contar elementosConta quantos elementos uma camada vetorial tem, opcionalmente dentro de um recorte do mapa.
Resumir um campoInforma quais valores um campo tem e quantos elementos há de cada um; se for numérico, também soma, média, mínimo e máximo.
Listar campos de uma camadaInforma quais campos uma camada tem e de que tipo é cada um.
Buscar um lugarLocaliza um lugar ou um elemento pelo nome.

Perguntas úteis

Pergunte sobre o que está nas camadas. Se algo não estiver na informação disponível, o assistente deve dizê-lo em vez de supor. Ele responde no idioma em que você pergunta.

O que ele não faz

O assistente pode se enganar, como qualquer modelo de linguagem. Confira os números importantes com a tabela de atributos ou com a ficha de análise.

Se ele não responder

Quando o assistente não consegue responder (por exemplo, porque não há provedor configurado, a chave venceu, a cota se esgotou ou não há conexão), você sempre vê a mesma mensagem: “No momento não é possível processar a solicitação. Entre em contato com o administrador.” O provedor não é nomeado. O detalhe técnico fica no registro do servidor, à disposição do administrador.

Para o administrador: escolher provedor e chave

No menu, grupo “Configuração”, abra “Assistente de IA” (exige a permissão “Administrar o assistente”). Ali você escolhe o provedor do modelo: Claude, da Anthropic, ChatGPT, da OpenAI, ou Gemini, do Google. Apenas um pode estar ativo por vez.

  1. Escolha o provedor e informe o “Modelo” (você pode consultar a lista de modelos que ele oferece ou digitar o nome).
  2. Cole a “Chave de API”. Ela é guardada criptografada no servidor e não é exibida novamente: você verá apenas “salva”.
  3. Clique em “Testar conexão”. Se estiver correta, clique em “Ativar”.
  4. Opcional, em “Ajustes avançados”: máximo de tokens por resposta, temperatura, endereço do serviço e instrução do assistente. Se você deixar a instrução vazia, será usada a do sistema, que já inclui as regras de linguagem prudente.

O que se pergunta ao assistente sai para o serviço do provedor escolhido: o texto da consulta e o que a pessoa tiver na tela. Dados de camadas restritas não são enviados. Leve isso em conta ao escolher o provedor.

Resumo