AI AssistantPlaybooks

AI Playbooks

Playbooks tell an AI assistant what to achieve and how to behave, with versions you can publish or roll back. Learn to create, edit, assign and test them.

An assistant's System Prompt says who it is. A playbook says what it is trying to achieve and what rules to follow: its goals, tone, limits, safety rules and channel behavior. Playbooks are versioned, so you can change them safely and go back if a change doesn't work.

Open AI Assistant → AI Playbooks in the sidebar.

AI Playbooks only appears in the sidebar if it is turned on for your account. Only admins can link playbooks to assistants.

The Playbooks page

  • The left list shows your playbooks with their status, version number and last-updated date.
  • Click one to open it on the right. The header shows Save Draft and Publish New Version, plus Open Playground to test it.
  • The Used by: line shows which assistants follow this playbook.
  • Ten tabs hold the settings: Identity, Tone, Goals, Constraints, Safety, Channels, Tools, Model, Context, Versions.

Create a playbook

Click Create via Chat

On the Playbooks page, click Create via Chat.

Answer the questions

The builder interviews you about your business and works through Identity, Tone, Goals, Constraints, Safety, Channels and Tools. A progress bar shows where you are.

Check the draft

Use Draft Preview to read what has been captured, and Test Draft to chat with it before saving.

Name and publish

Under Finalize, enter a Playbook Name (just for your own reference). Leave Activate this playbook immediately ticked if you want it live, then click Publish Playbook.

Option 2: Start from a template

Click New Playbook

In the Create Playbook window enter a Name.

Pick a Template

Choose General Assistant (balanced default), Lead Qualification (qualify inbound leads and collect contact details) or Customer Support (troubleshoot, then hand off to a person when needed). A short description appears under the list.

Click Create

The playbook opens so you can adjust each tab.

What each tab does

TabWhat you set
IdentityBase Prompt, Persona and Display Name (the name the assistant introduces itself with).
ToneFormality (Casual / Professional / Formal), Empathy, Verbosity (Concise / Balanced / Detailed) and Custom Tone Rules (one per line).
GoalsPrimary Goal, Secondary Goals, Success Criteria (one per line) and the switch Close chat after goals met.
ConstraintsNever Mention, Never Do and Must Include.
SafetyEscalation Triggers and Escalation Threshold, Profanity Handling (Ignore / Acknowledge / Escalate), PII Handling (Collect / Redact / Refuse) and Emergency Protocol.
ChannelsTurn each channel on or off and add channel-specific prompt additions, tone and maximum reply length (use Inherit to keep the main setting).
ToolsAllowed Tools, Denied Tools and Require Approval. Advanced; most businesses leave this alone.
ModelProvider, Model ID and Temperature. Advanced.
ContextDocument IDs and Custom Instructions that apply whenever this playbook is used.
VersionsHistory of every version.

Goals work best written as a short list of what a good outcome looks like, for example "Collect name, company and email" and "Offer to book a demo". Turn on Close chat after goals met for one-shot flows such as booking or lead capture, and leave it off for support, where customers may have follow-up questions.

Save, publish and roll back

  1. Make your changes and click Save Draft to keep them without affecting live conversations.
  2. When you're happy, click Publish New Version. It becomes the active version.
  3. Open the Versions tab to see all versions. For each you can:
    • View: see its details and a "Diff vs Active" comparison.
    • Load into Editor: copy it into the editor (this overwrites what you're currently editing, so you're asked to confirm).
    • Activate: make that version live. Use this to roll back.

Use a playbook with an assistant

An assistant follows one playbook at a time. There are two ways to connect them (admins only):

From the Playbooks page

  1. Open the playbook and click Assign to assistants.
  2. Tick the assistants that should use it. If an assistant already uses a different playbook, a note says it will be switched.
  3. Click Save assignments. Unticking an assistant removes the playbook from it.

From the assistant

  1. Go to AI Assistant → Assistants and click Edit on the assistant.
  2. Choose a playbook in the Playbook list (or No playbook) and save.

See AI Assistants.

Duplicate or archive

Click the ⋮ (Playbook actions) menu on a playbook in the list:

  • Duplicate makes a copy you can change without touching the original. Great for Experiments.
  • Archive removes it from use. To bring an archived playbook back, contact support.

Test a playbook

Click Open Playground, pick an assistant that uses the playbook, and chat as a customer would. See Widget Playground.