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
- Administrator access to the UCC A Unified Contact Center, or UCC, is a queue of interactions (voice, email, IM, etc.) that are handled by Agents. Each UCC has its own settings, IVR menus and Agents. Agents can belong to one or several UCCs and can have multiple skills (competencies). A UCC can be visualized as a contact center “micro service”. Customers can utilize one UCC (e.g. a global helpdesk), a few UCC’s (e.g. for each department or regional office) or hundreds of UCC’s (e.g. for each bed at a hospital). They are interconnected and can all be managed from one central location. Config SharePoint site.
- An Azure OpenAI resource in your Azure subscription.
If you need to create one, follow Microsoft’s guidance and then return here. - The Azure OpenAI API key, endpoint, and model (deployment) name—for example,
gpt‑4o‑mini
.
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.
- Open Azure AI Studio and select your Azure OpenAI resource.
- Copy the Endpoint (ends with
.openai.azure.com/
). - Create or copy an API key.
- Under Deployments, copy the name you want to use—for example,
gpt‑4o‑mini
. - Replace the placeholders in the following snippet:
{"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.
- Select UCC Config › Plugin Settings.
- Enter the rows shown in the following table.
Setting | Value | Description |
---|---|---|
Name: Credentials Scope: DialogueStudioAiNodes |
|
Connection string AI Pathfinder uses to call Azure OpenAI. |
Name: AiPathfinderSystemPrompt Scope: DialogueStudioAiNodes |
Copy Prompt
| 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.
- Select UCC Config › Skills.
- For each skill, enter a clear Description that explains when the skill should be used.
- 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.