CTRL LOGICTesela · User manual

Chapter 10

“Ask the map” assistant

The assistant is a conversation panel inside the viewer. You ask it in plain language about layers, the features they contain or a place, and it answers with what it finds in the system. It is the only part of Tesela that uses artificial intelligence: change detection is mathematical and does not depend on it.

Opening the assistant

  1. On the viewer toolbar, click the “Assistant” button (its help text reads “Ask the map about the layers and analyses”).
  2. Type your question in the “Ask the map…” box and click “Send”. While it answers you will see “Thinking…”.
  3. To start another topic, click “New conversation”. The assistant takes into account only the latest messages of the current conversation.
Assistant panel open in the viewer, with the Ask the map box
“Assistant” panel in the viewer. The welcome text reminds you that it answers with indications, never with determinations.

The button appears only if your profile has the “Use the assistant” permission and the administrator left the “Assistant” option visible for you.

What it can do

The assistant has five tools, deliberately few:

ToolWhat it does
List layersShows the catalog layers that you can see, with their name, type and category.
Count featuresCounts how many features a vector layer has, optionally within a box on the map.
Summarize a fieldSays which values a field has and how many features there are of each; if it is numeric, it also gives the sum, mean, minimum and maximum.
List the fields of a layerSays which fields a layer has and the type of each.
Find a placeLocates a place or a feature by its name.

Useful questions

Ask about what is in the layers. If something is not in the available information, the assistant should say so instead of assuming it. It answers in the language in which you ask.

What it does not do

The assistant can make mistakes, like any language model. Check important figures against the attribute table or the analysis sheet.

If it does not answer

When the assistant cannot answer (for example, because no provider is configured, the key has expired, the quota has run out or there is no connection), you always see the same message: “The request cannot be processed right now. Please contact the administrator.” The provider is not named. The technical detail stays in the server log, available to the administrator.

For the administrator: choosing a provider and key

In the menu, under the “Settings” group, open “AI assistant” (it requires the “Manage the assistant” permission). There you choose the model provider: Claude from Anthropic, ChatGPT from OpenAI or Gemini from Google. Only one can be active at a time.

  1. Choose the provider and enter the “Model” (you can consult the list of models it offers or type the name).
  2. Paste the “API key”. It is stored encrypted on the server and is never shown again: you will only see “saved”.
  3. Click “Test connection”. If it succeeds, click “Turn on”.
  4. Optional, under “Advanced settings”: maximum tokens per response, temperature, service address and assistant instruction. If you leave the instruction empty, the system’s own is used, which already includes the cautious-language rules.

What is asked of the assistant is sent to the chosen provider’s service: the text of the query and what the person has on screen. No data from restricted layers is sent. Keep this in mind when choosing a provider.

Summary