Dialogue Cloud

Configure AI Pathfinder node

Note

Planned for DC2025.01

Use AI Pathfinder in Dialogue Studio to route conversations by matching the customer’s question to the most relevant Skill description.

Prerequisites

Build your credentials JSON

The AI Pathfinder connection string is a single JSON object. Gather the three values from Azure AI Studio and build the string as shown below.

  1. Open Azure AI Studio and select your Azure OpenAI resource.
  2. Copy the Endpoint (ends with .openai.azure.com/).
  3. Create or copy an API key.
  4. Under Deployments, copy the name you want to use—for example, gpt‑4o‑mini.
  5. Replace the placeholders in the following snippet:
Copy
Credentials JSON
{"ApiKey":"YOUR_API_KEY","Endpoint":"https://YOUR_RESOURCE.openai.azure.com/","Deployment":"YOUR_MODEL_NAME"}

Common errors

  • Use the Endpoint URL, not the TargetUri shown in some REST examples.
  • Enter the (deployment) name, such as gpt‑4o‑mini. Do not use the friendly name of your Azure deployment object or the Model name.

Store credentials and system prompt

Add the credentials JSON and the system prompt to the Plugin Settings list so that AI Pathfinder can call Azure OpenAI.

  1. Select UCC Config › Plugin Settings.
  2. Enter the rows shown in the following table.
Setting Value Description
Name: Credentials
Scope: DialogueStudioAiNodes

{"ApiKey":"<API_KEY>","Endpoint":"<ENDPOINT>","Deployment":"<MODEL_NAME>"}

 

Connection string AI Pathfinder uses to call Azure OpenAI.
Name: AiPathfinderSystemPrompt
Scope: DialogueStudioAiNodes
Copy
Prompt
Match the customer transcript to one of the provided departments in the JSON object below. If no match is found, return "Other".

Consider each department and evaluate how well the input transcript corresponds to it based on its context, keywords, or implied needs. If no clear match can be made, categorize as "Other" and route to the following skill: Other.

# Steps
1. **Analyze the transcript**: Inspect the details provided in the transcript for clues, such as keywords, phrases, or implied topics that correspond to specific departments.
2. **Compare to departments**: Match the context of the transcript to available departments in the department list.

# Output Format
Only respond in a string.

# Notes
- Ensure the string response is valid and exactly matches the Title from the department list.
- Consider edge cases, like vague or unclear transcripts, and ensure the motivation sufficiently supports the decision to choose "Other" and route to the following skill: Other.

# Departments
{0}
System prompt sent to Azure OpenAI. AI Pathfinder replaces {0} with enabled skill descriptions.

Enable skills for AI Pathfinder

AI Pathfinder only considers skills that you explicitly enable.

  1. Select UCC Config › Skills.
  2. For each skill, enter a clear Description that explains when the skill should be used.
  3. Select the PathFinderEnabled checkbox for every skill that AI Pathfinder may choose.

Examples of clear skill descriptions

Use concise, customer-focused language so the model can quickly identify the right department. Avoid internal jargon or overlapping scopes.

Skill title Example description
Order Status Requests for tracking numbers, delivery dates, shipping delays, or changes to an existing order.
Billing & Payments Questions about invoices, payment methods, refunds, duplicate charges, or tax documentation.
Technical Support Issues installing, updating, or using the product; error messages; performance problems.
Sales & Upgrades Inquiries about new licences, feature packages, pricing, or product comparisons.
Account Management Requests to update contact details, change passwords, or review security settings.

Tip

Start each description with the type of request, then list common examples. This structure helps Azure OpenAI find strong keyword matches.