AI Runbook Assistant
AI-drafted runbooks pinned to each ticket, grounded in your KB, prior tickets, and checklist templates
Overview
Choose Suggest runbook in a ticket's Checklists card to draft steps using related workspace content:
- Knowledge base articles, matched by semantic similarity against the ticket title and description.
- Recently resolved tickets of the same ticket type or customer, so the collective memory of past work shows up.
- Authored checklist templates, so proven playbooks keep surfacing.
A runbook is a checklist with an AI runbook badge and Regenerate and Save as template actions. You can edit steps, add notes, and check off completed work.
Enabling the feature
The runbook assistant is on by default for every workspace — AI is included with your subscription, no API key setup required. The Suggest runbook button appears in the Checklists card when your account has the required permissions.
Day-to-day usage
Draft a runbook for a ticket
- Open the ticket (
/tickets/tkt-123). - Click Suggest runbook in the Checklists card header.
- Core drafts a short list of steps, each with optional notes and estimated minutes.
- Review and edit the steps, remove anything unsuitable, add notes, and check off completed work.
Regenerate when the ticket evolves
If the ticket description has changed materially since the runbook was drafted, click Regenerate on the runbook's ribbon. Core re-runs the retrieval pipeline and replaces the step list. Completed steps with matching titles are preserved (best-effort merge).
Save a runbook as a template
Once a runbook proves out, click Save as template on the ribbon. Name the template and Core creates a reusable checklist template that the whole team can pull on future tickets. The original runbook stays on the ticket as the audit trail.
How retrieval works
Three signals feed the draft:
- Knowledge-base search — articles related to the ticket title and description. Articles for the same company rank higher. Other private company content is not included.
- Prior resolved tickets — completed work with the same ticket type or company.
- Checklist templates — workspace-wide and company-specific templates related to the ticket.
Steps cite their source (KB article id, prior ticket number, or template name) in the step note when retrieved material was used. Steps that fall outside retrieved context are produced by the model's general reasoning and are not cited.
Permissions
procedures:readandprocedures:execute— required to see and use the runbook controls.tickets:update— required to write the runbook back to the ticket.kb:read— required for KB retrieval.
Limitations
- The assistant draws only from your tenant's data; it will not reach across tenants or to the public web.
- Review technical claims before acting. Edit or remove unsuitable steps and check any cited source.
- The first call after regeneration or suggestion may take several seconds while context is assembled and the model streams its response.