Pylon
Knowledge BaseWebsiteChangelogBook a DemoLogin
  • Getting Started
    • Introduction
    • Quick Start
    • Slack Setup
    • Channel Configuration
    • User Guide
    • Pylonboarding
      • Issue Views
      • Teams
      • Account Management
      • Knowledge Base
      • Chat Widget
      • SLAs
  • Support Workflows
    • Omnichannel Support
    • Issues
      • Views
      • Statuses
      • Message Editor
      • Copilot
      • Sidebar
      • Internal Threads
      • Proactive Issues
      • Translation
      • Bulk actions
      • Issue Groups
    • SLAs
    • Support Hours
    • CSAT
    • Ticket Forms
    • Assignment Rules
      • User Status
    • Email
  • Platform
    • Custom Fields
    • Required and Conditional Fields
    • Tags
    • Teams
    • Triggers
      • Logs & History
    • Macros
    • Command Search
    • Roles & User Management
    • Training Data
    • Ask AI
  • AI Agents
    • Overview
    • Build
      • Resources
      • Runbooks
    • Test
    • Deploy
    • Monitor & Iterate
  • Knowledge Base
    • Overview
    • Articles & Collections
      • Editor
      • Copilot
      • Templates
      • Collaboration
    • Knowledge Gaps
    • Styling & Customization
    • Custom Authentication
    • Search
    • Translation
  • Customer Portal
    • Overview
    • Styling & Customization
    • Access Control
    • Portal Experience
    • Custom Authentication
  • Chat Widget
    • Overview
    • Styling
    • Functionality
    • Chat Experience
    • Chat Setup
    • Identity Verification
    • JavaScript API
  • Account Management
    • Accounts
    • Views
    • Notebooks
      • Blocks
    • Highlights
    • Fields
    • Copilot
    • Activities
      • Custom Activities
    • Sidebar
  • Reporting & Analytics
    • Analytics
    • Default Dashboards
    • Custom Dashboards
  • Broadcasts
    • Overview
    • Create a Broadcast
    • Analytics
  • Integrations
    • CRM
      • Salesforce
      • Hubspot
      • Attio
      • Pipedrive
    • Ticketing
      • Linear
      • GitHub Issues
      • Asana
      • Jira
    • Alerting
      • PagerDuty
      • Opsgenie
    • Chat
      • Slack
        • Internal Threads
        • Collect Data
        • Support Ticket Flow
        • Welcome Message
        • Bookmarks
        • Onboard Employees
        • Left Company
        • Slack Community
      • Microsoft Teams
      • Discord
    • Incident Management
      • incident.io
    • Call Recording
      • Gong
      • Fathom
      • Grain
      • Fireflies
  • Data Warehouse
    • Snowflake
    • BigQuery
  • Calendar
    • Google Calendar
    • Outlook Calendar
  • Developer
    • API
      • Authentication
      • Errors
      • API reference
        • Attachments
        • Accounts
          • Activities
          • Highlights
        • Contacts
        • Custom Fields
        • Issues
        • Knowledge Base
        • Me
        • Messages
        • Tags
        • Teams
        • Ticket Forms
        • User roles
        • Users
      • External IDs
    • Custom Apps
    • Embedded Iframes
    • Webhooks
Powered by GitBook
On this page
  • Actions
  • Variables
  • Steps
  • Testing
  • Human-guided Runbooks

Was this helpful?

  1. AI Agents
  2. Build

Runbooks

Give your agents manuals to execute complex procedures.

PreviousResourcesNextTest

Last updated 3 days ago

Was this helpful?

Write instructions in natural language to help your AI Agent handle specific scenarios. When your AI Agents are assigned to issues, they will determine the most relevant runbook they have access to and start executing it.

You can think of Runbooks as having the power of programming, but with the simplicity of writing a document with steps.

Actions

By default, AI Agents have a whole set of Pylon actions available to them, including responding to customers, leaving internal notes, setting custom fields, and more.

Variables

Actions and Runbooks allow scoped variables available to make your Runbook execution as flexible as possible. These variables can exist only in the Runbook or come from other fields in Pylon. For example, you can use variables in the body of API calls or as a way to pass information between steps in a Runbook. Use the {{ characters to see available variables or create a new one.

Steps

Runbooks consist of a sequence of steps that each use actions, variables, and natural language.

Chain together steps to create an end-to-end workflow for how an Agent should handle a certain scenario.

Runbooks can involve customer interaction or be fully internal facing!

Here's an example of a Runbook step:

Note that since the step is in natural language, mentioning the account ID is a 5 digit alphanumeric value means we get natural enforcement and validation from the AI. For example, if the user provides something 6 digits long, the AI will re-prompt them with a suggestion for the correct prompting.

It will take some iterating to prompt the AI in the manner that's best for the workflow you are trying to create!

Testing

Runbooks can also be tested in isolation of AI agents using the tester on the runbook page.

Human-guided Runbooks

A team member can then directly step through exection of steps in the runbook, guided by the AI copilot.

Agents have the ability to perform actions inside and outside Pylon. On the page in Settings, view all the actions available to the agent and configure additional custom actions, like API calls.

Runbooks can not only be executed directly by AI agents, but also by humans on your team directly. Runbooks are accessible in the Copilot tab of the issue sidebar, and will be suggested by .

Actions
Issue Suggestions
A runbook for handing hardware failure issues
Example of GET API call definition