Agent AI new integ doc and other AI for Service changes - #975
Conversation
publishing a new integ doc and added a learn more link
…cs-v2 into ai-for-service-dev
There was a problem hiding this comment.
The publish URL is very repetitive and long. Shorten the folder name or drop it completely.
|
|
||
| ## Configuration Steps | ||
|
|
||
| Complete the following steps in order: |
There was a problem hiding this comment.
This sentence is redundant. Is it not implied to complete the steps? Is it implied that the order can be different? Just see the steps on stage and this sentence will feel redundant.
|
|
||
| ## Definitions | ||
|
|
||
| See [Definitions](/ai-for-service/agentai/integration/nice-max/nice-max-desktop-chat-and-voice#definitions) for more details. |
There was a problem hiding this comment.
Don't create an H2 for just a link. Find a different way to insert the link.
@RanjitKu-Kore , did you review on stage? This looks bad to me - a second-level heading called definitions says that see definitions. What's the usefulness?
| noindex: true | ||
| --- | ||
|
|
||
| This guide explains how to integrate the Agent AI widget with NICE CXone Agent Desktop for digital chat. The integration supports the following Agent AI capabilities: Automation, [Agent Coaching](/ai-for-service/agentai/agent-experience/agent-realtime-coaching), [Agent Playbook](/ai-for-service/agentai/agent-experience/playbook), [Sentiment Analysis](/ai-for-service/agentai/agent-experience/agent-assist-widget-v3), [conversation transcript](/ai-for-service/agentai/agent-experience/agent-assist-widget-v3#transcript-tab), [end-of-conversation summary](/ai-for-service/agentai/agent-experience/agent-assist-widget-v3#generate-summary), and custom data passing, such as agent name and ID. |
There was a problem hiding this comment.
Better to add "the following capabilities" as a list.
|
|
||
| ## Shared Responsibilities | ||
|
|
||
| For details, see [Shared Responsibilities](/ai-for-service/agentai/integration/nice-max/nice-max-desktop-chat-and-voice#shared-responsibilities) and follow only the responsibilities that apply to digital chat. | ||
|
|
||
| ## NICE CXOne Admin | ||
|
|
||
| See [NICE CXOne Admin](/ai-for-service/agentai/integration/nice-max/nice-max-desktop-chat-and-voice#nice-cxone-admin) for further details. | ||
|
|
||
| ## Kore.ai Admin | ||
|
|
||
| Provide the Studio script for digital chat: The support team provisions the Studio script required for the NICE CXone digital chat integration. | ||
|
|
There was a problem hiding this comment.
All these H2s are one-liners. Update to remove such short sections.
| Before starting with this integration guide, verify that you have the following: | ||
|
|
||
| * A NICE CXone administrator account. The account must be allowed to create digital automatic call distribution (ACD) skills, configure digital points of contact, configure digital chat channels, import/edit studio scripts, and assign agents who have the necessary roles and permissions to accept digital chat interactions in Agent Desktop. | ||
| * NICE CXone Studio installed on a supported Windows computer. NICE CXone Studio is the application used to import and edit the integration script. |
There was a problem hiding this comment.
Which Windows computers are supported? There's no mention.
| Before starting with this integration guide, verify that you have the following: | ||
|
|
||
| * A NICE CXone administrator account. The account must be allowed to create digital automatic call distribution (ACD) skills, configure digital points of contact, configure digital chat channels, import/edit studio scripts, and assign agents who have the necessary roles and permissions to accept digital chat interactions in Agent Desktop. | ||
| * NICE CXone Studio installed on a supported Windows computer. NICE CXone Studio is the application used to import and edit the integration script. |
There was a problem hiding this comment.
How is this description "NICE CXone Studio is the application used to import and edit the integration script." a prereq.?
|
|
||
| Before starting with this integration guide, verify that you have the following: | ||
|
|
||
| * A NICE CXone administrator account. The account must be allowed to create digital automatic call distribution (ACD) skills, configure digital points of contact, configure digital chat channels, import/edit studio scripts, and assign agents who have the necessary roles and permissions to accept digital chat interactions in Agent Desktop. |
There was a problem hiding this comment.
Question: Can admins already do the tasks listed after "The account must be allowed..." or is there a special allowance required for admins to accomplish these tasks? If admins can already do it, then entire sentence is redundant. But if admins can't do it, then document a way to allow admin account to accomplish these tasks.
| * Access to Kore.ai Agent AI, with permission to create or configure an AI agent. | ||
| * The following information from the Kore.ai administrator or support team: | ||
| * **Agent AI widget URL:** The web address used to open the Agent AI panel. | ||
| * **Bot ID:** Identifies the AI agent that will assist the human agent. |
There was a problem hiding this comment.
It assists right now and not in the future.
| #### Import the script | ||
|
|
||
| 1. Download the **[JSON Studio script](https://raw.githubusercontent.com/Koredotcom/docs-v2/2a6bb9632b62d9b0bc518df3cccba08bdff01c1d/ai-for-service/assets/nice-agent-desktop-digital-chat-messaging-sample.json)** Kore.ai provides for digital chat. | ||
| 2. Open **[NICE CXone Studio](https://na1.nice-incontact.com/studio)** on your Windows computer or access Nice CXone Cloud. |
There was a problem hiding this comment.
Is Windows a prereq? What if I open this on my Mac? If it works only on Windows, then mention it above in the prereq.
| #### Import the script | ||
|
|
||
| 1. Download the **[JSON Studio script](https://raw.githubusercontent.com/Koredotcom/docs-v2/2a6bb9632b62d9b0bc518df3cccba08bdff01c1d/ai-for-service/assets/nice-agent-desktop-digital-chat-messaging-sample.json)** Kore.ai provides for digital chat. | ||
| 2. Open **[NICE CXone Studio](https://na1.nice-incontact.com/studio)** on your Windows computer or access Nice CXone Cloud. |
There was a problem hiding this comment.
"or access Nice CXone Cloud" <- does this mean is there some other way to access the nice cxone cloud? Or is the only way to access it is to open the link provided in the first half of the sentence?
The first half says, open a link, and the second half says "or access the same page". If there are 2 ways to access, then this sentence makes sense. If there's only 1 way, then retain only the first half of the sentence.
| 1. **Kore.ai parameters**: | ||
| 1. Bot Client ID: clientId | ||
| 2. Bot Client Secret: clientSecret | ||
| 3. Bot ID: botId | ||
| 4. Agent AI Widget URL: baseUrl | ||
| 5. Bot language code: `language`. The default value is `en`. See [Supported Languages](/ai-for-service/agentai/agent-experience/supported-languages) for supported AI agent language codes. |
There was a problem hiding this comment.
Reduce this entire list to ONE sentence. Redundant info. And the reduced list must not be 3 levels of nested lists. Stop at 2 levels.
| 3. Add one key-value pair per line to the custom data object. For example: | ||
| 6. customdata.agentName="Agent" | ||
| 7. customdata.agentID="1234" |
| 6. customdata.agentName="Agent" | ||
| 7. customdata.agentID="1234" | ||
|
|
||
| ```javascript |
There was a problem hiding this comment.
Use collapsible code block.
Update product branch with main
|
|
||
| See [NICE CXOne Admin](/ai-for-service/agentai/integration/nice-max/nice-max-desktop-chat-and-voice#nice-cxone-admin) for further details. | ||
|
|
||
| ## Kore.ai Admin |
There was a problem hiding this comment.
It isn't admin of kore.ai. Call it platform admin or something else.
|
|
||
| ## Kore.ai Admin | ||
|
|
||
| Provide the Studio script for digital chat: The support team provisions the Studio script required for the NICE CXone digital chat integration. |
There was a problem hiding this comment.
Is it Kore's support team? Give a link to contact.
| * A NICE CXone administrator account. The account must be allowed to create digital automatic call distribution (ACD) skills, configure digital points of contact, configure digital chat channels, import/edit studio scripts, and assign agents who have the necessary roles and permissions to accept digital chat interactions in Agent Desktop. | ||
| * NICE CXone Studio installed on a supported Windows computer. NICE CXone Studio is the application used to import and edit the integration script. | ||
| * Access to Kore.ai Agent AI, with permission to create or configure an AI agent. | ||
| * The following information from the Kore.ai administrator or support team: |
There was a problem hiding this comment.
There's no kore.ai admin role.
| 5. Test the integration from the customer chat entry point. | ||
| 6. Verify that the Agent AI widget, transcript, custom data, and conversation summary work correctly. | ||
|
|
||
| <Note>This guide applies only to digital chat. Do not configure voice-related settings such as **SIP URI** or **Audio Relay Endpoint**.</Note> |
There was a problem hiding this comment.
Do we want to tell the readers to not configure at all OR not configure using this guide? Consider opening the sentence with "Do not use this guide to configure..."

Published a new integration document