> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datazone.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Orion Prime

> Orion Prime is the assistant behind the home page box. It answers from the data each user can read, and a chat can be shared with the whole organisation.

Orion Prime is the assistant on the home page. Type a question, or the name of something you are looking for, into the box. Prime finds the right datasets, views, knowledge objects, vector indexes and agents, runs queries and answers in a chat.

Prime answers from **what the person asking can read**. It does not use an administrator's access. If you cannot read a dataset, Prime does not use it for you, even when someone else asks the same question.

> [!NOTE]
>
> Orion Prime is switched on in **Settings > AI > Orion Prime**. While it is off, the box does not appear on the home page or in the Orion workspace.

## Ask from the home page

1. Type into the box on the home page and press **Enter**.
2. Prime decides what the first message is:
   * A **search** is a name or a few keywords, such as `sales` or `customer dataset`. Prime lists the matching items under the box. No chat is created.
   * A **question** is anything else, including a greeting or a request. It opens a new Orion Prime chat, and Prime answers there.

Only the first message is classified. Once a chat is open, every message goes into that chat. If a search finds nothing, the message opens a chat instead.

To ask an agent directly, type **@** in the box and pick the agent. This skips Prime. See [Agents](https://docs.datazone.co/reference/agents/overview.md).

While Prime is answering, you can click **Stop**. If you close the tab, Prime keeps working on the answer, and you can reopen the chat to see it.

## What Prime can use

You do not choose the tools. Prime picks the ones a question needs.

| Tool | What it does |
| - | - |
| Find | Searches the names, descriptions, column names and agent instructions of the items you can read. |
| Browse | Lists the projects you can read, and what a project holds, a page at a time. |
| Schema | Shows the columns of a dataset, view or knowledge object before Prime queries it. |
| Agent | Reads an agent's instructions, so Prime knows what the agent covers. |
| Skill | Reads a project or organisation skill when a question matches it. See [Orion Skills](https://docs.datazone.co/reference/orion/skills.md). |
| Query | Runs a `SELECT` query with a row limit, only on tables you can read, as you. |
| Vector search | Searches a vector index for text that is close in meaning to the question. |
| Chart | Turns a query result into a chart, shown in the chat. |

## Settings

Admins set Orion Prime in **Settings > AI > Orion Prime**.

| Setting | What it does |
| - | - |
| **Enable Orion Prime** | Shows Prime on the home page and in the Orion workspace. |
| **Chat model** | The model that writes Prime's answers. Falls back to the organisation's default model. |
| **Intent model** | Reads the first message to tell a search from a question. A decision model is the fastest choice. See [Decision Models](https://docs.datazone.co/reference/development/decision-models.md). Without one, every message opens a chat. |
| **Orion Prime instruction** | Extra guidance added to Prime's system prompt, up to 8,000 characters. |
| **Greeting** | Shown above the box in the Orion workspace. When it is empty, a greeting for the time of day is shown. |
| **Input placeholder** | The hint text in the empty box. |
| **Starter prompts** | Up to 6 questions, one per line, shown under the box. A click asks the question. Each line is up to 200 characters. |

## Orion workspace

The Orion page lists your chats in three sections: **Orion Prime**, **Orion Agents** and **Orion Code**. You can filter chats by type and last activity, and group them by date, type or agent. Orion Code is covered in [Orion Code](https://docs.datazone.co/reference/orion/code.md).

## Shareable chats

A new Prime chat is **Private**. Only you can see it.

To share a chat with your organisation:

1. Open the **…** menu next to the chat in the Orion sidebar.
2. Click **Share**.
3. Choose **Shared**. To stop sharing, choose **Keep private**.

Anyone in your organisation who has the link can read a shared chat. They see its questions, answers and charts, and the name of the owner.

Only the owner can do these things, even on a shared chat:

* ask new questions
* rename the chat
* delete the chat
* change whether the chat is shared

Other readers see this line where the input would be: `Shared by <name>. You can read this chat but not continue it.`

> [!WARNING]
>
> Readers see the answers and charts exactly as the owner saw them, including the data in them. Share a chat only when everyone in your organisation may see that data.

Prime answers with the permissions of the person who asks. If a second person could continue the chat, one person's questions would run with another person's access. So only the owner can continue a shared chat.

## Related

* [Orion Code](https://docs.datazone.co/reference/orion/code.md)
* [Orion Skills](https://docs.datazone.co/reference/orion/skills.md)
* [Policies](https://docs.datazone.co/reference/development/policy.md)
* [Orion AI in Intelligent Apps](https://docs.datazone.co/reference/intelligent-apps/orion-ai.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.