Skip to main content
Prompts lists every prompt in your workspace, with its product, type, status and current version. Each prompt keeps a full history: every time you save a change to the prompt, model or settings, Nucleus adds a new version and keeps the ones before it, so you can compare them or go back. Use the search box and the product, type and status filters above the list to find a prompt, then select it to open it.

​
Before you start

Tenant Owners and Workspace Admins can create prompts, go back to an earlier version and turn a prompt off. Workspace Members can open, edit and try them. Every prompt is filed under a product and a type, which Tenant Owners and Workspace Admins set up in Nucleus settings.

​
Create a prompt

The Create New Prompt form, with Prompt Name, Product, Type, Environment, Description and Content.
1

Start a prompt

Select Prompts, then New prompt.
2

Name it

Enter a Prompt Name your team will recognise.
3

Choose the product

Choose the Product.
4

Choose the type

Choose the Type.
5

Describe it

Add a Description if you want one. It shows under the name in the list.
6

Write the prompt

Under Content, write the instruction.
7

Mark what changes

Put anything that changes from one use to the next in double braces, such as {{ticket}}.
8

Create it

Select Create Prompt.
To put the first version in dev or staging straight away, choose Dev or Staging under Environment before you create it. Otherwise leave it at None. The prompt now appears in Prompts as Active. Next, try it in the playground.
To insert a variable without typing the braces, select Variables.

​
Try a prompt in the playground

The playground sends the prompt to the AI model and shows you the answer, without changing the prompt.
1

Open the prompt

Select Prompts, then the prompt.
2

Open the playground

Select Run in playground.
3

Fill in the variables

Enter a value for each variable the prompt uses.
4

Run it

Select Run.
The answer appears under Output, with the model used and how long it took. Each run is a real request to the model. Next, save a new version if you want to change the prompt.

​
Save a new version

The lower part of a prompt's editor, with Advanced configuration, the Commit message box, the release list and Save.
The Model list shows the models your workspace allows for Nucleus. Tenant Owners and Workspace Admins manage them in Studio settings, under AI Models.
1

Open the prompt

Select Prompts, then the prompt. The newest version opens in the editor.
2

Change the prompt

Edit the text under Prompt if you want to change it.
3

Change the model

Change the Model if you want.
4

Change the temperature

Change the Temperature if you want.
5

Change the max tokens

Change the Max tokens if you want.
6

Say what changed

Enter a Commit message, such as “Asks for a reason with each priority”.
7

Save

Select Save.
The new version appears at the top of Version history, marked Current, with your message and your name. Next, compare it with the version before, or release it.
Select Expand above the prompt to edit it full screen. Press Escape to close it.

​
Compare two versions

1

Open the comparison

On the prompt, select Compare.
2

Pick the first version

Choose a version in the first list.
3

Pick the second version

Choose a version in the second list. Nucleus highlights what changed in the prompt, the model, the settings and the commit message.
4

Choose the view

Select Split to see the versions side by side, or Unified to see them in one column.
5

Finish

Select Exit.
You are back in the editor. Next, go back to an earlier version if the older one was better.
While comparing, press the up and down arrow keys, or J and K, to jump between changes.

​
Go back to an earlier version

Select any version in Version history to read it. Older versions are read-only. Tenant Owners and Workspace Admins can bring one back.
1

Find the version

In Version history, find the version you want back.
2

Revert

Select Revert on that version.
3

Confirm

Confirm that you want to revert.
Nucleus adds a new version with the older content and makes it current, so nothing in the history is lost. Next, release it.

​
Turn a prompt off

Tenant Owners and Workspace Admins can turn a prompt off and on again.
1

Open the prompt

Select Prompts, then the prompt.
2

Deactivate it

Select Deactivate.
3

Confirm

Confirm that you want to deactivate it.
The prompt now shows as Inactive. It stays in your list with all its versions. To turn it back on:
1

Open the prompt

Select Prompts, then the prompt.
2

Activate it

Select Activate.
Next, check the health of your active prompts.

​
Troubleshooting

Change the prompt, the model or a setting, and enter a Commit message. Nucleus only saves a version that differs from the one before.
A new prompt has no evaluation yet, so it has not passed the quality check for staging. Write why it should start there, or choose Dev instead.
Another active prompt in your workspace has that name. Choose a different Prompt Name.
The name belongs to one of Studio’s built-in prompts. Choose a different Prompt Name.
Ask a Tenant Owner or Workspace Admin to add a type for that product in Nucleus settings.
Your workspace has no models allowed for Nucleus yet. Ask a Tenant Owner or Workspace Admin to allow one in Studio settings, under AI Models.
Only Tenant Owners and Workspace Admins can create prompts. Ask one of them to create it, then you can edit it.