Skip to main content
Assistants are specialised helpers that extend what your Digital Twin can do — a tutor, a grader, a report writer. Each assistant carries its own instructions (its system prompt), can use its own conversation model, and can be personal, shared with the Digital Twin, or shared across the account.
An assistant adds to the twin; it does not replace it. Its instructions (and, optionally, its own model) sit on top of the Digital Twin’s configuration for the conversations that use it. The twin’s instructions, knowledge files and integrations stay in place. An assistant set to Unpublished is visible only to the person who created it; it never appears in anyone else’s picker or in the Convo Mode switcher.
Managing assistants requires the assistants.list, assistants.add, assistants.edit, or assistants.delete entitlements. See Entitlements for details.

​
Where You Manage Assistants

Assistant Settings

​
Creating an Assistant

1

Open the tab where the assistant belongs

In the Assistants window, open the tab the new assistant should live in — Personal, your Digital Twin’s tab or the account tab — then select Add. The assistant is created in the tab you are on. Only the people who manage the twin’s assistants can add one for everyone; anyone else’s new assistant is saved to Personal, and the window says so. You can also select Add in Admin › Assistants.
2

Fill in the details

3

Set who can use it

  • Share with Instance — available to everyone in the Digital Twin. When off, the assistant is personal.
  • Share across Account — also available in every Digital Twin of the same account.
  • Admin Only — visible to administrators only.
  • Editable by others — others may change the assistant’s instructions.
4

Save

Save the assistant. If it is shared and Active, it appears in the Assistants window for the people it is shared with.

​
Editing Assistants

Open an assistant from the Assistants window or from Admin › Assistants to change its instructions, model, variables, sharing, collections and tools. Assistant Update
Changes take effect immediately for everyone who uses the assistant. Consider testing significant instruction changes during low-usage periods.

​
Who Can Use and Create Assistants

These switches are in the admin editor’s Assistants tab (in the Studio UI: Hide assistants from people, Except these email domains and Stop people creating assistants). They apply to regular users only; admins keep full access.

​
Enabling and Disabling

Switch an assistant on or off for your Digital Twin:
  • Enabled — the assistant is available to members.
  • Disabled — the assistant is hidden from members but kept.
Assistant Disable Administrators of the Digital Twin can flip this right on the card in the Assistants window: every card and table row shows an Enabled switch, and the ⋮ menu offers Disable in <twin> / Enable in <twin>. A disabled assistant dims, carries a Disabled badge and drops out of the list for everyone else. It is hidden from your own view too until you tick Show disabled, which also shows how many are switched off; each tab’s count reads enabled of total (for example 10/12) when some are disabled. The checklist under Instance Settings → Assistants does the same job. Disabling is useful to remove an assistant during maintenance, hide seasonal assistants, or keep a draft without showing it.

​
Moving an Assistant to a Wider Scope

An assistant that should serve the whole twin, or every twin under the account, does not have to be re-created: drag its card onto the twin tab or the account tab at the top of the Assistants window, or open its ⋮ menu and choose Move to <twin> / Move to <account>. The move applies at once — the assistant is shared at that level, leaves the tab it came from, and a short confirmation names the destination. A twin-shared assistant can move up to the account and back down to the twin.
  • Only administrators of the twin who may edit the assistant can move it — the same people who may change Share with Instance / Share across Account in the editor.
  • The account tab is offered only when the twin belongs to an account.
  • Your own assistants can be dragged back onto Personal (or ⋮ → Move to Personal), which stops sharing them. An assistant someone else owns cannot be moved to Personal — only its owner can un-share it.
  • Built-in System assistants never move.

​
Assistants in Convo Mode

A conversation that runs an assistant keeps it when a member starts talking. Every assistant of the Digital Twin can be used in Convo Mode unless Restrict use of assistants is on in Instance Settings › Voice; then only the assistants checked there can be used, and members can switch between them during a call. The Available in Realtime / Convo check in the admin editor adds an assistant to that list; it has no effect while the restriction is off. When the twin talks through ElevenLabs, Anam, Cartesia or GPT-Live, the editor also offers STS / Voice Conversation Model and STS / Voice Reasoning Effort, which apply only to this assistant’s spoken turns. Left empty, voice turns use the assistant’s conversation model and the twin’s voice settings. See Realtime Voice & Avatars.

​
Variables in Assistants

Assistants support substitution variables — placeholders like ${variable_name} that Pria replaces with a value when the assistant runs. Use them for webhook URLs, quiz or course IDs, and instruction blocks shared by several assistants. Create and insert them from the Variables panel of the Instructions tab.
A variable’s value is put into the prompt the model reads, so treat it like prompt text: a user can sometimes get the model to repeat it. Do not store passwords or long-lived API keys in variables. See Variables.

​
Model Override

By default, an assistant uses the Digital Twin’s conversation model. Set Conversation Model to use a different one — a more capable model for complex analysis, or a faster one for simple lookups. Pick a current model: an assistant set to a deprecated model keeps using it until you change it.

​
RAG Collection Scope

By default, an assistant searches all the files included in search. You can restrict it to specific collections.
1

Open the RAG & Tools tab

Open the assistant and select the RAG & Tools tab.
2

Select collections

Use RAG Collection Scope to choose one or more collections; the assistant searches the files of all of them. Leave it empty to search all collections. A shared assistant lists the Digital Twin’s collections; a personal one lists your own.
3

Save

Save the assistant.
Use collection scoping to build focused assistants — for example, an HR assistant that only searches HR policy documents, or a course assistant that only searches the materials of one course.

​
Per-Assistant Tool Configuration

By default, an assistant can use every tool switched on for the Digital Twin. Tool Mode narrows that: In Convo Mode, an assistant limited to selected tools always has those tools, even ones otherwise switched off for voice conversations.
A tool switched off for the whole Digital Twin stays off, even if an assistant lists it.

​
Required Permissions