playbook-generation

Process Automation Designer Playbook Generation

Overview

This skill covers generating ServiceNow Process Automation Designer (PAD) playbooks from natural language descriptions:

Creating standard playbooks for automated process execution
Building agent-facing playbooks with guided interaction steps
Defining lanes for parallel and sequential work streams
Adding activities: data gathering, approvals, decisions, notifications
Configuring data inputs and outputs for playbook context
Setting up stage-based progression through multi-phase processes
Connecting playbooks to catalog items, incidents, cases, and other record types

When to use: When building guided process automation, creating agent-facing workflows with data collection steps, or automating multi-lane business processes that require human and system interaction.

Prerequisites

Roles: process_automation_designer or admin
Plugins: com.snc.process_flow (Process Automation Designer), com.glide.hub.flow_designer (Flow Designer)
Access: sys_process_flow, sys_pd_activity, sys_pd_lane, sys_pd_transition tables
Knowledge: Basic understanding of Process Automation concepts (playbooks, lanes, activities, stages)
Related Skills: genai/flow-generation for Flow Designer flows, genai/skill-kit-custom for Now Assist skill integration

Procedure

Step 1: Analyze the Natural Language Description

Parse the user's request to identify:

Playbook type: Standard (automated) or agent-facing (interactive)
Target table: Which record type the playbook supports (incident, case, change_request, sc_req_item)
Lanes: Parallel work streams or role-based separation of tasks
Activities: Steps the playbook should execute (data collection, approvals, notifications, subflows)
Stages: Major phases of the process (e.g., Triage, Investigation, Resolution)
Conditions: Decision points and branching logic

Step 2: Query Existing Playbooks for Patterns

MCP Approach:

Use SN-Query-Table on sys_process_flow:
  - query: active=true^sys_class_name=sys_pd_playbook
  - fields: sys_id,name,description,table,playbook_type,active,status
  - limit: 10

REST Approach:

GET /api/now/table/sys_process_flow
  ?sysparm_query=active=true^sys_class_name=sys_pd_playbook
  &sysparm_fields=sys_id,name,description,table,playbook_type,active,status
  &sysparm_limit=10

Query existing playbook activities for reusable patterns:

Use SN-Query-Table on sys_pd_activity:
  - query: playbook=<playbook_sys_id>
  - fields: sys_id,name,activity_type,lane,order,stage
  - limit: 50

Step 3: Create the Playbook Record

Standard Playbook (automated):

MCP Approach:

Use SN-Create-Record on sys_pd_playbook:
  - name: "Incident Resolution Playbook"
  - description: "Guides agents through structured incident resolution process"
  - table: "incident"
  - playbook_type: "standard"
  - status: "draft"
  - active: false
  - trigger_type: "record"
  - trigger_condition: "priority<=2^category=network"

REST Approach:

POST /api/now/table/sys_pd_playbook
Body: {
  "name": "Incident Resolution Playbook",
  "description": "Guides agents through structured incident resolution process",
  "table": "incident",
  "playbook_type": "standard",
  "status": "draft",
  "active": false,
  "trigger_type": "record",
  "trigger_condition": "priority<=2^category=network"
}

Agent-Facing Playbook (interactive):

Use SN-Create-Record on sys_pd_playbook:
  - name: "Customer Onboarding Playbook"
  - description: "Interactive playbook guiding agents through customer onboarding"
  - table: "sn_csm_case"
  - playbook_type: "agent_facing"
  - status: "draft"
  - active: false

Step 4: Define Playbook Stages

Stages represent major phases of the process.

MCP Approach:

Use SN-Create-Record on sys_pd_stage:
  - playbook: "<playbook_sys_id>"
  - name: "Triage"
  - label: "Triage"
  - order: 100
  - description: "Initial assessment and categorization"

Use SN-Create-Record on sys_pd_stage:
  - playbook: "<playbook_sys_id>"
  - name: "Investigation"
  - label: "Investigation"
  - order: 200
  - description: "Root cause analysis and troubleshooting"

Use SN-Create-Record on sys_pd_stage:
  - playbook: "<playbook_sys_id>"
  - name: "Resolution"
  - label: "Resolution"
  - order: 300
  - description: "Apply fix and verify resolution"

REST Approach:

POST /api/now/table/sys_pd_stage
Body: {
  "playbook": "<playbook_sys_id>",
  "name": "Triage",
  "label": "Triage",
  "order": 100,
  "description": "Initial assessment and categorization"
}

Step 5: Create Lanes

Lanes define parallel work streams or role-based task groupings.

Key lane types:

Lane Type	Description	Use Case
System	Automated actions without user interaction	Background tasks, notifications
Agent	Tasks performed by the assigned agent	Data collection, manual steps
Approval	Approval-specific lane	Manager or CAB approvals
Customer	Customer-facing activities	Self-service data gathering

MCP Approach:

Use SN-Create-Record on sys_pd_lane:
  - playbook: "<playbook_sys_id>"
  - name: "Agent Lane"
  - lane_type: "agent"
  - order: 100
  - description: "Primary agent activities"

Use SN-Create-Record on sys_pd_lane:
  - playbook: "<playbook_sys_id>"
  - name: "System Lane"
  - lane_type: "system"
  - order: 200
  - description: "Automated background processing"

REST Approach:

POST /api/now/table/sys_pd_lane
Body: {
  "playbook": "<playbook_sys_id>",
  "name": "Agent Lane",
  "lane_type": "agent",
  "order": 100,
  "description": "Primary agent activities"
}

Step 6: Add Activities

Activities are the individual steps within the playbook.

Common activity types:

Activity Type	Value	Description
Data Gathering	data_gathering	Collect information from user or agent
Decision	decision	Branch based on conditions
Approval	approval	Request approval from users
Notification	notification	Send email or push notification
Subflow	subflow	Execute a Flow Designer subflow
Update Record	update_record	Modify the playbook context record
Wait	wait	Pause until condition is met
Complete Stage	complete_stage	Mark a stage as finished

Data Gathering Activity (Agent-Facing):

MCP Approach:

Use SN-Create-Record on sys_pd_activity:
  - playbook: "<playbook_sys_id>"
  - lane: "<agent_lane_sys_id>"
  - stage: "<triage_stage_sys_id>"
  - name: "Gather Incident Details"
  - activity_type: "data_gathering"
  - order: 100
  - mandatory: true
  - description: "Collect key incident information from the caller"

Decision Activity:

Use SN-Create-Record on sys_pd_activity:
  - playbook: "<playbook_sys_id>"
  - lane: "<system_lane_sys_id>"
  - stage: "<triage_stage_sys_id>"
  - name: "Check Priority Level"
  - activity_type: "decision"
  - order: 200
  - condition: "current.priority <= 2"
  - description: "Route based on incident priority"

Approval Activity:

Use SN-Create-Record on sys_pd_activity:
  - playbook: "<playbook_sys_id>"
  - lane: "<approval_lane_sys_id>"
  - stage: "<investigation_stage_sys_id>"
  - name: "Manager Approval"
  - activity_type: "approval"
  - order: 300
  - approval_type: "approve_reject"
  - approvers: "current.assignment_group.manager"
  - due_date_interval: "2 days"

Step 7: Configure Data Inputs for Activities

Data inputs define what information is collected in data gathering activities.

MCP Approach:

Use SN-Create-Record on sys_pd_data_input:
  - activity: "<data_gathering_activity_sys_id>"
  - name: "affected_ci"
  - label: "Affected Configuration Item"
  - type: "reference"
  - reference_table: "cmdb_ci"
  - mandatory: true
  - order: 100
  - help_text: "Select the CI experiencing the issue"

Use SN-Create-Record on sys_pd_data_input:
  - activity: "<data_gathering_activity_sys_id>"
  - name: "impact_description"
  - label: "Business Impact"
  - type: "string"
  - mandatory: true
  - order: 200
  - help_text: "Describe how this incident impacts business operations"

Use SN-Create-Record on sys_pd_data_input:
  - activity: "<data_gathering_activity_sys_id>"
  - name: "users_affected"
  - label: "Number of Users Affected"
  - type: "integer"
  - mandatory: false
  - order: 300

REST Approach:

POST /api/now/table/sys_pd_data_input
Body: {
  "activity": "<data_gathering_activity_sys_id>",
  "name": "affected_ci",
  "label": "Affected Configuration Item",
  "type": "reference",
  "reference_table": "cmdb_ci",
  "mandatory": true,
  "order": 100
}

Step 8: Define Transitions Between Activities

Transitions control the flow between activities including conditional routing.

MCP Approach:

Use SN-Create-Record on sys_pd_transition:
  - playbook: "<playbook_sys_id>"
  - source_activity: "<activity_1_sys_id>"
  - target_activity: "<activity_2_sys_id>"
  - condition: ""
  - order: 100
  - label: "Proceed to investigation"

Conditional Transition (from Decision):

Use SN-Create-Record on sys_pd_transition:
  - playbook: "<playbook_sys_id>"
  - source_activity: "<decision_activity_sys_id>"
  - target_activity: "<high_priority_activity_sys_id>"
  - condition: "result == 'yes'"
  - order: 100
  - label: "High Priority Path"

Use SN-Create-Record on sys_pd_transition:
  - playbook: "<playbook_sys_id>"
  - source_activity: "<decision_activity_sys_id>"
  - target_activity: "<standard_activity_sys_id>"
  - condition: "result == 'no'"
  - order: 200
  - label: "Standard Priority Path"

Step 9: Set Up Playbook Context

Playbook context connects the playbook to runtime execution data.

MCP Approach:

Use SN-Query-Table on sys_pd_context:
  - query: playbook=<playbook_sys_id>
  - fields: sys_id,state,started_by,record,stage
  - limit: 10

Verify the playbook trigger configuration:

Use SN-Query-Table on sys_pd_playbook:
  - query: sys_id=<playbook_sys_id>
  - fields: trigger_type,trigger_condition,table,auto_start

Step 10: Activate and Test the Playbook

MCP Approach:

Use SN-Update-Record on sys_pd_playbook:
  - sys_id: "<playbook_sys_id>"
  - status: "published"
  - active: true

Verify playbook is ready:

Use SN-Query-Table on sys_pd_playbook:
  - query: sys_id=<playbook_sys_id>
  - fields: sys_id,name,status,active,table

Tool Usage

Tool	Purpose	When to Use
SN-Query-Table	Find existing playbooks and activities	Pattern discovery and validation
SN-Create-Record	Create playbooks, stages, lanes, activities	Building new playbook components
SN-Update-Record	Modify playbook settings, activate playbooks	Editing and publishing
SN-Get-Table-Schema	Discover playbook table fields	Understanding available configurations

Best Practices

Always create playbooks in draft status -- never publish untested playbooks directly
Use descriptive stage names that reflect business process phases, not technical steps
Separate agent and system activities into dedicated lanes for clarity
Make data gathering fields mandatory only when the information is truly required for the next step
Add help text to data inputs so agents understand what information to collect
Use decision activities instead of complex condition-based transitions for readability
Limit the number of stages to 3-5 for most playbooks to avoid agent confusion
Test with sample records that match trigger conditions before activating
Set appropriate due dates on approval activities to prevent process stalls
Monitor playbook execution via sys_pd_context for runtime analysis and bottleneck identification

Troubleshooting

Issue	Cause	Resolution
Playbook not starting	Trigger condition mismatch or playbook inactive	Verify sys_pd_playbook.active=true and trigger_condition matches record
Activity stuck in pending	Missing required data inputs or broken transition	Check sys_pd_data_input mandatory fields and sys_pd_transition links
Data gathering form empty	No data inputs linked to activity	Create sys_pd_data_input records referencing the activity
Lane not visible	Lane has no activities assigned	Add at least one activity to the lane
Stage progression blocked	Previous stage activities not completed	Verify all mandatory activities in current stage are complete
Playbook runs multiple times	No duplicate prevention on trigger	Add condition to exclude records with active playbook context
Approval not routing	Approver reference does not resolve	Verify approver field resolves to active user with approval role

Examples

Example 1: Agent-Facing Incident Triage Playbook

Generate an interactive playbook for agents handling network incidents:

Trigger: Record Created on incident where category=network^priority<=2
Stages: Triage, Investigation, Resolution
Lane 1 (Agent): Gather CI details, capture business impact, document troubleshooting steps
Lane 2 (System): Auto-lookup related CIs, send notifications, update incident fields
Data Gathering: Affected CI (reference to cmdb_ci), impact description (string), users affected (integer)
Decision: If users_affected > 100, escalate to major incident process

Example 2: Customer Onboarding Playbook

Generate a standard playbook for CSM customer onboarding:

Trigger: Record Created on sn_csm_case where case_type=onboarding
Stages: Welcome, Configuration, Training, Go-Live
Lane 1 (Agent): Collect customer requirements, assign resources
Lane 2 (System): Provision accounts, configure integrations, send welcome email
Lane 3 (Customer): Complete intake form, schedule training sessions
Transitions: Sequential stage progression with parallel lane execution

Example 3: Change Request Risk Assessment Playbook

Generate a playbook for evaluating change request risk:

Trigger: Record Updated on change_request where state=assess
Stages: Risk Assessment, Approval, Scheduling
Lane 1 (Agent): Complete risk questionnaire, document rollback plan
Lane 2 (Approval): If risk=high, route to CAB; if moderate, route to manager
Data Gathering: Risk score (integer), rollback plan (multi-line text), downtime estimate (duration)
Decision: Branch based on calculated risk score to appropriate approval path

Related Skills

genai/flow-generation - Flow Designer flows for non-interactive automation
genai/spoke-generation - Integration Hub spokes for external connections
genai/skill-kit-custom - Custom Now Assist skills that can trigger playbooks
catalog/approval-workflows - Catalog-specific approval configuration
itsm/incident-lifecycle - Incident table structure and fields

About this skill

Overview

Prerequisites

Procedure

Step 1: Analyze the Natural Language Description

Step 2: Query Existing Playbooks for Patterns

Step 3: Create the Playbook Record

Step 4: Define Playbook Stages

Step 5: Create Lanes

Step 6: Add Activities

Step 7: Configure Data Inputs for Activities

Step 8: Define Transitions Between Activities

Step 9: Set Up Playbook Context

Step 10: Activate and Test the Playbook

Tool Usage

Best Practices

Troubleshooting

Examples

Example 1: Agent-Facing Incident Triage Playbook

Example 2: Customer Onboarding Playbook

Example 3: Change Request Risk Assessment Playbook

Related Skills