https://docs-vrgeo-version3.netlify.app/assets/js/e9eede93.45fbd8cc.js

1"use strict";(globalThis.webpackChunkvrgs_docs_v_3_1=globalThis.webpackChunkvrgs_docs_v_3_1||[]).push([[19706],{4007(e,t,s){s.r(t),s.d(t,{assets:()=>h,contentTitle:()=>a,default:()=>c,frontMatter:()=>r,metadata:()=>n,toc:()=>l});const n=JSON.parse('{"id":"general/viewing-collaboration/athos-ai-assistant","title":"Using the Athos AI Assistant","description":"Chat with Athos, the AI assistant built into VRGS \u2014 ask how to use the software, ask geoscience questions against your own literature library, query your project database in plain English, look at and drive the 3D view, segment features in your photographs, and diagnose and tune your photogrammetry (SfM) reconstructions, all from a docking panel.","source":"@site/versioned_docs/version-3.4/general/viewing-collaboration/athos-ai-assistant.md","sourceDirName":"general/viewing-collaboration","slug":"/general/viewing-collaboration/athos-ai-assistant","permalink":"/docs/general/viewing-collaboration/athos-ai-assistant","draft":false,"unlisted":false,"editUrl":"https://github.com/vrgeoscience/vrgs_docs_v3/tree/master/versioned_docs/version-3.4/general/viewing-collaboration/athos-ai-assistant.md","tags":[],"version":"3.4","sidebarPosition":5,"frontMatter":{"id":"athos-ai-assistant","title":"Using the Athos AI Assistant","sidebar_label":"Athos AI Assistant","description":"Chat with Athos, the AI assistant built into VRGS \u2014 ask how to use the software, ask geoscience questions against your own literature library, query your project database in plain English, look at and drive the 3D view, segment features in your photographs, and diagnose and tune your photogrammetry (SfM) reconstructions, all from a docking panel.","keywords":["athos","ai assistant","llm","chat","rag","retrieval","literature","question answering","openai","claude","ollama","help","vision","screenshot","segmentation","segment anything","sam","3d view","photogrammetry","sfm","reconstruction"],"sidebar_position":5},"sidebar":"docs","previous":{"title":"Multiuser (VFT)","permalink":"/docs/general/viewing-collaboration/multiuser-vft"},"next":{"title":"Asking Athos Well","permalink":"/docs/general/viewing-collaboration/asking-athos"}}');var i=s(74848),o=s(28453);const r={id:"athos-ai-assistant",title:"Using the Athos AI Assistant",sidebar_label:"Athos AI Assistant",description:"Chat with Athos, the AI assistant built into VRGS \u2014 ask how to use the software, ask geoscience questions against your own literature library, query your project database in plain English, look at and drive the 3D view, segment features in your photographs, and diagnose and tune your photogrammetry (SfM) reconstructions, all from a docking panel.",keywords:["athos","ai assistant","llm","chat","rag","retrieval","literature","question answering","openai","claude","ollama","help","vision","screenshot","segmentation","segment anything","sam","3d view","photogrammetry","sfm","reconstruction"],sidebar_position:5},a=void 0,h={},l=[{value:"Opening Athos",id:"opening-athos",level:2},{value:"What you can ask Athos",id:"what-you-can-ask-athos",level:2},{value:"How-to and help questions",id:"how-to-and-help-questions",level:3},{value:"Geoscience and literature questions",id:"geoscience-and-literature-questions",level:3},{value:"Questions about your project data",id:"questions-about-your-project-data",level:3},{value:"Driving and describing the 3D view",id:"driving-and-describing-the-3d-view",level:3},{value:"Segmenting a photograph",id:"segmenting-a-photograph",level:3},{value:"Working with photogrammetry (SfM) models",id:"working-with-photogrammetry-sfm-models",level:3},{value:"Writing up an analysis",id:"writing-up-an-analysis",level:3},{value:"Sources and references",id:"sources-and-references",level:2},{value:"Choosing the language model",id:"choosing-the-language-model",level:2},{value:"Slash commands",id:"slash-commands",level:2},{value:"Setting up the literature library",id:"setting-up-the-literature-library",level:2},{value:"Related",id:"related",level:2}];function d(e){const t={a:"a",admonition:"admonition",blockquote:"blockquote",code:"code",em:"em",h2:"h2",h3:"h3",li:"li",p:"p",pre:"pre",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,o.R)(),...e.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsxs)(t.p,{children:[(0,i.jsx)(t.strong,{children:"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."]}),"\n",(0,i.jsxs)(t.p,{children:["By default Athos is ",(0,i.jsx)(t.strong,{children:"cloud-based"})," \u2014 it sends your questions to a hosted language model, so it needs an internet connection. It can instead run against a ",(0,i.jsx)(t.a,{href:"/docs/general/setup-system/ollama-setup",children:"local Ollama server"})," on your own hardware, which keeps your prompts on your machine and works offline. See ",(0,i.jsx)(t.a,{href:"/docs/general/setup-system/ai-ml-requirements#the-ai-assistant-athos--llm",children:"AI & Machine Learning Requirements"})," for connectivity and account details."]}),"\n",(0,i.jsx)(t.h2,{id:"opening-athos",children:"Opening Athos"}),"\n",(0,i.jsx)(t.p,{children:"Athos lives in a dockable panel. To show or hide it:"}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:["On the ",(0,i.jsx)(t.strong,{children:"Home"})," ribbon tab, in the ",(0,i.jsx)(t.strong,{children:"Windows"})," group, click ",(0,i.jsx)(t.strong,{children:"Athos"}),"."]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["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 ",(0,i.jsx)(t.strong,{children:"Enter"})," to send it. Athos streams its reply into the conversation as it is generated."]}),"\n",(0,i.jsx)(t.p,{children:"When a question needs work first \u2014 a database query, a look at the view, a segmentation \u2014 Athos narrates what it is doing as it goes, so a long answer shows its progress rather than sitting on a spinner. The final answer then streams in as it is written."}),"\n",(0,i.jsx)(t.h2,{id:"what-you-can-ask-athos",children:"What you can ask Athos"}),"\n",(0,i.jsx)(t.p,{children:"Athos automatically decides which of its abilities to use based on your question. You do not need to tell it which tool to run."}),"\n",(0,i.jsx)(t.h3,{id:"how-to-and-help-questions",children:"How-to and help questions"}),"\n",(0,i.jsxs)(t.p,{children:["Ask how to do something in VRGS and Athos answers from the ",(0,i.jsx)(t.strong,{children:"built-in user documentation"})," (the same content as this site). This help library ships with VRGS, so these questions work out of the box."]}),"\n",(0,i.jsxs)(t.blockquote,{children:["\n",(0,i.jsxs)(t.p,{children:[(0,i.jsx)(t.em,{children:'"How do I import an LAS well log?"'}),"\n",(0,i.jsx)(t.em,{children:'"Where is the flight path timeline?"'}),"\n",(0,i.jsx)(t.em,{children:'"What does the M3C2 comparison tool do?"'})]}),"\n"]}),"\n",(0,i.jsx)(t.h3,{id:"geoscience-and-literature-questions",children:"Geoscience and literature questions"}),"\n",(0,i.jsxs)(t.p,{children:["Athos can answer scientific and geological questions from a ",(0,i.jsx)(t.strong,{children:"literature library"})," of your own papers and reports. This searches a document database attached to your project (see ",(0,i.jsx)(t.a,{href:"#setting-up-the-literature-library",children:"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."]}),"\n",(0,i.jsxs)(t.blockquote,{children:["\n",(0,i.jsxs)(t.p,{children:[(0,i.jsx)(t.em,{children:'"What controls the geometry of hybrid event beds?"'}),"\n",(0,i.jsx)(t.em,{children:'"Summarise the methods used to measure palaeocurrent directions in outcrop."'})]}),"\n"]}),"\n",(0,i.jsx)(t.h3,{id:"questions-about-your-project-data",children:"Questions about your project data"}),"\n",(0,i.jsxs)(t.p,{children:["Athos can query your ",(0,i.jsx)(t.strong,{children:"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."]}),"\n",(0,i.jsxs)(t.blockquote,{children:["\n",(0,i.jsxs)(t.p,{children:[(0,i.jsx)(t.em,{children:'"How many interpretation objects contain the word sandstone?"'}),"\n",(0,i.jsx)(t.em,{children:'"List the dip and azimuth measurements grouped by object."'})]}),"\n"]}),"\n",(0,i.jsx)(t.h3,{id:"driving-and-describing-the-3d-view",children:"Driving and describing the 3D view"}),"\n",(0,i.jsxs)(t.p,{children:["Athos can move the camera, describe what is currently displayed, and ",(0,i.jsx)(t.strong,{children:"take a screenshot of the 3D view and look at it"})," \u2014 so you can ask about what is on screen rather than describing it."]}),"\n",(0,i.jsxs)(t.blockquote,{children:["\n",(0,i.jsxs)(t.p,{children:[(0,i.jsx)(t.em,{children:'"What objects are visible right now?"'}),"\n",(0,i.jsx)(t.em,{children:'"Centre the view on the model."'}),"\n",(0,i.jsx)(t.em,{children:'"What am I looking at?"'}),"\n",(0,i.jsx)(t.em,{children:'"Is the highlighted surface in front of or behind the fault?"'})]}),"\n"]}),"\n",(0,i.jsx)(t.p,{children:"You never ask for the screenshot yourself. Athos decides a question needs a look at the scene and captures it as part of answering, so the picture al

1ways reflects the view at the moment it replies \u2014 including any camera move it made first."}),"\n",(0,i.jsxs)(t.p,{children:["Along with the image, Athos receives the capture size, how many objects are displayed, how many are selected or highlighted, and the names of the selected ones. That is why it can answer ",(0,i.jsx)(t.em,{children:'"what is the highlighted one called?"'})," precisely: the name comes from your project, not from reading the picture."]}),"\n",(0,i.jsx)(t.admonition,{title:"Seeing needs a model that can read images",type:"note",children:(0,i.jsxs)(t.p,{children:["The hosted ",(0,i.jsx)(t.strong,{children:"OpenAI"})," and ",(0,i.jsx)(t.strong,{children:"Anthropic Claude"})," providers both receive the screenshot. A local ",(0,i.jsx)(t.strong,{children:"Ollama"})," model receives it too, provided the model you are running is vision-capable \u2014 the default ",(0,i.jsx)(t.code,{children:"qwen3-vl:8b"})," is. Run a text-only local model and Athos answers from the scene description alone: it knows how many objects are shown and what they are called, and nothing about how they look. See ",(0,i.jsx)(t.a,{href:"/docs/general/setup-system/ollama-setup#images-and-vision-models",children:"Images and vision models"}),"."]})}),"\n",(0,i.jsx)(t.p,{children:"A few things worth knowing about the screenshot:"}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.strong,{children:"It is a rendering, not a photograph."})," Athos sees your scene with its current lighting, colour maps, shading, and any draped imagery. Colour in a 3D view usually comes from an attribute map rather than from rock, so treat geological readings of a viewport screenshot with caution \u2014 for real outcrop appearance, work from photographs."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.strong,{children:"The capture is bounded by your 3D window."})," A larger or maximised 3D view gives Athos more detail. If a feature is off-screen, occluded, or tiny, Athos sees it that way too \u2014 navigate to a clear view before asking."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.strong,{children:"Each question captures afresh."})," A follow-up such as ",(0,i.jsx)(t.em,{children:'"and what about the left-hand side of that image?"'})," will not refer back to the previous picture, so repeat the relevant part of the question."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.strong,{children:"A 3D view must be active."})," If the active window is a photograph, map, chart, or log, there is no 3D scene to capture and Athos will say so. Click into a 3D window and ask again."]}),"\n"]}),"\n",(0,i.jsx)(t.h3,{id:"segmenting-a-photograph",children:"Segmenting a photograph"}),"\n",(0,i.jsxs)(t.p,{children:["Athos can run the ",(0,i.jsx)(t.strong,{children:"Segment Anything (SAM)"})," tools on a photograph for you. Describe the feature you want outlined and it places the prompts \u2014 a box around it, points on it, points on what to leave out \u2014 and runs the segmentation."]}),"\n",(0,i.jsxs)(t.blockquote,{children:["\n",(0,i.jsxs)(t.p,{children:[(0,i.jsx)(t.em,{children:'"Outline the sandstone bed in the middle of this photo."'}),"\n",(0,i.jsx)(t.em,{children:'"Segment the scree at the base of the cliff, but not the vegetation."'}),"\n",(0,i.jsx)(t.em,{children:'"That mask has taken in too much shadow \u2014 exclude the dark area on the left."'})]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["The result appears as the ordinary ",(0,i.jsx)(t.strong,{children:"mask preview"})," in the photograph view, exactly as if you had placed the points yourself. Athos never writes to your project: it proposes the mask, and you commit it \u2014 or discard it \u2014 with ",(0,i.jsx)(t.strong,{children:"Label from Segments"}),", the same as any hand-drawn segmentation. Every mask that reaches your segmentation layer has passed through you."]}),"\n",(0,i.jsx)(t.p,{children:"Athos replies with a summary of what it produced \u2014 the area in pixels, the bounding box, and the fraction of the image covered \u2014 so you can judge a mask from the numbers as well as by looking at it."}),"\n",(0,i.jsx)(t.p,{children:"To refine, just say what is wrong. Athos calls the tool again, feeding the previous mask back as a starting point and adding your corrections, so the outline converges rather than starting over."}),"\n",(0,i.jsx)(t.admonition,{title:"The photograph must already be open",type:"note",children:(0,i.jsxs)(t.p,{children:["Athos segments ",(0,i.jsx)(t.strong,{children:"the image currently shown in a photograph view"}),". It will not open a photograph or step to another one \u2014 switching images discards the encoded image tiles, which is slow and would take the view out from under you. Open the photograph you want first (double-click it in the project tree, or use ",(0,i.jsx)(t.strong,{children:"Open Photos in Annotation View"})," on an SfM workflow), then ask."]})}),"\n",(0,i.jsx)(t.p,{children:"A few practicalities:"}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.strong,{children:"The first request on a fresh ph

1otograph warms it up."})," SAM encodes the image in tiles before it can segment, which takes a few seconds per tile. Athos replies that it is preparing and asks you to try again \u2014 the same as the first click of a manual segmentation. Ask again once and it runs."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.strong,{children:"The SAM models must already be installed."})," If they are not, Athos says so rather than starting a download mid-conversation. Click once in a photograph with a segmentation tool to get the usual download prompt, then return to Athos."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.strong,{children:"Very small images are refused."})," Photographs under 1024 px in either dimension are declined rather than segmented inaccurately."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.strong,{children:"Refinement needs a hosted provider."})," Single-shot segmentation works on any provider that supports tool-calling; the back-and-forth refinement loop needs ",(0,i.jsx)(t.strong,{children:"OpenAI"})," or ",(0,i.jsx)(t.strong,{children:"Claude"}),"."]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["See ",(0,i.jsx)(t.a,{href:"/docs/general/meshes-point-clouds/texture-attributes#baking-ai-classifications-onto-meshes",children:"Texture Attributes"})," for carrying committed labels through to the mesh."]}),"\n",(0,i.jsx)(t.h3,{id:"working-with-photogrammetry-sfm-models",children:"Working with photogrammetry (SfM) models"}),"\n",(0,i.jsxs)(t.p,{children:["If you build 3D models from photographs with ",(0,i.jsx)(t.a,{href:"/docs/general/meshes-point-clouds/sfm-user-guide",children:"Structure-from-Motion"}),", Athos can help you understand and tune a reconstruction. The quickest way in is to ",(0,i.jsxs)(t.strong,{children:["right-click an SfM workflow in the project tree and choose ",(0,i.jsx)(t.em,{children:"Ask Athos about this Model"})]})," \u2014 this opens the Athos panel and asks it to diagnose that specific reconstruction. You can also just ask in the chat."]}),"\n",(0,i.jsxs)(t.blockquote,{children:["\n",(0,i.jsxs)(t.p,{children:[(0,i.jsx)(t.em,{children:'"Why does my dense cloud have holes?"'}),"\n",(0,i.jsx)(t.em,{children:'"How good is this reconstruction, and which photos failed to register?"'}),"\n",(0,i.jsx)(t.em,{children:'"What settings did this use \u2014 should I change any?"'})]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Athos reads the reconstruction's settings, its registration and reprojection-error figures, how it is georeferenced, its ground-control and scale-bar accuracy, the worst photos, and the ",(0,i.jsx)(t.a,{href:"/docs/general/meshes-point-clouds/sfm-user-guide#reading-the-run-log",children:"per-view dense-MVS diagnostics"})," \u2014 so its answers cite your actual numbers rather than guessing. It also knows the memory cost of the heavier settings, so it steers you away from changes that would run feature extraction out of memory."]}),"\n",(0,i.jsx)(t.p,{children:"Athos can also act on a reconstruction, always with a confirmation step first:"}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.strong,{children:"Change a setting"})," \u2014 it shows the exact before \u2192 after (for example ",(0,i.jsx)(t.em,{children:'"depth tolerance 0.025 \u2192 0.040"'}),") and only applies it once you agree. The change takes effect on the next reconstruction."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.strong,{children:"Run a reconstruction"})," \u2014 it will (re)run a workflow when you explicitly ask and confirm. Reconstruction is a long job, so it runs in the background: watch the progress bar, and ask Athos to check the results when it finishes."]}),"\n"]}),"\n",(0,i.jsx)(t.admonition,{title:"Acting on a model needs a hosted provider",type:"note",children:(0,i.jsxs)(t.p,{children:["Asking about a model and the ",(0,i.jsx)(t.em,{children:"Ask Athos about this Model"})," menu work with any provider. ",(0,i.jsx)(t.strong,{children:"Changing settings and starting a reconstruction"})," use the tool-calling that the hosted ",(0,i.jsx)(t.strong,{children:"OpenAI"})," and ",(0,i.jsx)(t.strong,{children:"Claude"})," providers support; a local Ollama model can inspect and advise but not act. Switch with ",(0,i.jsx)(t.code,{children:"/switch claude"})," if needed."]})}),"\n",(0,i.jsx)(t.h3,{id:"writing-up-an-analysis",children:"Writing up an analysis"}),"\n",(0,i.jsxs)(t.p,{children:["Athos can build an ",(0,i.jsx)(t.a,{href:"/docs/general/viewing-collaboration/report-view",children:"analysis report"})," for you \u2014 ",(0,i.jsx)(t.em,{children:'"write up the\nstereonet analysis for this outcrop"'})," is a request it can act on. It can create a\nreport, append a heading and body text as a draft for you to edit, and insert an\nanalysis figure captured live from the stereonet, the rose diagram, the Charts\npanel, a DFN validation run or the 3D view."]}),"\n",(0,i.jsxs)(t.p,{children:["Inside a report it also helps with the text itself: checking spelling and\ngrammar, improving, shortening or expanding a selection, describing the figure\nthe caret is in ",(0,i.jsx)(t.strong,{children:"from the statistics behind it"})," rather than from the picture,\nand reviewing the whole report. Every suggestion is shown and applied only if you\naccept it \u2014 nothing is written into the document on its own."]}),"\n",(0,i.jsx)(t.h2,{id:"sources-and-references",children:"Sources and references"}),"\n",(0,i.jsxs)(t.p,{children:["When Athos answers from your literature library or the help documentation, it lists the material it drew on under a ",(0,i.jsx)(t.strong,{children:"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."]}),"\n",(0,i.jsx)(t.h2,{id:"choosing-the-language-model",children:"Choosing the language model"}),"\n",(0,i.jsxs)(t.p,{children:["By default Athos uses a hosted ",(0,i.jsx)(t.strong,{children:"OpenAI"})," model. You can switch the provider at any time from the chat box:"]}),"\n",(0,i.jsxs)(t.table,{children:[(0,i.jsx)(t.thead,{children:(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.th,{children:"Command"}),(0,i.jsx)(t.th,{children:"Provider"}),(0,i.jsx)(t.th,{children:"Can see images?"})]})}),(0,i.jsxs)(t.tbody,{children:[(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/switch openai"})}),(0,i.jsx)(t.td,{children:"Hosted OpenAI model (default)"}),(0,i.jsx)(t.td,{children:(0,i.jsx)(t.strong,{children:"Yes"})})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/switch claude"})}),(0,i.jsx)(t.td,{children:"Anthropic Claude"}),(0,i.jsx)(t.td,{children:(0,i.jsx)(t.strong,{children:"Yes"})})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/switch ollama"})}),(0,i.jsxs)(t.td,{children:["A local ",(0,i.jsx)(t.a,{href:"https://ollama.com",children:"Ollama"})," server on your own hardware \u2014 see ",(0,i.jsx)(t.a,{href:"/docs/general/setup-system/ollama-setup",children:"setup"})]}),(0,i.jsxs)(t.td,{children:[(0,i.jsx)(t.strong,{children:"Yes"}),", with a vision model (the default ",(0,i.jsx)(t.code,{children:"qwen3-vl:8b"})," is one)"]})]})]})]}),"\n",(0,i.jsxs)(t.p,{children:["Use ",(0,i.jsx)(t.code,{children:"/provider"}

1)," to list the available providers. Running models locally with Ollama keeps your prompts on your own hardware and works offline, but the quality and speed then depend on the model and machine you run; see ",(0,i.jsx)(t.a,{href:"/docs/general/setup-system/ollama-setup",children:"Running Athos Locally with Ollama"})," to set it up, and ",(0,i.jsx)(t.a,{href:"/docs/general/setup-system/ai-ml-requirements#the-ai-assistant-athos--llm",children:"AI & Machine Learning Requirements"})," for how it differs from the GPU-based AI tools."]}),"\n",(0,i.jsxs)(t.p,{children:["Every provider can answer help, literature, and project-database questions, and all three can now ",(0,i.jsx)(t.a,{href:"#driving-and-describing-the-3d-view",children:"see the 3D view"})," \u2014 for Ollama, as long as the local model reads images. What still separates them is the acting: ",(0,i.jsx)(t.a,{href:"#segmenting-a-photograph",children:"changing settings and segmenting photographs"})," need the tool-calling the hosted providers support."]}),"\n",(0,i.jsx)(t.h2,{id:"slash-commands",children:"Slash commands"}),"\n",(0,i.jsxs)(t.p,{children:["Type ",(0,i.jsx)(t.code,{children:"/"})," in the chat box to see command suggestions. The most useful commands are:"]}),"\n",(0,i.jsxs)(t.table,{children:[(0,i.jsx)(t.thead,{children:(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.th,{children:"Command"}),(0,i.jsx)(t.th,{children:"Alias"}),(0,i.jsx)(t.th,{children:"Action"})]})}),(0,i.jsxs)(t.tbody,{children:[(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/help"})}),(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/h"})}),(0,i.jsx)(t.td,{children:"Show the full command reference"})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/clear"})}),(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/c"})}),(0,i.jsx)(t.td,{children:"Clear the chat history"})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/reset"})}),(0,i.jsx)(t.td,{}),(0,i.jsx)(t.td,{children:"Reset the conversation context (start a fresh topic)"})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/stop"})}),(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/s"})}),(0,i.jsx)(t.td,{children:"Cancel the request Athos is currently working on"})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/export"})}),(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/e"})}),(0,i.jsx)(t.td,{children:"Export the chat transcript to a file"})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/switch"})}),(0,i.jsx)(t.td,{}),(0,i.jsxs)(t.td,{children:["Switch the language model provider, e.g. ",(0,i.jsx)(t.code,{children:"/switch claude"})]})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/provider"})}),(0,i.jsx)(t.td,{}),(0,i.jsx)(t.td,{children:"List the available providers"})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/schema"})}),(0,i.jsx)(t.td,{}),(0,i.jsx)(t.td,{children:"Describe the project database schema"})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/tables"})}),(0,i.jsx)(t.td,{}),(0,i.jsx)(t.td,{children:"List the tables in the project database"})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/sample <table>"})}),(0,i.jsx)(t.td,{}),(0,i.jsx)(t.td,{children:"Show a few rows from a table, to see what is in it"})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/limit <n>"})}),(0,i.jsx)(t.td,{}),(0,i.jsxs)(t.td,{children:["Cap the rows a database answer returns (",(0,i.jsx)(t.code,{children:"/limit off"})," for no cap, ",(0,i.jsx)(t.code,{children:"/limit"})," to show the current setting)"]})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsxs)(t.td,{children:[(0,i.jsx)(t.code,{children:"/sql on"})," | ",(0,i.jsx)(t.code,{children:"/sql off"})]}),(0,i.jsx)(t.td,{}),(0,i.jsxs)(t.td,{children:["Show or hide the database queries Athos runs (",(0,i.jsx)(t.code,{children:"/sql always"})," includes queries that returned nothing, ",(0,i.jsx)(t.code,{children:"/sql status"})," shows the current setting)"]})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/status"})}),(0,i.jsx)(t.td,{}),(0,i.jsx)(t.td,{children:"Show a system status summary"})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/version"})}),(0,i.jsx)(t.td,{}),(0,i.jsx)(t.td,{children:"Show the Athos version"})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/snapshot"})}),(0,i.jsx)(t.td,{children:(0,i.jsx)(t.code,{children:"/snap"})}),(0,i.jsx)(t.td,{children:"Save the conversation and its context to a JSON file, with secrets redacted \u2014 what to attach to a 

1support report"})]})]})]}),"\n",(0,i.jsxs)(t.p,{children:[(0,i.jsx)(t.code,{children:"/help"})," lists everything, including the diagnostic commands (",(0,i.jsx)(t.code,{children:"/test_network"}),",\n",(0,i.jsx)(t.code,{children:"/api_count"})," and the various ",(0,i.jsx)(t.code,{children:"/test_*"})," flows) that are there for troubleshooting\nrather than everyday use."]}),"\n",(0,i.jsx)(t.h2,{id:"setting-up-the-literature-library",children:"Setting up the literature library"}),"\n",(0,i.jsxs)(t.p,{children:["The scientific-literature search (the ability to answer geoscience questions from ",(0,i.jsx)(t.em,{children:"your"})," papers) works over a small search database stored inside your project, in a folder named ",(0,i.jsx)(t.strong,{children:(0,i.jsx)(t.code,{children:"RAG_DB"})}),":"]}),"\n",(0,i.jsx)(t.pre,{children:(0,i.jsx)(t.code,{children:"<project> Data\\RAG_DB\\rag.db\n<project> Data\\RAG_DB\\rag.faiss\n"})}),"\n",(0,i.jsxs)(t.p,{children:["These two files are built ahead of time from a folder of PDF papers and reports using the separate ",(0,i.jsx)(t.strong,{children:"RAG DB Creator"})," tool, then copied into the project's ",(0,i.jsx)(t.code,{children:"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."]}),"\n",(0,i.jsx)(t.admonition,{type:"note",children:(0,i.jsxs)(t.p,{children:["If the ",(0,i.jsx)(t.code,{children:"RAG_DB"})," folder is empty, geoscience questions are still answered from the language model's general knowledge, and ",(0,i.jsx)(t.strong,{children:"how-to questions keep working"})," because the help documentation is bundled with VRGS. Only the ability to cite ",(0,i.jsx)(t.em,{children:"your"})," literature depends on the library being present."]})}),"\n",(0,i.jsx)(t.admonition,{title:"Getting good answers",type:"tip",children:(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsx)(t.li,{children:"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."}),"\n",(0,i.jsx)(t.li,{children:"For data questions, name objects and attributes the way they appear in your project so Athos can match them."}),"\n",(0,i.jsx)(t.li,{children:"For questions about the 3D view, frame the shot first \u2014 Athos sees exactly what is on screen."}),"\n",(0,i.jsxs)(t.li,{children:["Use ",(0,i.jsx)(t.code,{children:"/reset"})," when you switch to an unrelated topic \u2014 it clears the running context so earlier questions do not colour the new answer."]}),"\n",(0,i.jsxs)(t.li,{children:["If a reply is heading the wrong way, press ",(0,i.jsx)(t.code,{children:"/stop"})," and rephrase."]}),"\n"]})}),"\n",(0,i.jsx)(t.h2,{id:"related",children:"Related"}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:["\n",(0,i.jsxs)(t.p,{children:[(0,i.jsx)(t.a,{href:"/docs/general/viewing-collaboration/asking-athos",children:"Asking Athos Well"})," \u2014 how to phrase a question, what Athos can and cannot see, and what to do when an answer is wrong."]}),"\n"]}),"\n",(0,i.jsxs)(t.li,{children:["\n",(0,i.jsxs)(t.p,{children:[(0,i.jsx)(t.a,{href:"/docs/general/setup-system/ai-ml-requirements",children:"AI & Machine Learning Requirements"})," \u2014 connectivity, accounts, and how Athos differs from the GPU-based AI tools."]}),"\n"]}),"\n",(0,i.jsxs)(t.li,{children:["\n",(0,i.jsxs)(t.p,{children:[(0,i.jsx)(t.a,{href:"/docs/general/viewing-collaboration/display-properties",children:"Display Options"})," \u2014 control what is shown in the 3D view that Athos can describe."]}),"\n"]}),"\n",(0,i.jsxs)(t.li,{children:["\n",(0,i.jsxs)(t.p,{children:[(0,i.jsx)(t.a,{href:"/docs/general/viewing-collaboration/report-view",children:"Analysis Reports"})," \u2014 the documents Athos can draft, illustrate and review."]}),"\n"]}),"\n"]})]})}function c(e={}){const{wrapper:t}={...(0,o.R)(),...e.components};return t?(0,i.jsx)(t,{...e,children:(0,i.jsx)(d,{...e})}):d(e)}},28453(e,t,s){s.d(t,{R:()=>r,x:()=>a});var n=s(96540);const i={},o=n.createContext(i);function r(e){const t=n.useContext(o);return n.useMemo(function(){return"function"==typeof e?e(t):{...t,...e}},[t,e])}function a(e){let t;return t=e.disableParentContext?"function"==typeof e.components?e.components(i):e.components||i:r(e.components),n.createElement(o.Provider,{value:t},e.children)}}}]);