AI Trigger Orchestration can automatically update ticket fields based on structured AI responses. By mapping response properties to ticket actions, you can classify tickets, assign priorities, set categories, and automate other ticket updates without manual intervention.

This article explains how to configure response property mapping, select the appropriate ticket context, test your configuration, and troubleshoot common mapping issues.

Prerequisites

Before configuring AI Trigger Orchestration, ensure that:

• BoldDesk AI features are enabled for your account.
• Your account has sufficient AI credits.
• At least one AI Agent is created and published.
• The AI Agent is configured with instructions appropriate for the intended ticket analysis.
• You have identified the ticket context fields required by the AI Agent.
• You have identified the ticket fields that the AI Agent should update.
• Your role has the Manage Settings permission.
• The target ticket fields contain the values that the AI Agent is expected to use.

Understand How Response Property Mapping Works

When an AI Trigger Orchestration rule runs:

1. BoldDesk evaluates the rule conditions.
2. BoldDesk invokes the selected AI Agent.
3. The selected ticket context fields are sent to the AI Agent.
4. The AI Agent analyzes the ticket content and instructions.
5. The AI Agent returns a structured response.
6. BoldDesk extracts the configured response properties.
7. BoldDesk maps each property to its corresponding ticket field.
8. The mapped ticket fields are updated.

For example, suppose the orchestration rule contains the following mappings:

The AI Agent should provide values for those properties so BoldDesk can apply them to the corresponding ticket fields.

Configure the Rule Conditions

Create an AI Trigger Orchestration rule and configure the ticket conditions that should invoke the AI Agent.

The AI Agent is invoked only when a ticket meets the configured conditions. Use conditions that limit the rule to tickets relevant to the intended workflow.

For detailed instructions on creating the rule and configuring its conditions, learn How to Configure AI Trigger Orchestration in BoldDesk.

After configuring the conditions, click Next to configure the AI Agent invocation and response property mapping.

Configure the AI Agent Invocation

In the Invoke AI Agent step:

1. In Choose AI Agent, select the published AI Agent that should process matching tickets.

2. Under Ticket Context Fields, select the ticket information that the AI Agent needs.

3. In Additional Instructions, define the analysis requirements and expected output.

4. Enable Update Ticket Fields from AI Responses.

5. Map each ticket action to the corresponding response property.

6. Click Add or Update to save the orchestration rule.

   

Select the Required Ticket Context Fields

The Ticket Context Fields setting determines which ticket information is sent to the AI Agent.

Select only the fields that are relevant to the analysis.

For example, an AI Agent that classifies new tickets may require:

• Subject
• Description Text
• Brand Name
• Category ID
• Priority ID
• Type ID

An AI Agent that analyzes customer replies may also require:

• Last Message Text
• Last Message ID
• Ticket ID

Configure AI Response Instructions

The AI Agent should be instructed to analyze ticket information and provide values for the response properties used in the orchestration rule.

Include guidance such as:

• Use the configured response property names.
• Return values supported by the mapped ticket fields.
• Do not invent field values.
• Use approved fallback values when information is insufficient.
• Ensure all required properties are included.

Example instruction:

Analyze the ticket using the provided subject, description, latest message, and current ticket properties.

Provide values for:

- type
- category
- priority

Use only values that are valid for the corresponding BoldDesk ticket fields.

Do not invent field values.
Use approved fallback values when sufficient information is unavailable.

Apply the agent’s response to ticket fields

After enabling Update Ticket Fields from AI Responses, configure a mapping for each ticket field that should be updated.

To configure property mapping:

1. Select a ticket action.
2. Enter the response property that contains the corresponding value.
3. Add additional mappings as required.
4. Remove unused mappings.
5. Save or update the rule.

Example mapping:

Use consistent property names throughout the configuration.

Example: Configure Ticket Classification for Battery-Related Issues

Suppose your support team wants an AI Agent to classify battery-related tickets and automatically update the ticket type, category, and priority.

Configure the Rule Condition

Configure the orchestration rule to match battery-related tickets.

For example:

• Field: Subject
• Operator: Contains
• Values:
  • Battery
  • Battery drain
  • Battery health
  • Battery swollen
  • Battery overheating

Select the AI Agent

In Choose AI Agent, select the published AI Agent configured for hardware issue analysis.

Select the Ticket Context Fields

Select:

• Brand Name
• Ticket ID
• Subject
• Description Text
• Last Message Text
• Type ID
• Category ID
• Priority ID

Configure Additional Instructions

Analyze the ticket for battery-related issues using the provided ticket details.

Classify the issue based on the reported symptoms.

Provide values for the following properties:

- type
- category
- priority

Use only values that are valid for the corresponding BoldDesk ticket fields.

If sufficient information is unavailable, use the approved fallback values.
Do not invent customer, warranty, cost, or device information.

Configure the Ticket Field Mappings

Enable Update Ticket Fields from AI Responses and configure:

Expected Classification Result

BoldDesk reads the configured properties and updates the mapped ticket fields accordingly.

Handle Missing Information

Define how the AI Agent should respond when there is not enough information to make a reliable classification.

Consider the following approaches:

• Use approved fallback values.
• Route tickets to a general category for manual review.
• Apply a default priority based on your organization’s triage policy.
• Configure rule conditions that require sufficient ticket details before processing.

Example instruction:

If the ticket does not contain enough information to determine the appropriate classification, use the approved fallback values for unclassified tickets.

Understand Private Note and Ticket Update Behavior

AI Trigger Orchestration supports two response-handling behaviors.

Default Behavior

When Update Ticket Fields from AI Responses is disabled:

• The AI Agent response is added as a private note.
• Agents can review the AI-generated findings.
• Ticket fields remain unchanged.

Ticket Update Behavior

When Update Ticket Fields from AI Responses is enabled:

• BoldDesk reads the configured response properties.
• The mapped ticket fields are updated automatically.
• A private note is not added.

Use the default behavior when agents should review the AI output. Use ticket field updates when the AI response should drive workflow automation.

Security and Data Considerations

Send only the information necessary for the AI Agent’s task.

Avoid including unnecessary:

• Customer identifiers
• Contact information
• Internal-only data
• Sensitive custom-field values
• Authentication details
• Confidential business information

Review the target field mappings regularly to ensure updates remain aligned with your workflow requirements.

Troubleshooting

The AI Response Is Added as a Private Note

This occurs when Update Ticket Fields from AI Responses is disabled.

Enable the option and configure at least one response property mapping if the AI output should update ticket fields.

Some Ticket Fields Are Updated but Others Are Not

Verify that:

• Each required property is mapped in the orchestration rule.
• The AI Agent provides values for all mapped properties.
• Returned values exist in the corresponding BoldDesk ticket fields.

The AI Agent Returns an Unsupported Field Value

List the permitted values in the AI Agent instructions.

Example:

For priority, use only Low, Medium, High, or Urgent.

Keep the instructions synchronized with the available values in the ticket field configuration.

A Required Property Is Missing

Specify that all mapped properties must always be provided and define approved fallback values for situations where information is insufficient.

The AI Output Uses Different Property Names

Ensure that the property names referenced in the AI instructions match the property names configured in the orchestration mappings.

For example, if the configured property is category, do not instruct the AI Agent to use ticketCategory.

Frequently Asked Questions

1. Why should I use response property mapping in AI Trigger Orchestration?

Response property mapping enables AI-driven ticket classification and automated field updates based on AI analysis.

2. Does the AI Agent need special formatting instructions?

No. Structured response handling is managed automatically by BoldDesk. Focus on providing clear classification rules and valid ticket field values.

3. Do response property names have to match the orchestration mapping?

Yes. Property names used by the AI Agent must match the configured mappings exactly.

4. Can AI responses update multiple ticket fields?
   Yes. You can map multiple response properties to different ticket field actions within a single orchestration rule.

5. What happens if a returned value is not available in the target ticket field?

The update may not be applied. Ensure that the AI Agent is instructed to use only values supported by the target ticket field.

Related Articles

1. How to Configure AI Trigger Orchestration in BoldDesk
2. How to Create and Manage AI 2.0 Agent in BoldDesk