Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Add Guided Decision with inputs/outputs to Playbook

Add decision trees created using the Guided Decision with Inputs and Outputs activity in the Guided Decisions Experience application to a playbook, so customer service agents can work through it to resolve cases more efficiently.

Before you begin

Role required: admin, pd_content_author

About this task

The Guided Decision with Inputs and Outputs activity is a playbook activity that enables decision trees to be used in playbooks with the ability to pass input parameters and retrieve output values. This activity allows you to select a specific decision tree version and configure input parameters that map to the questions defined in the first node of the decision tree. The activity supports versioning, where each activation of the decision tree builder creates a new version, and playbook activities continue using their configured version until manually updated. When a decision tree is activated to create a new version, you receive a notification message listing all playbooks and activities that reference the decision tree, with direct links to facilitate version updates.

For more details on playbooks for Customer Service Management, see Playbooks for Customer Service Management.

Procedure

  1. Navigate to All > Process Automation > Process Automation Designer.

    Playbooks opens in a new tab.

  2. Select the process you want to add the decision tree to.

  3. Select Add activity.

  4. Select Guided Decisions Experience > Guided Decisions with inputs/outputs.

  5. In the Details tab, fill in the details of the activity and select Save and close.

FieldDescription
LabelUnique name for your activity. This name appears in user-facing views of the playbook.
DescriptionBrief description of the activity.
Activity definition 
Schedule
Start ruleDefines when to start the process the activity. Select one of the following:- When stage starts: Your stage starts running as soon as the playbook starts. - After specific activities: Your stage starts running after specified stage\(s\) have finished running. Starts after
Display orderWhen there are multiple stages running at the same time, define the order in which stages appear during a playbook run.Note: In Workflow Studio, this can also be helpful when viewing parallel activities in Diagram view.
Start with delayWaits for a certain duration before running the activity when the start rule is met. For more information, see Start with delay input properties.
Restart rulesDefines how the activity runs when the playbook is restarted. - Skip on restart - Run always - Skip on first run
  1. In the Automation tab, fill in the following fields and select Save and close button.
FieldDescription
AutomationSee or open the action, subflow, or flow that drives the activity.
InputsConfigure inputs for the action, subflow, or flow that is driving the activity. Not all activities require user input. Define the values of the activity's inputs.
Inputs
Decision treeDecision tree as one of the steps within a playbook.
Decision tree versionActive version of the decision tree.Note: The activity supports versioning, where each activation of the decision tree builder creates a new version, and playbook activities continue using their configured version until manually updated.
OutputsOutputs of the action, subflow, or flow that is driving the activity.
**Note:** The activity provides a refresh capability that allows you to update to the latest decision tree version while preserving existing input mappings and adding any new input fields that were introduced in the newer version.
  1. In the UI Layout tab for knowledge articles, fill in the following fields and select Save and control.

    FieldDescription
    Article heightDefault height of the article.
    Collapse knowledge articleWhen selected, the article appears collapsed in the playbook.
  2. In the main header, select Activate.

    Activating your process publishes it so that it runs when triggered.

Result

The decision tree is added to the playbook. Depending on the context of the case, customer service agents can access the decision trees from cases on Agent Workspace. An agent can restart this activity by selecting the Restart Activity option in a playbook. For more information on how to restart an activity, see Restart a playbook.

Related topics

Configuring Guided Decisions

Configuring guidances and decision trees