AI Chat tutorial

Prerequisites

The following prerequisites should be met before starting this tutorial:

• This tutorial will take approximately ~30 minutes.
• This tutorial relies on base knowledge about the editor interface. If you have not yet followed the tutorials related to those subjects please do so first.
• This tutorial can be followed with any project but is designed in the Demo Dxf Import project. 

Preparations

Take the following steps as preparation for following this tutorial:

• Start the Demo Dxf Import project.

Introduction AI Agents

In the Editor you can interact with several predefined AI Agents via Chat Channels. This tutorial will give you some basic examples of how to interact with them, displaying all functionality. Note that with AI correct answers are not guaranteed!

Wiki Assistant

This agent can only help you with basic functionality of the Tygron Platform. To open it in the Editor go to:

Editor → Community (Ribbon tab) → Chats (Ribbon bar) → Wiki Assistant (Dropdown)

Location of Chats in the Community Ribbon of the Editor.

Asking Questions

With the Wiki Assistant panel opened, select the Chat Box text area in the lower right and type each question below and click on the "Send" button:

What is Heat Stress?

How does the PET formula work?

Can you give a link to the WIKI with a Tutorial?

Note that blue hyperlink can be clicked, each opening a relevant WIKI page in the browser. Feel free to ask the Assistant some additional questions.

Interface Explainer

Next is the Interface explainer:

Go to

Editor → Current Situation (Ribbon tab) → Overlays (Ribbon bar)

Photograph button in red triggers screenshot explanation.

• Select the "Noise Impact Traffic" Overlay in the left side panel.
• Select the "Photograph" button just above the "Send" button.
• This will automatically ask the AI Agent to explain what you are seeing in the interface.
• Feel free to ask some additional questions or take more screenshots.

Item Assistant

• Close the previous chat panel.

"Ask AI" in the right side panel

• Now select the "Ask AI" in the right side panel of your "Noise Impact Traffic" Overlay ID 15 (ignore the pulldown options).
• This will open a new Chat window named "Noise Impact Traffic" which is context aware to the selected Overlay.
• You can ask several question in relation to this Overlay:

What is your Overlay ID?

Rename to "AI Noise"

Disable overlay

Again feel free to ask some additional questions.

Project Coder

Sofar you have been working with the basic WIKI and Items assistants. To do more advanced things like TQL or coding you need the advanced "Project Coder" agent. Go to

Editor → Community (Ribbon tab) → Chats (Ribbon bar) → Project Coder (Dropdown)

• This opens the slower but more advanced model needed for coding.
• Ask it the following questions:

Give me a TQL query for the average value of the overlay with ID 15

Adjust the query to calculate the value per neighborhood

Run the query

Plot this as a bar chart in a Panel and put TQL X-Query statements between []

Update the simulation (click on cloud icon upper left or ask chat):

update simulation

Check the result by opening the newly created panel in the "Panels" menu.

Panel with average noise per neighborhood.

You can also ask the Project Coder to adjust the overlay further:

Set the background noise to 50 for overlay 15

Explain what I am seeing

What is the API endpoint for this overlay?

Create a new COMBO Overlay that takes overlay 15 as input A and adds a value of 1 and name it "More noise"

Drag & Drop

The Agents also support dropping files and using it in the chat.

• Select the wiki page you are currently reading by dragging the URL (in Firefox this can be done via the lock icon next to the URL address bar) and dropping the URL in the chat input field.
• When succesfull "TEXT" will appear next to the field.

Chat panel with TEXT included.

• Ask the AI to:

Summarize

• This can also be done for regular PDF or image files or a GeoJSON endpoint from another project.

Custom Agents (Advanced)

You have sofar been using predefined Tygron Agents. It is also possible to create your own agents with specific instructions.

• Go back to the chat panel, select the Wiki Assistant and click on the "Duplicate" button in the lower left corner.
• This will open channel for "Wiki Assistant (2)".
• Click on "Show Settings" to get access to the Agent's channel settings.

Chat setting panel.

• Here you can edit for example the AI "instructions" and provide it with additional instructions on how do things.
• These instructions can also be shared via the GeoShare with fellow team members working in other projects.
• Hovering of the Tools with your mouse explains the tools functionality.
• You can also adjust other attributes, like for example the temperature controls how creative the agents can be (higher is more creative and more hallucinations, lower is stricter). See Chat Channel for more information on each attribute.

Tutorial completed

Congratulations. You have now completed this tutorial. In it, you have learned how to use the Chat functionality to interact with AI Agents..