Create Enlighten Copilot for Agents Profiles

After initially setting up Enlighten Copilot for Agents with help from your CXone Account Representative, you must create a Studio script and an Enlighten Copilot for Agents profile in CXone. You can create additional profiles to customize the Enlighten Copilot for Agents experience for different business requirements. For example, you may want billing and sales agents to see only next-best responses, but support agents to see both next-best responses and KB answers.

Complete each of these tasks in the order given.

Create a Script for Copilot for Agents

Required permissions: Studio Script View, Create/Edit

You need to create or modify at least one Studio script to set up Copilot for Agents in your contact center. The scripts must:

Be designed to route interactions by skills Used to automate delivery of interactions based on agent skills, abilities, and knowledge to the agents you want Copilot for Agents to be available for.
Include the Agent Assist Studio action. It must be placed in your script after the ONANSWER or ONASSIGNMENT action.
Include a SNIPPET action before the AGENT ASSIST action, if you're working with a digital script. Give this SNIPPET action a Caption of Set AgentID. Copy the following line of code and paste it into the Text View tab of the Editor window.

ASSIGN global:__AgentId = "{AGENTID}""

To complete the configuration of your script:

Add initialization snippets to the script using Snippet actions. You can do this to customize your agent assist application.
Reconfigure the action connectors to ensure proper contact flow and correct any potential errors.
Complete any additional scripting and test the script.

Filter KB Answers by CXone Expert Tags

You can optionally use CXone Expert tags to filter KB answers. To do this, you can configure two kinds of tag lists:

Standard tag list: The Copilot for Agents profile can only access KB articles with the tags in this tag list. It generates KB answers using only those KB articles.
Custom tag list: Agents can select tags from a custom tag list to filter KB answers. You can specify up to five custom tag lists per Copilot for Agents profile.

In Studio, open the script you're configuring for Copilot for Agents.
If you haven't already, add an Agent Assist action after ONANSWER or ONASSIGNMENT. Select the Agent Assist action.

Configure the Agent Assist action's scriptParams property with a list of the CXone Expert tags you want to filter by, in this format:


{"expertTags":
	{"standard":["Tag1","Tag2","Tag3","Tag4","Tag5"],
	"custom":[
		{"name":"Name of Tag List 1",
		"values":["Tag1","Tag2"],
		"default":["Tag1"]},
		{"name":"Name of Tag List 2",
		"values":["Tag3","Tag4"],
		"default":["Tag4"]}
		]
	}
}

View an example tag list


{"expertTags":
	{"standard":["2021","2022","2023","2024","2025"],
	"custom":[
		{"name":"PlanYear",
		"values":["2024","2025"],
		"default":["2024"]},
		{"name":"PlanLevel",
		"values":["Platinum","Gold","Silver","Bronze"],
		"default":["Gold"]}
		]
	}
}

Where default is the tag that's automatically selected from the custom tag list. Make sure the names of the tags you enter exactly matches the names of the tags in your CXone Expert knowledge base.

Save your script.

Create a Copilot for Agents Profile

Permissions Required: Integrations > Launch Integrations

You need to create at least one Copilot for Agents profile in Agent Assist Hub. Each profile is a separate agent assist app in Agent Assist Hub.

Enter General Information about the Copilot for Agents Profile

Navigate to Agent Assist Hub and configure the fields on the General Information tab of the profile.

Click the app selector and select Other > Automation & AI and then click Agent Assist Hub.
Click Add Agent Assist App.
In the Agent Assist App Name field, enter a name for this Copilot for Agents profile.
In the list under Select Agent Assist App Type, click Enlighten Agent Copilot.
Select the Language you want Copilot for Agents to use.
Enable HIDE RTIG PANEL FOR AGENT. Copilot for Agents will not work correctly if it is disabled.

In the Generative Response Tone drop-down, select the tone of voice you want Copilot for Agents to use.

Learn more about response tones

Response Tone	Details
Casual	Suggested responses are relaxed and friendly. For example, "Oh no! Let's get this fixed. Can I have your order number?"
Confident	Suggested responses are sure and upbeat. For example, "Don't worry. I'll make sure this problem gets fixed. Can you please send me your order number?"
Empathetic	Suggested responses show empathy for the contact's negative experience. For example, "I'm sorry you're having trouble with your order. This must have been difficult to deal with. I'm here to help! To start, can you send me your order number?"
Formal	Suggested responses are precise and proper. For example, "I apologize for the inconvenience this has caused you. Please provide your order number."
Instructive	Suggested responses provide clear, straightforward instructions. For example, "Send me your order number. To find it, open your profile and scroll down to the My Orders section."

In the Copilot Persona field, enter a short, specific persona description for this Copilot for Agents profile. The persona description describes its role and purpose. For example, You are a friendly agent assistant answering questions about billing. This gives Copilot for Agents context and instructions to help it generate more relevant suggestions. The maximum character count is 250.

Make your Copilot Persona description concise and easy to understand. A poorly written description may result in poor suggestions from Copilot for Agents.
View example descriptions
- "You're a technical expert answering questions about our appliance company, OneAppliance. OneAppliance sells and services washers, dryers, and dishwashers. Be succinct and use technical language."
- "You're an assistant for customer service agents answering questions about our university, OneUniversity. One University is an accredited four-year online university. Be friendly and use concise language."
- "You're a banking expert answering questions about our bank, OneBank. Common topics include personal finance, investing, and taxes. Your specialty is taxes. Be as concise as possible."
Click Next.

Configure the Copilot for Agents Profile

Configure the fields on the Configuration tab of the profile.

Under Channels, select the channels A way for contacts to interact with agents or bots. A channel can be voice, email, chat, social media, and so on. you want this Copilot for Agents profile to apply to.
If you selected Voice in the previous step, select a Transcription Service.

In the AI Response Settings section, enable the types of content you want Copilot for Agents to generate.

Learn more about fields in this step

Option	Details
Sentiment	The contact's current mood: Positive, Negative, or Neutral. Includes the reason for the sentiment. Use the drop-down for Reason Length to set the target word count.
Real-Time Summary	Summaries of live interactions. As the interaction progresses, its real-time summary updates. Use the drop-down for Response Length to select the target word count.
Final Summary	Summaries of finished interactions. These appear in the Notes field in CXone Agent. They can be passed to a supported CRM Third-party systems that manage such things as contacts, sales information, support details, and case histories. application. Use the drop-down for Response Length to select the target word count.
Agent Transfer Summary	Summaries of interactions before they were transferred. These appear to receiving agents, allowing them to catch up on the contact's conversation with the previous agent. Use the drop-down for Response Length to select the target word count.
Behavioral Guidance	Suggested responses based on what the contact says. For example, if a contact says their order is late, the suggested response could be, "I'm sorry your order is late. I'm here to help!" Use the drop-down for Response Length to select the target word count. In the # Of Response field, enter the number of responses you want Copilot for Agents to generate at a time.

To enable Copilot for Agents to generate email responses, enable Email Channel. Then configure the other fields in the Email Channel section to customize the email experience.

This feature is part of a Controlled Release program. Contact your CXone Account Representative if you're interested in knowing more.
1. In Copilot Email Editing Options, select the editing options you want to appear to agents. Agents can use these to prompt Copilot for Agents to edit parts of its generated email response. The options include:
  - Simplify: Use simpler, fewer words.
  - Rephrase: Rewrite generally.
2. To allow agents to add custom topics to topic lists, enable Custom Selections. Copilot for Agents generates email responses about the topics in these lists.
3. Use the drop-down for Response Length to select the target word count.

In the Feedback Detail Card section, enable the types of feedback you want agents to provide about Copilot for Agents.

Learn more about fields in this step

Option	Details
Overall Subcard	Allows agents to enter general feedback about their experience with Copilot for Agents.
Per-Suggestion Subcards	Allows agents to provide feedback about each KB answer generated during the interaction.
Positive Feedback	Allows agents to provide additional context about the KB answers they liked, inserted, or sent through: Feedback Tags: Enable this to allow agents to apply tags to their feedback. Feedback Comments: Enable this to allow agents to enter comments to provide context about their feedback.
Negative Feedback	Allows agents to provide additional context about the KB answers they disliked through: Feedback Tags: Enable this to allow agents to apply tags to their feedback. Feedback Comments: Enable this to allow agents to enter comments to provide context about their feedback.
Unrated Feedback	Allows agents to like or dislike KB answers they didn't like or dislike during the interaction. If they select Like , tags and a space for comments appear if you enabled them for Positive Feedback. If they select Dislike , tags and a space for comments appear if you enabled them for Negative Feedback.

Click Next.

Integrate the Copilot for Agents Profile with a CXone Expert Knowledge Base

To integrate Copilot for Agents with your CXone Expert knowledge base A website that stores troubleshooting articles. (KB), configure the fields on the Knowledge tab of the profile.

Turn on Enable Expert Copilot Integration.
Enter your Client Key, Client Secret, and Site URL.
To limit this Copilot for Agents profile's access to a specific section of your CXone Expert KB, enter the path to that section in Default Path. It should be in this format: Page/Subpage. For example, if you enter Laundry/Dryers, Copilot for Agents will only have access to articles in the Laundry > Dryers section of the site. Click + to add more paths.
To limit the number of CXone Expert kernels Copilot for Agents uses when generating content, enter a numeral in Kernel Limit. For example, if you enter 2, Copilot for Agents only uses the top two kernels that relate to the contact's issue.
To require a match percentage for kernels, enter the decimal form of a percentage in Kernel Relevance Threshold. For example, if you enter 0.85, Copilot for Agents doesn't use kernels that are less than 85% a match for the contact's issue. The default value is 0.6.

Testing is useful in determining your optimal match percentage. It depends on the kind of questions contacts ask and the kind of knowledge content you have. If Copilot for Agents is providing too many unhelpful responses, increase your match percentage.
Under Expert Copilot Features, enable Agent Manual Query Input to display a search bar at the bottom of Copilot for Agents. This search bar allows agents to prompt Copilot for Agents.
Enable KB Answers to have Copilot for Agents suggest responses with solutions to the contact's issue. Copilot for Agents uses the articles in your CXone Expert knowledge base to do this.
In CXone Expert, you can assign each article a privacy status using the Page Privacy setting . The possible privacy statuses are Private, Public, Semi-Private, and Semi-Public. Copilot for Agents only distinguishes between public and private Expert articles. Articles with a Page Privacy of Private or Semi-Private are considered private articles. Articles with a Page Privacy of Public or Semi-Public are considered public articles.

You can configure how this Copilot for Agents profile handles public and private Expert articles when generating KB answers. In the Public and Private Content Presentation drop-down, select one of the following:
- Separate Public and Private: Use both public and private Expert articles to generate KB answers. Information from public Expert articles is displayed in the main KB answer card. Information from private Expert articles is displayed in a sub-card.
- Public-only: Only use public Expert articles to generate KB answers.
- Private-only: Only use private Expert articles to generate KB answers.
- Combine Public and Private: Use both public and private Expert articles to generate KB answers. Combine content from both into the same KB answer card.
1. If you selected Separate Public and Private, Private-only, or Combine Public and Private in the Public and Private Content Presentation drop-down, configure the Private Shareable Assets field. This field determines if content from private Expert articles can be shared with customers through digital Any channel, contact, or skill associated with Digital Experience. interactions:
  - Disable Private Shareable Assets to hide the Insert Article and Send Article icons for private KB answers. Agents will not be able to send links or images from private KB answers.
  - Enable Private Shareable Assets to show the Insert Article and Send Article icons for private KB answers. Agents will be able to send links and images from private KB answers.
2. If you selected Separate Public and Private or Private-only in the Public and Private Content Presentation drop-down, customize the KB answer card for private KB answers:
  - In Private Response Title, enter the title of the private KB answer card. You can use this to alert agents that the content in this KB answer is private. For example, Internal Use Only.
  - In Private Response Tooltip, enter the hover tooltip text for the private KB answer card.
In the Response Length drop-down, select the target word count for KB answers.
Enable KB Web Links to display links to articles in your CXone Expert knowledge base. Configure the Maximum number of links that are displayed.
Enable KB Images to display images from articles in your CXone Expert knowledge base. Configure the Maximum number of images that are displayed.
Enable Process Steps to break down KB answers into individual steps. Agents can send one step at a time to walk the contact through the process of solving their issue.

In order to see this option, your CXone Account Representative must first enable Process Steps for your system.
Click Create.

Assign a Profile to a Studio Script

Required permissions: Studio Script View, Create/Edit

Use these example scripts for voice and digital.

In Studio, open the script you want to use.
If you haven't done so already, add the Agent Assist action to the correct location in your script.
Double-click the Agent Assist action to open Agent Assist Hub.
In the left column, click the checkmark in a circle next to the agent assist application or profile you want to assign to this script.
Click Close.

Assign Multiple Profiles to a Studio Script

Required permissions: Studio Script View, Create/Edit

You can use Studio variables to assign multiple Copilot for Agents profiles to one Studio script. You then use logic code that determines when each profile is used.

Use these example scripts for voice and digital.

These steps describe a simple example of assigning two Copilot for Agents profiles to one script. Your script might be more complex. Contact CXone Services for the best design and implementation.

In Studio, open the script you want to use.
If you haven't done so already, add an AGENT ASSIST action to the correct location in your script.
Add a SNIPPET action before the AGENT ASSIST action and connect them.
Double-click the SNIPPET action.
In the Snippet editor window, create three variables. You need two variables to hold the Copilot for Agents profile names, and one variable to hold the name of the profile you want the script to use when it runs.
View example code
```
ASSIGN profile1="Profile1"
ASSIGN profile2="Profile2"
ASSIGN profileToUse = "profile2"
```
Underneath those variables, enter logic code that determines when each profile is used. This code changes the value of the profileToUse variable.
Double-click the AGENT ASSIST action to open Agent Assist Hub.
For each Copilot for Agents profile you want to use:
1. Click the profile name in the left column.
2. Copy the profile name from the General tab.
  
  View image
3. Paste it into the snippet code you created previously as the value of one of the profile name variables. In the previous example code, the variable names are profile1 and profile2.
  View example code
```
ASSIGN profile1="MyCopilot"
ASSIGN profile2="MyCopilot2"
ASSIGN profileToUse = "profile2"
```
Right-click the AGENT ASSIST action. In the assistLaunchConfigName property, enter {profileToUse}. This is the name of the variable that holds the profile you want the script to use, enclosed in curly brackets.

View image
Save your script.