Skip to main content

What Are Playbooks?

Playbooks are reusable prompt templates that standardize common investigation patterns across your team. Instead of writing the same instructions every time, create a playbook once and invoke it with a single action β€” ensuring consistent, high-quality interactions with the AI Player.

Creating a Playbook

There are two ways to create a playbook:

From Organization Settings

Navigate to Organization Settings β†’ Playbooks to manage your playbook library. Each playbook includes:
FieldDescription
TitleA short name for the playbook (unique within your organization)
DescriptionA brief explanation of when and why to use this playbook
PromptThe full prompt template that will be sent to the AI Player
CategoryOrganize by type: Documentation, Engineering, Investigation, Quality Assurance (QA), Support, or Triage
TagsCustom labels for filtering and search

From an AI Player Conversation

You can also create a playbook from an AI Player conversation:
  1. Hover over any assistant message to reveal the playbook icon (library icon)
  2. Choose From this message to base the playbook on that specific response, or From full chat to capture the overall conversation pattern
  3. The AI Player generates a playbook definition and displays it as a card in the chat
  4. Review the generated title, description, prompt, and category, then click Save to open the playbook creation form pre-filled with the generated content

Using Playbooks

There are two ways to use a playbook when starting or continuing a Player conversation:
  • Type / in the chat input to open the playbook overlay
  • Browse or search for the playbook you want
  • Use ↑↓ to navigate and Enter to select
  • The playbook prompt is inserted into your message β€” add your own context on top
  • Click the playbook icon next to the chat input
  • Browse playbooks by category or search by title, description, or tag
  • Select a playbook to attach it to your message
  • The selected playbook appears as a tile below the input
  • Type / in the stage Instructions field when creating or editing a workflow stage
  • Browse or search for the playbook you want
  • Select a playbook to insert its prompt into the stage instructions
  • This is useful for standardizing agent behavior across stages using proven prompt templates β€” see Configuring Workflows
When you submit a message with a playbook attached, the playbook’s prompt is combined with your message and sent to the AI Player together.

Managing Playbooks

From Organization Settings β†’ Playbooks, you can:
  • Create new playbooks with the create panel
  • Edit existing playbooks β€” update the title, description, prompt, category, or tags
  • Fork a playbook to create a variant without modifying the original
  • Delete playbooks you created (or any playbook if you have owner permissions)
  • Search across titles, descriptions, tags, and creator names

Get Started

πŸ‘‰ AI Player overview πŸ‘‰ Setup guide