Prompts
Create a prompt
New prompts always start in Draft. You'll author the content, save iteratively, and promote to Active when it's ready for production agents.
What you'll learn
- How to scaffold a new prompt in the library
- How to write content in markdown
- When to add tags and a description
- How to save and continue iterating in Draft
Open the prompt editor
Go to Prompts in the sidebar, then click + New Prompt. The editor opens with a blank Draft version. Five fields drive the prompt; only Name and Content are required.
Fill the prompt fields
- 1
Name
Short, lowercase-friendly, action-led. Examples: "support-classifier", "brand-voice", "refusal-policy". The name is permanent — picks it once. - 2
Description
One sentence: what the prompt does and when to attach it. This is what teammates see in the Skills picker inside the agent builder. - 3
Content
Write the prompt body in markdown. Use headings, lists, and code blocks freely — LLMs handle markdown structure well. Declare template variables at the top in a Variables section so attachments know what to supply. - 4
Tags
Free-text labels for organization. Examples: "classification", "voice", "compliance". Tags drive search and filter in the library. - 5
Visibility
Private — only the author and admins can attach. Public — any workspace member can attach to their agents. Start Private; promote to Public after review.
Save and iterate
- 1
Save Draft
Click Save to persist the version. The prompt now appears in the library with status Draft. It cannot be attached to a production agent yet. - 2
Preview
Use the preview panel to render template variables with sample values. Catch unfilled variables and bad markdown before you activate. - 3
Test with an agent
Attach the Draft to a test agent. Send representative inputs and inspect the trace. Iterate in the editor — every Save updates the Draft in place. - 4
Promote to Active
When the content is right, click Activate. Status flips to Active and the prompt is attachable from any agent.
Frequently asked questions
- Can I duplicate an existing prompt as a starting point?
- Yes. Open any prompt and click Duplicate. A new prompt is created with the same content as a fresh Draft — useful for forking when a new use case diverges from an existing one.
- How long can a prompt be?
- Practical limit is whatever fits comfortably inside your target model's context window alongside user input and retrieved chunks. For most production prompts that's under 2,000 tokens. Longer prompts cost more on every call and can dilute instruction following.
- Can I include examples or few-shot demonstrations?
- Yes. Few-shot examples inside the prompt body work well — wrap them in a Examples markdown section. Keep them short and representative; too many examples can overfit the model to surface patterns.