> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Widget Settings

Widget Settings lets you configure the appearance and behavior of the Agent AI widget. Settings are organized into two sections:

* **Agent AI Channel Specific Settings** — channel-specific preferences for Chat, Voice, and Email.
* **Agent AI General Settings** — widget-wide behavior and display options.

***

## Agent AI Channel-Specific Settings

Configure widget features per channel. The following options are available:

| Setting | Description |
| - | - |
| **Proactive Mode** | Automates intent identification, entity extraction, and transcript generation. By default, this toggle is on for all channels. It also supports Automatic Dialog Task Entity Extraction and Disable proactive mode at conversation end, which turns off Proactive Mode automatically when the conversation ends. By default, this toggle is on for all channels. |
| **Agent Coaching** | Provides real-time coaching based on agent utterances and speech analysis. With Agent Coaching on, you can configure Similarity, Proximity Threshold, LLM as Fallback, and Re-ranking. By default, this toggle is off and is available only for Chat and Voice channels. |
| **Agent Playbook** | Provides structured guidance for agents. When off, the Playbook tab remains hidden. When on, welcome messages become part of the Playbook step, and you can configure the number of messages, **Similarity**, **Proximity Threshold**, **Re-ranking**, and **User Bot Messages Adherence**. By default, this toggle is off. |
| **Agentic Copilot** | Turns on autonomous, end-to-end conversation handling. Agents can cancel, override, or edit messages. Configure language, app selection, auto-send, timer, and custom delimiter. |
| **Agentic Response Streaming** | Streams Agentic responses incrementally wherever the widget generates them, reducing perceived latency during live conversations. |
| **Auto-Scroll Widget Content** | Automatically scrolls to the latest content in the **Assist**, **My AI Agent (Bot)**, and **Transcript** tabs. Agents can override this setting in the widget's Settings tab. |
| **Control Transcript Visibility between Agents** (Voice only) | Controls transcript visibility for agents on the voice channel during conversation transfers. Select **Use Agent's Entry and Exit Events** to restrict the current agent to their own conversation transcripts. The agent can still view summaries of previous bot-user and agent-user conversations, but not the previous agent's transcripts. |
| **Send Button** | Controls the **Send** button for Agent AI responses. Available for Chat and Email; on for Chat by default. |
| **Copy Button** | Controls the **Copy** button for Agent AI responses. Available for Chat and Email; on for both by default. |
| **Append Button** | Controls the **Append** button for Agent AI responses. Off by default; works only in Kore CC Desktop. Agents select it to add suggested content to the existing text in the compose bar, instead of replacing it. |
| **Widget Search Bar Configuration** | Configures search sources. If the toggle is on, select from Platform, Search AI, and Agentic App(LLM). If the toggle is off, results from all sources load simultaneously. |
| **Conversation Transfer** | Defines behavior when a conversation transfers between agents. Applies to third-party configurations with appropriate transfer events. Select **Cold Transfer**, **Warm Transfer**, or both. |

**Agent Coaching options**:

| Option | Description |
| - | - |
| **Similarity** | Sets the minimum similarity required for coaching suggestions. Use the slider to select a value from 0 to 100 percent. |
| **Proximity Threshold** | Sets the minimum proximity threshold required for coaching suggestions. Use the slider, or enter a value in the box, from 0 to 100 percent. |
| **LLM as Fallback** | Uses an LLM to identify the most relevant rule when multiple deterministic ML-based coaching rules match. Applies only to deterministic ML-based coaching rules. Add a clear description to every eligible rule. |
| **Re-ranking** | Reorders retrieved search results to maximize answer accuracy and optimize coaching suggestion processing. |

**Agent Playbook options**:

| Option | Description |
| - | - |
| **Similarity** | Sets the minimum similarity required. Use the slider to select a value from 0 to 100 percent. |
| **Proximity Threshold** | Sets the minimum proximity threshold required. Use the slider, or enter a value in the box, from 0 to 100 percent. |
| **Re-ranking** | Reorders retrieved search results to maximize answer accuracy and optimize playbook adherence. |
| **User Bot Messages Adherence** | When on, checks user bot messages against the Playbook steps to confirm they adhere to the steps. |

**When the Proactive Mode is off**:

* The **Assist** tab **Run** button is off; only **Run with agent's input** is available.
* Dynamic playbook identification and adherence are inactive; tick-off and step progression still work.
* Primary playbook automatic adherence or tick-off doesn't occur.
* If the Playbook widget is also off, the default landing page is **My AI Agent (Bot)**.

**Conversation Transfer options**:

| Transfer Type | Description |
| - | - |
| **Cold Transfer** | Handover between two agents. Applies to Voice, Chat, and Email. The system generates a new summary for the receiving agent. |
| **Warm Transfer** | Conference call between two agents. Applies to Voice and Chat. Agent-2 can modify Summary Feedback, but Run, Override, Send, Copy, Terminate, Restart, and List View buttons remain off until Agent-1 disconnects. |

**Both transfer types support**:

* **Scroll up to the First Message** — opens chat history at the top.
* **Continue from the Last Message** — opens chat history at the bottom.
* **Configure Dialog Task** — runs a selected dialog task automatically when the conversation transfers.

***

### Steps to set Channel-Specific Preferences

1. Sign in to Platform.

2. Go to **Agent AI** > **Configuration** > **Widget Settings** > **Agent AI Settings** > **Agent AI Channel Specific Settings**.

3. Expand **Agent AI Channel Specific Settings**.

4. Select a channel from the **Select channel** list.

5. Turn on the **Agent AI Channel Specific Settings** toggle if it's off.

6. Turn **Proactive Mode** on or off.
   * Select or clear **Automatic Dialog Task Entity Extraction**.
   * Select or clear **Disable proactive mode at conversation end**.

7. Turn the toggles on or off for **Agent Coaching**, **Agent Playbook**, **Agentic Response Streaming**, **Auto-Scroll Widget Content**, **Send Button**, **Copy Button**, and **Append** button.
   * For Agent Coaching, set the following options:
     * Use the **Similarity** slider to set the minimum similarity.
     * Use the **Proximity Threshold** slider, or enter a value, to set the minimum proximity threshold.
     * Turn **LLM as Fallback** on or off.
     * Turn **Re-ranking** on or off.
   * For Agent Playbook, select the number of messages to pass to a step for adherence and trigger evaluation. The following note displays if you select five messages:\
     \[!NOTE] Increasing the number of messages might cause higher latency.

     For **Agent Playbook**, also set the following options:

     * Use the **Similarity** slider to set the minimum similarity.
     * Use the **Proximity Threshold** slider, or enter a value, to set the minimum proximity threshold.
     * Turn **Re-ranking** on or off.
     * Turn **User Bot Messages Adherence** on or off.

8. For **Agentic Copilot**:
   * Select a language.
   * Turn on or off the **Agentic Copilot** toggle.
   * Select an assignment option:
     * **Enable for all Agents** — the selected app applies to all queues.
       1. Select an app from **Select Agentic App**.
       2. Select **Allow auto send Message** to turn on auto-send.
       3. Use the slider to set the delay (up to 60 seconds).
       4. Select **Custom Delimiter for Agentic Suggestions** to send or copy only the text above the delimiter to the customer.
     * **Enable for Specific Queues** — assigns apps to specific queues via Agent AI Mapping.
       1. Select **Open AI Feature Mapping** to navigate to Agent AI Mapping.
       2. Select **learn more** for queue configuration details.

9. Turn on or off **Control Transcript Visibility between Agents** (Voice channel only) and select one of the following options:

   | Option | Description |
   | - | - |
   | **Use Public APIs to Control Transcription** | Controls transcript visibility using public APIs. |
   | **Use Agent's Entry and Exit Events** | The current agent views only their own conversation transcripts and summaries of previous bot-user and agent-user conversations. |

10. Turn on **Widget Search Bar Configuration**.

    1. Select one or more options — **Platform**, **Search AI**, **Agentic App(LLM)**.
    2. If you select **Agentic App(LLM)**, choose an app from the dropdown list.

    > [!NOTE]
    >
    > **Search AI** and **Agentic App(LLM)** fields are unavailable until you configure them, and a warning prompts you to configure them first.

11. Under **Conversation Transfer**, select **Cold Transfer**, **Warm Transfer**, or both. Select an option from the list for each transfer type.

12. Select **Save**.

    ![Agent AI Channel Specific Settings](https://mintcdn.com/koreai/uObByIl-3PG1szaG/ai-for-service/agentai/configuration/widget-settings-images/agentassist-channel-specific-settings-page.png?fit=max\&auto=format\&n=uObByIl-3PG1szaG\&q=85\&s=018be788ee9c49d40f3f6074f7130b83)

***

## Agent AI General Settings

Configure global widget behavior including URL handling, data format, and language preferences.

| Setting | Description |
| - | - |
| **URL Opening Behavior** | **Default System Behavior** — links open in a new window. **Post Event** — triggers the `AgentAI.UrlClickedMessage` event so the desktop app controls the link's behavior. |
| **Data Format Preference** | **Plain String** — sends messages in plain text. **Original Format** — sends messages with HTML tags as received. Applies to Playbooks and Dialog Tasks. |
| **Help & Support** | Show or hide Help & Support in the widget. Configure which components appear (Documentation, FAQ, Kore Academy) and their URLs. |
| **Honor Bot Event - Intent not found** | Triggers the configured intent-not-found event if Agent AI can't identify the user's intent. |
| **Show small-talk responses** | Controls whether the widget displays small-talk responses (bot acknowledgements) such as **Okay**, **Got it**, or **Thanks** to agents. |
| **Third Party Configuration** | Loads the Agent AI widget in third-party agent desktops based on the queue mappings in [Third Party Configuration](https://koreai.mintlify.site/ai-for-service/agentai/configuration/third-party-configuration). Turned off this toggle to stop the widget from loading in those desktops. |
| **Default Language for Agent AI Widget** | Sets the widget display language. Optionally, allow agents to change the language at run time. |
| **Dialog Task Display Name Configurations** | **Default System Behavior** — standard display. **Advanced Mode** — use custom script logic for trait-based dialog task display. |
| **Secure Real-Time Messaging** | Turns on end-to-end encryption for agent and customer messages during live conversations. |

**Post Event URL behavior:**

When an agent selects a link in the widget, the `AgentAI.UrlClickedMessage` event triggers and a log appears on the right showing the URL. Desktop applications use this URL to control how the link opens.

![Post Event URL Opening Behavior](https://mintcdn.com/koreai/uObByIl-3PG1szaG/ai-for-service/agentai/configuration/widget-settings-images/post-event-url-opening-behavior.png?fit=max\&auto=format\&n=uObByIl-3PG1szaG\&q=85\&s=0f99333a49945263e6d562a2119cd3af)

***

### Steps to Set Agent AI General Settings

1. Go to **Agent AI** > **Configuration** > **Widget Settings** > **Agent AI Settings** > **Agent AI General Settings**.

2. Expand **Agent AI General Settings**.

3. Select **Default System Behavior** or **Post Event** under **URL opening behavior**.

4. Select **Plain String** or **Original Format** under **Data Format Preference**.

5. Turn on or off the **Help & Support** toggle.

   > [!NOTE]
   >
   > Turning on this toggle makes **Conversation Metadata** available to copy by default.

   1. Select the components to display — **Documentation**, **FAQ**, **Kore Academy**.
   2. Customize the URLs for **Documentation** and **FAQ** as needed.

6. Turn on or off the **Honor Bot Event - Intent not found**, **Show small-talk responses**, and **Third Party Configuration** toggles.

7. Select a language from the **Default Language for Agent AI Widget** list, or select **Interactive Language** to use the app's language. To allow agents to switch languages, select **Allow agents to switch between multiple available languages**.

8. Select **Default System Behavior** or **Advanced Mode** under **Dialog Task Display Name Configurations**. For **Advanced Mode**, enter a custom script in the pop-up and select **Save**.

   ![Custom Script](https://mintcdn.com/koreai/IaMQplULZvUirzb0/ai-for-service/agentai/configuration/widget-settings-images/custom-script.png?fit=max\&auto=format\&n=IaMQplULZvUirzb0\&q=85\&s=a4b606c270ab0be8e3fd9f44f7950910)

9. Turn on the **Secure Real-Time Messaging** toggle to encrypt agent and customer messages during live conversations.

10. Select **Save**.

![Agent AI General Settings](https://mintcdn.com/koreai/7iM4PoZGXrplnN7z/ai-for-service/agentai/configuration/widget-settings-images/agent-ai-general-settings.png?fit=max\&auto=format\&n=7iM4PoZGXrplnN7z\&q=85\&s=c23ef1d63b059e7d64eede75ada0b5f8)

***

### Auto-Correct for the Search Tab

The Auto Correct feature highlights misspelled words in the Search tab and suggests corrections. Admins configure it in Widget Settings; agents can override the setting in the widget's **Settings** tab.

**Admin steps:**

1. Sign in to **Agent AI**.

2. Go to **Widget Settings** > **Agent AI General Settings**.

3. Turn the **Auto Correct** toggle on or off.

4. Select or clear **Use Custom Dictionary**.

5. Upload a customized word list.

   > [!NOTE]
   >
   > You can download the current word list if one has already been uploaded.

6. Select **Save**.

**Agent steps**:

1. Sign in to the **Agent AI** widget.
2. Go to the **Settings** tab.
3. Turn on or off the **Auto Correct** toggle.

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.