> For the complete documentation index, see [llms.txt](https://help.tellius.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.tellius.com/tellius-6.4/getting-started/say-hello-to-tellius/guided-tours-for-quick-onboarding.md).

# Guided tours for quick onboarding

Take the Tellius 6.4 guided tours: where each tour appears, how it starts, and how to move through, skip and replay it on the home page, Kaiya Apps, Kaiya Missions and Settings.

Tellius 6.4 has short guided tours that point out the main parts of a page, one step at a time. Each step highlights one part of the page, dims the rest and explains what that part does. Some tours start on their own the first time you open a page. You can replay most of them at any time from a question-mark icon.

### Where the tours appear

| Page                                 | When the tour starts on its own                                                                      | Where to replay it                                                           |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| Home page                            | The first time a new user with no data of their own opens the home page in a Tellius trial workspace | **Home overview**, the question-mark icon in the right rail of the home page |
| Home page, after **Use Sample Data** | Right after a new user selects **Use Sample Data** on the home page of a trial workspace             | Runs once                                                                    |
| Left navigation                      | The first time a new user sees the left navigation open                                              | Runs once                                                                    |
| Kaiya Architect                      | The first time a new user opens Kaiya Architect                                                      | Runs once                                                                    |
| Kaiya Apps                           | The first time you open the Apps library                                                             | The question-mark icon beside the **Kaiya Apps** title                       |
| An App's page                        | The first time you open an App                                                                       | The question-mark icon beside the App's name                                 |
| Kaiya Missions                       | The first time you open the Mission Library                                                          | The question-mark icon beside the **Kaiya Missions** title                   |
| A Mission's page                     | The first time you open a published Mission                                                          | The question-mark icon beside the Mission's name                             |
| Settings                             | The first time you open Settings                                                                     | **Help** at the bottom right of Settings, then **Settings overview tour**    |

A new user is someone who doesn't own any data in Tellius yet. Once you connect your own data, the new-user tours no longer start on their own.

### Move through a tour

Each step shows a card with a title and a short explanation, next to the part of the page it describes.

* **Next:** go to the next step.
* **Back:** go back to the previous step. It appears from the second step on.
* **Skip:** leave the tour.
* **Done:** shown on the last step in place of **Next**. Select it to finish the tour.

A tour only shows the steps for what is on your page. For example, the home page tour skips a section your home page doesn't show yet, and the App tour skips the **Analysis** tab on an App that doesn't have one.

<figure><img src="https://1702728550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC5PhRxmOjkQZJEO6F9Zw%2Fuploads%2FIvfO79jss76jFLYWKDwy%2Ftour-home-last-step-done-64.png?alt=media&amp;token=a7e64b29-7e3f-44cf-8d00-05e53aee36d7" alt="The last step of the home page tour, Pick up where you left off, with Skip, Back and Done on its card and the Pick up where you left off section highlighted" width="563"><figcaption></figcaption></figure>

### Replay a tour, or let it go

When you finish a tour with **Done**, or leave it with **Skip**, it doesn't start on its own again. Tellius remembers this for your user account.

To see a tour again, select its question-mark icon. A replay always runs, even if you finished or skipped the tour before.

{% hint style="success" %}
**When to replay a tour.** Replay a tour when you show Tellius to a new teammate, or when you come back to a page you haven't used in a while. It's a quick reminder of where each control is, and it doesn't change anything on the page.
{% endhint %}

### The home page tours

**Home overview** walks through the home page from top to bottom:

* **Meet Kaiya:** the ask box, where you ask Kaiya your questions.
* **Start in a mode:** the mode buttons under the ask box, which start a new chat set up for one kind of work, such as a Deep Insight, a Mission or an App.
* **Connect your data or start with sample data:** the **Connect data** and **Use Sample Data** buttons. This step shows only before you connect any data.
* **Today's briefings:** the briefings your Missions leave on the home page after they run.
* **Your apps:** the Apps you built or that were shared with you.
* **Tracked metrics:** the metrics you follow.
* **Pick up where you left off:** your recent and favorite work.

To replay it, select **Home overview**, the question-mark icon in the right rail of the home page.

<figure><img src="https://1702728550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC5PhRxmOjkQZJEO6F9Zw%2Fuploads%2FtfDU2kgWu1N57Ec1cnAW%2Ftour-home-overview-button-64.png?alt=media&amp;token=176345f7-70e9-4575-8acc-fd69d0dececf" alt="The Home overview question-mark icon in the right rail of the home page, with its tooltip" width="270"><figcaption></figcaption></figure>

<figure><img src="https://1702728550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC5PhRxmOjkQZJEO6F9Zw%2Fuploads%2Faz1p7CXnS84PNrh37Ecb%2Ftour-home-briefings-step-64.png?alt=media&amp;token=4875e5e9-00cb-4836-9d52-900f4a51eced" alt="The Today&#x27;s briefings step of the home page tour, with the Your missions section highlighted and Skip, Back and Next on the card" width="563"><figcaption></figcaption></figure>

New users also see these tours:

* **Sample data walkthrough:** in a trial workspace, it starts right after you select **Use Sample Data**. It points out the sample dataset in use, the ask box where Kaiya is ready for your first question, four ways to work (Deep Insight, Missions, Apps and Kaiya Architect), and the **Recently viewed** and **Suggested for you** sections.
* **Navigation guide:** starts the first time you see the left navigation open. It introduces each module in turn: **New Chat** (Kaiya), **Apps**, **Missions**, **Explore** (Vizpads), **Context**, **Data** and **Help**.
* **Kaiya Architect tour:** starts the first time you open Kaiya Architect. It shows where you describe what you need, the **Plan**, **Diagram** and **YAML** views of your model, and **Data Sources**.

These three tours run once, and they have no replay icon.

### The Kaiya Apps tours

**The Apps library.** The tour has two steps: the **Published**, **Draft** and **Archived** tabs, then **Create New App**.

<figure><img src="https://1702728550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC5PhRxmOjkQZJEO6F9Zw%2Fuploads%2FcHtCkq5Ly2410yvpvvi2%2Ftour-apps-list-library-step-64.png?alt=media&amp;token=68b03342-5be9-4f48-ae0d-e3f0b47356bc" alt="The first step of the Apps library tour, Apps Library, with the Published, Draft and Archived tabs highlighted and the question-mark icon beside the Kaiya Apps title boxed" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
The second step also mentions **Import**. Importing Apps is turned off in Tellius 6.4, so start a new App with **Create New App**.
{% endhint %}

**An App's page.** The tour picks up where the Apps library tour ends. It walks through the **Plan**, **Analysis** and **App** tabs, the chat icon that opens the App's conversation with Kaiya, **Data Refreshed At**, **Version**, the refresh menu, and the three-dot menu with **Share**, **Publish** and **Delete**. See [Anatomy of a completed app](/tellius-6.4/kaiya/kaiya-apps/anatomy-of-a-completed-app.md).

<figure><img src="https://1702728550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC5PhRxmOjkQZJEO6F9Zw%2Fuploads%2F5Vnp7FlGw2s5otgcLreC%2Ftour-app-plan-step-64.png?alt=media&amp;token=21bca369-0ad5-44d5-b284-4c8a85fd2be3" alt="The first step of an App&#x27;s tour, Start with the Plan, with the Plan tab highlighted and the question-mark icon beside the App&#x27;s name" width="450"><figcaption></figcaption></figure>

<figure><img src="https://1702728550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC5PhRxmOjkQZJEO6F9Zw%2Fuploads%2F0G6M8nV5VzmQbkf5MSEI%2Ftour-app-share-publish-step-64.png?alt=media&amp;token=0d7b543e-c6a8-4640-867e-f617f39290e0" alt="The last step of an App&#x27;s tour, Share and publish, pointing at the three-dot menu at the top right of the App, with Skip, Back and Done" width="450"><figcaption></figcaption></figure>

### The Kaiya Missions tours

**The Mission Library.** The tour has two steps: the **Published Missions** and **Draft Missions** tabs, then **Create Mission** and **View Schedules**. See [The Mission Library and Mission page](/tellius-6.4/kaiya/kaiya-missions/how-to-create-a-kaiya-mission/mission-library-and-mission-page.md).

<figure><img src="https://1702728550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC5PhRxmOjkQZJEO6F9Zw%2Fuploads%2FTmIKIEKRt1bGmmUQtvnW%2Ftour-missions-start-step-64.png?alt=media&amp;token=f736e9f0-cbe1-473d-bdea-c757f7f33184" alt="The second step of the Mission Library tour, Start a new Mission, with Create Mission highlighted and View Schedules beside it" width="450"><figcaption></figcaption></figure>

**A Mission's page.** The tour covers the run selector with the Mission's run history, **Run** and **Configure**, and the three-dot menu. Once the Mission has run, it ends on the briefing.

<figure><img src="https://1702728550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC5PhRxmOjkQZJEO6F9Zw%2Fuploads%2FVabj6yv3pOGGBsBtFzc6%2Ftour-mission-briefing-run-configure-64.png?alt=media&amp;token=d8983c74-edde-4302-8ec5-9e393ea43d8c" alt="The Run or configure step of a Mission page tour, with Run and Configure highlighted" width="450"><figcaption></figcaption></figure>

### The Settings tour

The Settings tour starts with **Search settings**, the search box at the top of Settings. It then has one step for each section of the Settings sidebar you can see, such as **Account**, **Workspace** and **Intelligence**, with what each section holds. Your role decides which sections you see, so the tour can be shorter for you than for an administrator.

To replay it, select **Help** at the bottom right of Settings, then **Settings overview tour**.

<figure><img src="https://1702728550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC5PhRxmOjkQZJEO6F9Zw%2Fuploads%2F5AmM17WCh131gE6PfPLE%2Ftour-settings-help-menu-64.png?alt=media&amp;token=ec84bcc3-7f65-4f4f-8396-625a04858cae" alt="The Help button at the bottom right of Settings, with its Settings overview tour option" width="282"><figcaption></figcaption></figure>

<figure><img src="https://1702728550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC5PhRxmOjkQZJEO6F9Zw%2Fuploads%2FW00rKFhLPZhyR7fpK4la%2Ftour-settings-workspace-step-64.png?alt=media&amp;token=f18b2445-97cb-4197-a5d4-b4a3573b97a5" alt="The Workspace step of the Settings tour, with the Workspace section of the Settings sidebar highlighted" width="450"><figcaption></figcaption></figure>

{% hint style="info" %}
**Two question marks in Settings.** The question-mark icon beside a Settings page's title opens the help documentation for that page. The Settings tour is under **Help** at the bottom right.
{% endhint %}

### Tutorials in earlier releases

In releases before Tellius 6.4, the home page had a **Tutorials** tab with a list of module tutorials and a progress bar:

1. From the homepage, click on the **Tutorials** tab on the right pane to expand. Alternatively, you can click on the **Help** tab in the left pane.
2. A list of modules appears, and you can click on the **Start** button of Tellius Overview to get started. Also, you can click on the **Start** button of any module to learn further.
3. The progress bar displays the number of modules completed. Once you complete a module, you can find a checkmark near the module name.
4. A welcome window appears, and you can click on **Let’s Go** to take a tour across Tellius.
5. Every widget will be presented with a video that gives you an overview of the module and a link to the corresponding Help Guide.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.tellius.com/tellius-6.4/getting-started/say-hello-to-tellius/guided-tours-for-quick-onboarding.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
