# Add-on nodes

Add-ons extend the capabilities of your AI agent beyond core conversation handling. These add-ons enable your AI agent to perform various actions, including:

  • Connecting with external systems
  • Triggering live agent handovers
  • Guiding users through policy-driven flows
  • Looking up structured data from data tables
  • Verifying user identities

# Agent Actions - Apply Macro

The Agent Actions - Apply Macro add-on applies predefined macros to automate actions like tagging or closing tickets.

# Answer Feedback - Conversation Flow

The Answer Feedback - Conversation Flow add-on thanks the user for providing feedback.

# Autonomous Agent

The Autonomous Agent add-on enables autonomous multi-step execution by the AI agent to achieve user goals.

# Business Email Checker

The Business Email Checker add-on validates if a given email address belongs to a business domain. You can use this node with a Rule node to check if the parameter isBusinessEmail is true or false, and route the customer accordingly.

# Business Hours

The Business Hours add-on checks if the current time falls within your defined business hours. Specify the timezone and set rules for each day of the week.

Use this node to route customers based on when they contact support. For example, direct customers to a live agent during business hours or to a self-service path after hours.

# Capture Variable via Input

The Capture Variable via Input add-on prompts the user for input and store their response in a parameter.

Capture Variable via InputCapture Variable via Input

You can combine this node with Message or Question nodes to guide the interaction. For example, use a Message or Question node to ask, “What's your name?”, then follow up with a personalized message like:

Hi, {{ firstName }}. How can I help you today?

This lets you create more natural, contextual conversations using stored user input.

# Chat Conversation CSAT

The Chat Conversation CSAT add-on collects customer satisfaction (CSAT) feedback after a conversation.

Chat Conversation CSATChat Conversation CSAT

You can choose to collect either:

  • A rating only, or
  • A rating with additional feedback, as shown in the screenshot.

Ratings are collected on a 5-point scale:

  • Terrible
  • Bad
  • Okay
  • Good
  • Excellent

# Client Event

The Client Event add-on lets you control the UI state of the AI agent widget during a conversation. You can use it to open, close, minimize, or customize elements of the interface depending on where the user is in the flow.

Available client events include:

Event Description
Maximize bot Opens or expands the AI agent window if it is minimized or closed.
Minimize bot Minimizes the AI agent window.
Show close button Displays a close button in the AI agent window to allow users to end the chat. This is useful after a resolution is provided or if the user wants to restart the conversation. You can also activate or deactivate this per step in the flow.
Hide close button Hides the close button to prevent users from ending the chat. This is useful in steps where users must complete a required action before proceeding.
Show escape hatch Displays an escape hatch at the bottom of the AI agent window. This gives users a way to exit the current flow and navigate to a specific page or support path. For example, you can select this option if the AI agent handles technical queries and the user needs help with a different topic, like sales.
Hide escape hatch Hides the escape hatch to keep users focused within the current AI agent flow. This is useful when you want to prevent unnecessary exits and guide users toward a solution within the agent.
Show settings Displays the settings menu in the AI agent window. This menu lets users control features like sound notifications for incoming messages, enter an email to receive the chat transcript, download the transcript, and view the privacy policy (if configured).
Hide settings Hides the settings menu from the AI agent window. Use this when you want to restrict access to settings at certain points in the conversation.
Show restart conversation button Displays a restart button that allows users to restart the conversation at any point. This is helpful when users want to explore different services or revisit options provided earlier.
Hide restart conversation button Hides the restart button to keep users on a single, focused path. This helps ensure that users follow the intended flow toward a resolution.

# Cognitive Answers

The Cognitive Answers add-on uses large language models (LLMs) to fetch answers from your knowledge base.

# Cognitive Email Response

The Cognitive Email Response add-on uses large language models (LLMs) to fetch answers from your knowledge base.

# Conversation Agent

The Conversation Agent add-on lets customers converse with an AI agent that has the ability to clarify and search.

# Data Table

The Data Table add-on looks up structured data from a data table and store the result in parameters.

Refer to the Use a data table in a flow section for an example that illustrates how to configure this node.

# Dynamic Messages

The Dynamic Messages add-on inserts dynamic content into the conversation based on parameter values.

# Email Template Response

The Email Template Response add-on responds using a predefined email template.

# End Chat

The End Chat add-on immediately ends the conversation session with the user.

# Generative Response

The Generative Response add-on allows you to provide instructions and generate a response using a language model. You can choose to use a base prompt or define instructions to use for the generative response. You can also opt to use the conversation to generate a response.

# HTTP Request

The HTTP Request add-on lets you make calls to any external REST API. Common use cases include:

  • Fetching data from an external system, such as retrieving an order status or customer profile.
  • Sending collected information to an external system, such as updating an order.

# Configure the HTTP request

Complete the following steps to configure the HTTP request node:

1

Drag the HTTP Request add-on onto the flow builder.

HTTP requestHTTP request

2

Configure the API request:

  • Set the URL directly or reference a parameter containing the URL.
  • Specify any required headers, payload, and the HTTP method.
3

Save your changes and connect the node within your flow.

# Use the API response

After the HTTP request is complete, the response is stored in the actionOutput parameter. You can access this data using the templating language to personalize messages sent to the customer.

# Example response

{
  "order": {
    "id": 12,
    "name": "blue tshirt",
    "price": 10,
    "count": 1
  }
}

# Template example

Order ID: {{ actionOutput.order.id }}
Product: {{ actionOutput.order.name }}
Price: ${{ actionOutput.order.price }}
Quantity: {{ actionOutput.order.count }}

You can use these templates in any message component to dynamically display API response data.

Display the API response in a messageDisplay the API response in a message

# Identity Verification

The Identity Verification add-on verifies a user's identity using a shared secret. This ensures that any metadata passed to the AI agent is authenticated and trustworthy.

When identity verification is enabled, the AI agent checks a hash of the user's metadata generated by your server. If the hash matches the expected value (based on the shared secret), the metadata is considered verified and is added to the flow context for use throughout the conversation.

# List Options

The List Options add-on lets customers select an item from a predefined list and stores their selection in a parameter.

List optionsList options

You can follow this node with a Rule node to route users down different paths based on their selection.

# OTP Authentication

The OTP Authentication add-on sends a one-time password (OTP) to the user's email or phone number and verifies it to confirm their identity.

# Policy Flow

The Policy Flow add-on defines a task the AI agent can carry out using natural language instructions. These tasks can involve step-by-step interactions where the agent asks questions, makes decisions, and responds intelligently based on user input. Policies are powered by large language models (LLMs), such as GPT-4.

Policy FlowPolicy Flow

This add-on includes the following key components and optional configurations:

  • Name: A clear, descriptive name for the policy.

  • Policy: A plain-text instruction set describing how the AI agent carries out the task. Ensure that the policy defines:

    • The objective, or what the agent is helping with.
    • The step-by-step approach.
    • The exit criteria, or how to know when the task is complete.
  • Actions: Additional actions that the AI agent can perform as part of executing the policy.

Sample policy flow: Check a customer's order status

Greet the customer warmly and let them know you'll help them check their order status.

If the order ID and email haven't been provided, ask the customer for both.

After all the necessary information has been collected, confirm you're retrieving the order.

  • If the order is found, share the status, shipping address, and tracking URL.
  • If the order isn't found, ask the customer to verify and re-enter the details.

Beyond the core setup, you can configure advanced behavior using the following options:

# Language model

The Language Model tab lets you choose which language model the Policy Flow node uses. You can either use the default model provided by AgentX Support or use an existing LLM connection (OpenAI, Azure, or Anthropic). You can also specify a particular model version if needed.

Model selectionModel selection

# Context parameters

The Context Parameters tab allows you to provide relevant context to the Policy Flow node to improve accuracy and reduce repeated questions.

Field Description
Parameters to include List the parameters from the conversation context to pass into the policy. For example, name or email.
Parameters to capture Define any values the agent should collect during the policy execution. Each parameter should include a name and a description of what it represents.

Parameter configurationParameter configuration

# Failure settings

The Failure Settings tab allows you to set a maximum number of turns (message exchanges) the agent can take while executing the policy. This prevents the AI agent from looping indefinitely.

Failure settingsFailure settings

# Sales AI Agent

The Sales AI Agent add-on assigns a specialized AI agent focused on sales conversations.

# Salesforce - Agent Availability

The Salesforce - Agent Availability add-on checks whether any agents are available for live chat within a specified group.

Salesforce - Agent AvailabilitySalesforce - Agent Availability

To configure this node, provide the following details:

  • Live Agent URL
  • Salesforce Organization ID
  • Deployment ID
  • Button ID

Configuration exampleConfiguration example

After you configure this node, it checks for agent availability and sets a parameter accordingly:

availability = available   (if agents are available)
availability = no          (if no agents are available)

You can reference this parameter in flow rules to route the conversation based on agent availability.

# Salesforce - Live Agent Handover

The Salesforce - Live Agent Handover add-on routes the conversation to a Salesforce live agent. In addition to the handover, you can associate cases and contacts. You also have the ability to prefill fields on the LiveChatTranscript object.

Salesforce - Live Agent HandoverSalesforce - Live Agent Handover

The following fields are required. You can populate them directly or using parameters:

  • Live Agent URL
  • Salesforce Organization ID
  • Deployment ID
  • Button ID
  • First Name
  • Last Name

Salesforce - Live Agent Handover fieldsSalesforce - Live Agent Handover fields

Optional fields include:

Field Description
Case ID Associates the transcript with a Salesforce case object. Create the case before handoff if this association is needed.
Contact ID Associates the transcript with a Salesforce contact object. Create the contact before handoff if this association is needed.
Custom Fields Key-value pairs to populate on the LiveChatTranscript object. These can include standard or custom fields defined in Salesforce.

After the chat ends, the flow continues to the next node. A chat ends in the following scenarios:

  • Agent ends the chat
  • User ends the chat
  • User disconnects (abandonment after timeout)

# Salesforce - Messaging Handoff

The Salesforce - Messaging Handoff add-on transfers the user to Salesforce Messaging.

# Select List

The Select List add-on presents a drop-down menu that lets users choose one or more items from a predefined list. You can optionally enable multi-select to allow users to pick multiple options.

Select listSelect list

# Slack - Live Chat Handover

The Slack - Live Chat Handover add-on hands off the conversation to a Slack channel for live support.

# Transcript Summary

The Transcript Summary add-on generates a summary of the conversation. It also identifies the user's problem and sentiment.

# Transient Message

The Transient Message add-on displays a temporary message that is not included in the conversation transcript.

# Upload Attachment

The Upload Attachment add-on allows users to upload files during the conversation.

# Zendesk - Field Triage

The Zendesk - Field Triage add-on uses logic to assign or update Zendesk ticket fields.

# Zendesk Sunshine Conversations Handoff - In Widget

The Zendesk Sunshine Conversations Handoff - In Widget add-on hands off to a live agent using Zendesk Sunshine Conversations inside the chat widget.

Zendesk Sunshine Conversations Handoff - In WidgetZendesk Sunshine Conversations Handoff - In Widget

# Zendesk Sunshine Conversations Handover

The Zendesk Sunshine Conversations Handover add-on hands off to a Zendesk Sunshine Conversations live agent outside the chat widget.

# Zendesk Ticket Field Update

The Zendesk Ticket Field Update add-on updates ticket fields in Zendesk based on user input or flow logic.


Last updated: 6/23/2025, 2:33:20 PM