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

# Prompt

> Task-oriented instructions for a single AI interaction.

A **prompt** is instructions you give an AI to do a specific task.

It's the most known asset type, so use it when you have a repeatable task like summarizing a page/document, generating a code component, writing a quick reply in a specific style. Prompts are task-scoped and are primarily used by humans to give instructions to machines what to do.

Prompts can mention [contexts](/asset-types/context) directly to give LLM the information it needs and [skills](/asset-types/skill) to complete the task in a specific, defined way.

## What goes in a prompt

* The task you want the AI to perform
* The output format you expect (bullet points, JSON, a paragraph, etc.)
* Any constraints (tone, length, things to avoid)
* Examples if the task is ambiguous

## When to use a prompt vs. other types

| You want to...                                  | Use             |
| ----------------------------------------------- | --------------- |
| Give the AI a specific task to execute          | `prompt`        |
| Define how the AI should behave and communicate | `persona`       |
| Give the AI right knowledge                     | `context`       |
| Set foundational rules for the entire session   | `system_prompt` |
| Package a reusable capability for an agent      | `skill`         |

## API value

```
"assetType": "prompt"
```

## Example

```json theme={null}
{
  "name": "Summarize support ticket",
  "assetType": "prompt",
  "content": "
  Summarize the following customer support ticket in 2-3 sentences.
  Identify the core issue, the customer's emotional state, and the suggested resolution.
  "
}
```
