Using the Athos AI Assistant

Athos is the AI assistant built into VRGS. It is a chat panel you can ask questions in plain English: how to use a feature, what a geological concept means, what is in your project database, or what is currently on screen. Athos understands the context of your project and can search your documents, run database queries, and control the 3D view on your behalf.

Athos is cloud-based — it sends your questions to a hosted language model — so it needs an internet connection. See AI & Machine Learning Requirements for connectivity and account details.

Opening Athos

Athos lives in a dockable panel. To show or hide it:

• On the Home ribbon tab, in the Windows group, click Athos.

The panel opens on the side of the VRGS window. Drag its title bar to dock it elsewhere or float it, like any other VRGS panel. Type your question in the box at the bottom and press Enter to send it. Athos streams its reply into the conversation as it is generated.

What you can ask Athos

Athos automatically decides which of its abilities to use based on your question. You do not need to tell it which tool to run.

How-to and help questions

Ask how to do something in VRGS and Athos answers from the built-in user documentation (the same content as this site). This help library ships with VRGS, so these questions work out of the box.

"How do I import an LAS well log?" "Where is the flight path timeline?" "What does the M3C2 comparison tool do?"

Geoscience and literature questions

Athos can answer scientific and geological questions from a literature library of your own papers and reports. This searches a document database attached to your project (see Setting up the literature library below). When no library is attached, Athos still answers from the language model's general knowledge, but it cannot cite your specific papers.

"What controls the geometry of hybrid event beds?" "Summarise the methods used to measure palaeocurrent directions in outcrop."

Questions about your project data

Athos can query your project database and answer in plain language, turning your question into a database query for you. Ask about the objects, measurements, and geometry in the open project.

"How many interpretation objects contain the word sandstone?" "List the dip and azimuth measurements grouped by object."

Driving and describing the 3D view

Athos can move the camera, take a screenshot of the 3D view to reason about what it sees, and describe what is currently displayed.

"What objects are visible right now?" "Centre the view on the model."

Sources and references

When Athos answers from your literature library or the help documentation, it lists the material it drew on under a References heading at the end of the reply. Literature sources are shown with their authors, year, title, and DOI where available; help pages are shown with their title, section, and a link. This lets you trace an answer back to its origin and read further.

Choosing the language model

By default Athos uses a hosted OpenAI model. You can switch the provider at any time from the chat box:

Command	Provider
/switch openai	Hosted OpenAI model (default)
/switch claude	Anthropic Claude
/switch ollama	A local Ollama server running on your own machine

Use /provider to list the available providers. Running models locally with Ollama keeps your prompts on your own hardware, but the quality and speed then depend on the model and machine you run; see AI & Machine Learning Requirements.

Slash commands

Type / in the chat box to see command suggestions. The most useful commands are:

Command	Alias	Action
/help	/h	Show the full command reference
/clear	/c	Clear the chat history
/reset		Reset the conversation context (start a fresh topic)
/stop	/s	Cancel the request Athos is currently working on
/export	/e	Export the chat transcript to a file
/switch		Switch the language model provider, e.g. /switch claude
/provider		List the available providers
/schema		Describe the project database schema
/tables		List the tables in the project database
/sql on | /sql off		Show or hide the database queries Athos runs
/status		Show a system status summary
/version		Show the Athos version

Setting up the literature library

The scientific-literature search (the ability to answer geoscience questions from your papers) works over a small search database stored inside your project, in a folder named RAG_DB:

<project> Data\RAG_DB\rag.db
<project> Data\RAG_DB\rag.faiss

These two files are built ahead of time from a folder of PDF papers and reports using the separate RAG DB Creator tool, then copied into the project's RAG_DB folder. Once they are present, restart VRGS (or reopen the project) and Athos will search them when you ask a geoscience question, citing the matching papers in its References.

note

If the RAG_DB folder is empty, geoscience questions are still answered from the language model's general knowledge, and how-to questions keep working because the help documentation is bundled with VRGS. Only the ability to cite your literature depends on the library being present.

Getting good answers

• Ask one focused question at a time. Follow-up questions keep the context of the conversation, so you can refine an answer rather than re-asking from scratch.
• For data questions, name objects and attributes the way they appear in your project so Athos can match them.
• Use /reset when you switch to an unrelated topic — it clears the running context so earlier questions do not colour the new answer.
• If a reply is heading the wrong way, press /stop and rephrase.

Related

• AI & Machine Learning Requirements — connectivity, accounts, and how Athos differs from the GPU-based AI tools.
• Display Options — control what is shown in the 3D view that Athos can describe.