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

# Nucleus overview

> What Nucleus does, who uses it, how it is laid out, and how a prompt goes from a first draft to production.

Nucleus is where your team writes and looks after your workspace's AI prompts. A prompt is the instruction an AI model works from, such as "read this ticket and give it a category and a priority". In Nucleus you keep every version of a prompt, try a change before anyone relies on it, test versions against sample inputs, and release the version you trust. You can then see how each prompt performs and what it costs.

Nucleus holds your workspace's own prompts. It does not change the built-in prompts behind Studio's own features. It is also not where you decide which AI models your workspace may use: Tenant Owners and Workspace Admins do that in Studio settings, under **AI Models**.

Nucleus is for the people who build and look after your AI. Tenant Owners and Workspace Admins can do everything in it. Workspace Members work on prompts, datasets and evaluations day to day.

## How Nucleus is laid out

<Frame>
  <img src="https://mintcdn.com/intellikon-ai-ltd/wM16d87Um0QW2CyJ/images/nucleus/overview.png?fit=max&auto=format&n=wM16d87Um0QW2CyJ&q=85&s=da2fcb8af2b3ffdb77b94b2468107c80" alt="The top of the Nucleus Dashboard, with Total prompts, Healthy, At risk and Workspace resolution, and the first prompts with their health scores." width="1096" height="1480" data-path="images/nucleus/overview.png" />
</Frame>

| Area              | What you do there                                                                    |
| ----------------- | ------------------------------------------------------------------------------------ |
| **Dashboard**     | See a health score for each of your active prompts.                                  |
| **Prompts**       | Write prompts, save versions and release them.                                       |
| **Datasets**      | Keep sets of sample inputs to test prompts with.                                     |
| **Evaluations**   | Run prompts against inputs and score the answers.                                    |
| **Analytics**     | See runs, tokens and cost from the playground and evaluations over the last 30 days. |
| **Health**        | Get alerts when a prompt's scores start to slip.                                     |
| **Observability** | Look at individual AI requests, with the model, time taken and cost.                 |
| **API Keys**      | Create keys that let your own software use your released prompts.                    |
| **Inbox**         | Read notifications about your prompts.                                               |
| **Settings**      | Set up the products and types you file prompts under.                                |

## Key ideas

<CardGroup cols={2}>
  <Card title="Prompt" icon="sparkle">An instruction for an AI model, filed under a product and a type.</Card>
  <Card title="Version" icon="history">Each save that changes the prompt, model or settings adds a version, and the versions before it stay in the history.</Card>
  <Card title="Environment" icon="server">**dev**, **staging** or **production**, each holding one version of a prompt at a time.</Card>
  <Card title="Dataset" icon="database">A set of sample inputs to test prompts against.</Card>
  <Card title="Evaluation" icon="flask-conical">A run of a prompt against inputs, with the answers scored by any scorers you add.</Card>
  <Card title="Scorer" icon="clipboard-check">The marking guide an AI judge uses to score an answer.</Card>
</CardGroup>

## From draft to production

You write a prompt and save a new version each time you improve it. When a version is ready, you promote it to an environment. Before it moves, Nucleus checks the version's latest automatic evaluation. A version that passed goes straight through. Otherwise, what happens depends on the prompt's quality gate: Nucleus lets it through, asks you to say why it should go ahead, or stops it unless a Tenant Owner or Workspace Admin gives a reason.

## Who can do what

| Task                                                                                             | Tenant Owner | Workspace Admin | Workspace Member |
| ------------------------------------------------------------------------------------------------ | ------------ | --------------- | ---------------- |
| Open **Dashboard**, **Prompts**, **Datasets**, **Evaluations**, **Health** and **Observability** | Yes          | Yes             | Yes              |
| Create a prompt                                                                                  | Yes          | Yes             | No               |
| Edit a prompt and save versions                                                                  | Yes          | Yes             | Yes              |
| Go back to an earlier version, or turn a prompt off and on                                       | Yes          | Yes             | No               |
| Promote a version to **dev** or **staging**                                                      | Yes          | Yes             | Yes              |
| Promote a version to **production**                                                              | Yes          | Yes             | No               |
| Set a prompt's release policy                                                                    | Yes          | Yes             | No               |
| Create datasets and run evaluations                                                              | Yes          | Yes             | Yes              |
| Create and change scorers                                                                        | Yes          | Yes             | No               |
| Open **Analytics**                                                                               | Yes          | Yes             | No               |
| Change **Settings**                                                                              | Yes          | Yes             | No               |
| Create API keys                                                                                  | Yes          | Yes             | No               |
| Open **Inbox**                                                                                   | Yes          | Yes             | Yes              |

## Where to start

<CardGroup cols={2}>
  <Card title="Write a prompt" icon="sparkle" href="/products/nucleus/prompts">Create a prompt, try it and save new versions.</Card>
  <Card title="Release a version" icon="circle-arrow-up" href="/products/nucleus/releasing-prompts">Promote a version to dev, staging or production.</Card>
  <Card title="Test your prompts" icon="flask-conical" href="/products/nucleus/datasets-and-evaluations">Build datasets, run evaluations and score the answers.</Card>
  <Card title="Watch how they perform" icon="heart-pulse" href="/products/nucleus/monitoring">Check health scores, alerts, requests and cost.</Card>
</CardGroup>

Tenant Owners and Workspace Admins set up the products and types prompts are filed under in [Nucleus settings](/products/nucleus/settings).

## Related products

<CardGroup cols={2}>
  <Card title="Vera" icon="https://mintcdn.com/intellikon-ai-ltd/wM16d87Um0QW2CyJ/icons/products/vera.svg?fit=max&auto=format&n=wM16d87Um0QW2CyJ&q=85&s=8842a18229395dd5f8e4bc43815fdced" href="/products/vera/overview" width="32" height="32" data-path="icons/products/vera.svg">Chatbots that answer from your own knowledge.</Card>
  <Card title="Get started" icon="rocket" href="/get-started/find-your-way-around">Move between products and find Studio settings.</Card>
</CardGroup>
