# Concepts

### <i class="fa-buildings" style="color:$primary;">:buildings:</i>  Workspace

A <mark style="color:$primary;">workspace</mark> is the top-level home for a team's <mark style="color:$primary;">prompts</mark>, <mark style="color:$primary;">versions</mark>, <mark style="color:$primary;">API keys</mark>, <mark style="color:$primary;">members</mark>, <mark style="color:$primary;">activity</mark>, and <mark style="color:$primary;">integrations</mark>.

| Property                                     | Notes                                                                              |
| -------------------------------------------- | ---------------------------------------------------------------------------------- |
| <mark style="color:$primary;">Name</mark>    | Display name shown in the sidebar.                                                 |
| <mark style="color:$primary;">Owner</mark>   | The person who created or owns the <mark style="color:$primary;">workspace</mark>. |
| <mark style="color:$primary;">Staging</mark> | Optional workflow that lets test keys read a staged version before it goes live.   |

A user can belong to one <mark style="color:$primary;">workspace</mark>. The dashboard opens the active <mark style="color:$primary;">workspace</mark> for the signed-in user.

### <i class="fa-users" style="color:$primary;">:users:</i>  Members and roles

Every <mark style="color:$primary;">member</mark> is either an <mark style="color:$primary;">`owner`</mark> or a <mark style="color:$primary;">`member`</mark>.

| Capability                                                                                                        | Owner                                                                 | Member                                                                |
| ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------- |
| Create/edit/delete <mark style="color:$primary;">prompts</mark> and <mark style="color:$primary;">versions</mark> | <i class="fa-square-check" style="color:$primary;">:square-check:</i> | <i class="fa-square-check" style="color:$primary;">:square-check:</i> |
| Create and revoke <mark style="color:$primary;">API keys</mark>                                                   | <i class="fa-square-check" style="color:$primary;">:square-check:</i> | <i class="fa-square-check" style="color:$primary;">:square-check:</i> |
| Manage <mark style="color:$primary;">integrations</mark>                                                          | <i class="fa-square-check" style="color:$primary;">:square-check:</i> | <i class="fa-square-check" style="color:$primary;">:square-check:</i> |
| Toggle <mark style="color:$primary;">workspace</mark> settings                                                    | <i class="fa-square-check" style="color:$primary;">:square-check:</i> | <i class="fa-square-check" style="color:$primary;">:square-check:</i> |
| Invite or remove <mark style="color:$primary;">members</mark>                                                     | <i class="fa-square-check" style="color:$primary;">:square-check:</i> | <i class="fa-square-xmark" style="color:$danger;">:square-xmark:</i>  |
| View pending <mark style="color:$primary;">invitations</mark>                                                     | <i class="fa-square-check" style="color:$primary;">:square-check:</i> | <i class="fa-square-xmark" style="color:$danger;">:square-xmark:</i>  |

### <i class="fa-terminal" style="color:$primary;">:terminal:</i>  Prompt

A <mark style="color:$primary;">prompt</mark> is the unit of "the thing the LLM reads." It is identified by a <mark style="color:$primary;">slug</mark> that is unique inside its <mark style="color:$primary;">workspace</mark>.

| Field                                                | Purpose                                                                                                                                                        |
| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:$primary;">Slug</mark>            | URL-safe identifier, such as <mark style="color:$primary;">`support-triage`</mark> or <mark style="color:$primary;">`onboarding-email`</mark>.                 |
| <mark style="color:$primary;">Folder</mark>          | Sidebar grouping.                                                                                                                                              |
| <mark style="color:$primary;">Model</mark>           | Human-facing model hint.                                                                                                                                       |
| <mark style="color:$primary;">Temperature</mark>     | Suggested generation temperature returned by the <mark style="color:$primary;">SDK</mark>.                                                                     |
| <mark style="color:$primary;">Live version</mark>    | <mark style="color:$primary;">Version</mark> served to <mark style="color:$primary;">`pv_live_`</mark> keys.                                                   |
| <mark style="color:$primary;">Staging version</mark> | <mark style="color:$primary;">**Optional**</mark> <mark style="color:$primary;">version</mark> served to <mark style="color:$primary;">`pv_test_`</mark> keys. |
| <mark style="color:$primary;">Draft</mark>           | Current <mark style="color:$primary;">editor</mark> buffer.                                                                                                    |

### <i class="fa-code-compare" style="color:$primary;">:code-compare:</i>  Version

A <mark style="color:$primary;">version</mark> is a snapshot of the <mark style="color:$primary;">prompt</mark> source.

| Field                                        | Notes                                                                                                                                                              |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <mark style="color:$primary;">Label</mark>   | Auto-incremented per <mark style="color:$primary;">prompt</mark>, such as <mark style="color:$primary;">`v1`</mark> or <mark style="color:$primary;">`v22`</mark>. |
| <mark style="color:$primary;">Status</mark>  | <mark style="color:$primary;">`live`</mark> or <mark style="color:$primary;">`draft`</mark>.                                                                       |
| <mark style="color:$primary;">Source</mark>  | The <mark style="color:$primary;">prompt</mark> body at that point in history.                                                                                     |
| <mark style="color:$primary;">Message</mark> | Commit-style note explaining the change.                                                                                                                           |
| <mark style="color:$primary;">Author</mark>  | The <mark style="color:$primary;">workspace</mark> member who saved it.                                                                                            |

When you save in the editor, you choose a target:

* <mark style="color:$primary;">**Draft**</mark> saves a checkpoint without changing <mark style="color:$primary;">live</mark> or <mark style="color:$primary;">staging</mark> reads.
* <mark style="color:$primary;">**Staging**</mark> saves a <mark style="color:$primary;">draft</mark> and makes it visible to <mark style="color:$primary;">`pv_test_`</mark> keys.
* <mark style="color:$primary;">**Live**</mark> publishes a <mark style="color:$primary;">version</mark> to <mark style="color:$primary;">`pv_live_`</mark> keys.

### <i class="fa-key" style="color:$primary;">:key:</i>  API keys

API keys authenticate SDK reads.

| Key type                                           | Resolves to                                                               |
| -------------------------------------------------- | ------------------------------------------------------------------------- |
| <mark style="color:$primary;">`pv_live_...`</mark> | The prompt's live version.                                                |
| <mark style="color:$primary;">`pv_test_...`</mark> | The prompt's staging version, falling back to live when staging is unset. |

Use <mark style="color:$primary;">`pv_test_`</mark> keys in CI, preview environments, and staging environments. Use <mark style="color:$primary;">`pv_live_`</mark> keys in production. \
\&#xNAN;*\* <mark style="color:$primary;">`pv_test_`</mark> keys can only be used if <mark style="color:$primary;">**Staging**</mark> option is enabled*

### <i class="fa-wave-pulse" style="color:$primary;">:wave-pulse:</i>  Activity

Activity records meaningful <mark style="color:$primary;">workspace</mark> actions such as creating prompts, saving <mark style="color:$primary;">versions</mark>, rolling back, connecting <mark style="color:$primary;">integrations</mark>, and deleting <mark style="color:$primary;">prompts</mark>. Use the <mark style="color:$primary;">Activity</mark> feed to answer "what changed?" and "who did it?"

### <i class="fa-webhook" style="color:$primary;">:webhook:</i>  Integrations

A <mark style="color:$primary;">workspace</mark> can connect to <mark style="color:$primary;">Langfuse</mark>, <mark style="color:$primary;">Helicone</mark>, <mark style="color:$primary;">Braintrust</mark>, <mark style="color:$primary;">Webhook</mark>, <mark style="color:$primary;">PostHog</mark>, and <mark style="color:$primary;">GitHub</mark>. <mark style="color:$primary;">Integrations</mark> receive <mark style="color:$primary;">prompt</mark> lifecycle events and let your existing tools handle traces, evals, audit, or external mirrors.

### <i class="fa-microchip-ai" style="color:$primary;">:microchip-ai:</i>  AI Evaluator

The <mark style="color:$primary;">AI Evaluator</mark> perform daily reviews of <mark style="color:$primary;">prompts</mark> and surfaces issues that need attention.&#x20;


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://aiso.gitbook.io/promptvault/documentation/getting-started/concepts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.