Create Copilot for Agents Profiles

This is the second step of setting up Copilot for Agents. The first step is to contact your account representative to enable Copilot for Agents and Agent Assist Hub for your organization.

You need to create at least one Copilot for Agents profile. You can create additional profiles to customize the Copilot for Agents experience for different business requirements. For example, you may want billing and sales agents to see only customer sentiment, but support agents to see both customer sentiment and KB answers. Each profile is a separate agent assist app.

Complete each of these tasks in the order given.

Enter General Information about the Copilot for Agents Profile

Navigate to the Copilot for Agents Config page and configure the fields on the General tab of the profile.

  1. In NiCE CXone, click the app selector and select General.

  2. Select AI Studio > Profiles.
  3. Click Add Copilot Profile.
  4. In the Copilot Profile Name field, enter a name for this Copilot for Agents profile.
  5. In the Division drop-down, select your division. This field appears only when tenant segmentation is enabled.
  6. In the Profile Type drop-down, select Copilot.
  7. Select the Language you want Copilot for Agents to use.

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

    Response Tone Details
    Formal Suggested responses are precise and proper. For example, "I apologize for the inconvenience this has caused you. Please provide your order number."

    Casual

    Suggested responses are relaxed and friendly. For example, "Oh no! Let's get this fixed. Can I have 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?"
    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?"
    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."

  9. 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.

    • "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."

  10. To display a disclaimer to agents that AI is being used, enable AI Disclosure for Agent. The disclaimer displays to agents as a card in Copilot for Agents.
    1. Enter a title for the disclosure. The default is Legal Disclosure. You can enter up to 75 characters.
    2. In the AI Disclosure Description field, enter a description for the disclosure. For example, Copilot's answers are generated with AI. Always check to make sure the answer is correct before sending. You can enter up to 1000 characters.

Configure the Copilot for Agents Profile

Configure the fields on the Configuration tab of the profile.

  1. Click the Configuration tab at the top of the profile.
  2. Under Channels, select the channelsClosed Various voice and digital communication mediums that facilitate customer interactions in a contact center. you want this Copilot for Agents profile to apply to.
  3. If you see the Remove Legacy Transcription button, you are using an outdated transcription method for phone calls. To use the newer approach, you must edit the Copilot for Agents configuration script to include the CONTINUOUS TRANSCRIPTION Studio action immediately after the AGENT ASSIST action. Additionally, you need to select your transcription service in this action's wizard and configure the properties as described. Once you have updated and confirmed the script is working as expected, click the Remove Legacy Transcription button to remove the legacy transcription method.

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

    Option Details
    Sentiment

    The contact's current mood: Positive, Negative, or Neutral. In the Sentiment Profile menu, select the real-time sentiment prompt profile to use.

    The real-time sentiment is updated every 15 seconds.

    To use Copilot with MAX, disable this setting.

    Real-Time Summary

    Summaries of live interactions. As the interaction progresses, its real-time summary updates. In the Real Time Summary Profile menu, select the real-time sentiment prompt profile to use.

    The real-time summary is updated every 30 seconds.

    To use Copilot with MAX, disable this setting.

    Generate Automated Summary (AutoSummary)

    Generates a summary of finished interactions. By default, the summary appears in the Notes field in the agent application.

    You can optionally select a custom prompt profile to use for the summary from the Automated Summary (AutoSummary) Profile drop-down. The custom prompt must be defined in GenAI Prompts.

    You can configure Automated Summary (AutoSummary) in a number of ways:

    • Disable Automated Summary (AutoSummary).

    • Enable Automated Summary (AutoSummary), but do not show the summary to the agent.

    • Show the summary in the Notes field in the agent application.

    • Show the summary in an Automated Summary (AutoSummary) card.

    • Show the summary in the Notes field in the agent application and in an Automated Summary (AutoSummary) card.

    When the Automated Summary (AutoSummary) card is enabled, it can be configured with several preferences:

    • Open as Expanded: Display the Automated Summary (AutoSummary) card expanded on the Copilot for Agents canvas. If not enabled, the agent needs to click the card to expand and read it.

    • Open to Clipboard: Include a copy button on the card. Agents can click the button to copy the Automated Summary (AutoSummary) to the clipboard.

    • Editable: Allow the agent to make changes to the summary. This option is disabled when Send Automated Summary (AutoSummary) to Outcome Panel is enabled. This prevents the agent from being able to make edits in two different places.

    Note the following:
    Self-Service Transfer Summary

    Generates a summary of a self-service interaction. This assists agents get up to speed quickly when handling an escalated interaction.

  5. 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 account representative if you're interested in knowing more.

    1. In 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. Use the drop-down for Response Length to select the target word count.

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

    Feedback is supported for these channels:

    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 Comments: Enable this to allow agents to enter comments to provide context about their feedback.

    • Feedback Tags: Enable this to allow agents to apply tags to their feedback.
    Negative Feedback

    Allows agents to provide additional context about the KB answers they disliked through:

    • Feedback Comments: Enable this to allow agents to enter comments to provide context about their feedback.

    • Feedback Tags: Enable this to allow agents to apply tags to 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 icon of a thumbs up., tags and a space for comments appear if you enabled them for Positive Feedback. If they select Dislike icon of a thumbs down., tags and a space for comments appear if you enabled them for Negative Feedback.
  7. To enable Copilot for Agents to generate journey summaries, enable Journey Summary. Then configure the other fields in the Journey Summary section to customize the journey summary experience.   

    1. Use the drop-down for Journey Summary Profile to select the prompt profile you want to use for this summary.

      If you enable Journey Summary for Copilot for Agents and if the profile uses Voice skills, ensure that the Studio script creates a customer card (CC) before the agent request step. Customer cards are required for Journey Summary to ingest Autosummaries and Dispositions. Voice interactions do not create Customer Cards by default, so the script must include a CC Create action.

    2. In Interaction Count, enter the number of past interactions you want to include in the journey summary. For example, if you enter 2, only the past two interactions with the contactClosed The person interacting with an agent, IVR, or bot in your contact center. will be used to generate the journey summary. You can enter a number 1 through 5.

    3. In Interaction Period, select the maximum number of days you want to include in the journey summary. For example, if you select Last 30 days, only interactions from the past 30 days will be used to generate the journey summary. You can also select Custom, enter a number of days, and click Save.
    4. In Response Length, select how long you want the journey summary to be: Short (0 - 10 words), Medium (11 - 20 words), or Long (21 - 30 words).
    5. To give agents the option to expand icon of four arrows pointing opposite directions. the journey summary to view details about each of the past interactions, enable Detail View.

Integrate the Copilot for Agents Profile with a Knowledge Base

To integrate Copilot for Agents with your knowledge baseClosed A knowledge management system that hosts knowledge articles. (KB), configure the fields on the Knowledge tab of the profile. There are two connectors you can use to do this:

  • Knowledge Hub: Allows you to connect eGain, NiCE CXone Knowledge Management (Expert), Guru, Microsoft SharePoint, Salesforce, ServiceNow, Zendesk, or a custom knowledge source to Copilot for Agents.

    To use the Knowledge Hub connector, you need a Knowledge Hub knowledge base (KB). Knowledge Hub KBs connect your knowledge source to NiCE CXone. Your account representative creates Knowledge Hub KBs for you.

  • Direct Knowledge Management (Expert) Connector: Allows you to connect NiCE CXone Knowledge Management (Expert) to Copilot for Agents.

Using the Knowledge Hub Connector

  1. Click the Knowledge tab at the top of the profile.
  2. Turn on Enable KB Answers.

  3. In the Knowledge Source drop-down, select Knowledge Hub. In the Knowledge Hub Profile drop-down, select the Knowledge Hub profile used for the KB answers.

  4. In Knowledge Hub Profile drop-down, select the Knowledge Hub knowledge base (KB) to use. Knowledge Hub KBs connect your knowledge source to NiCE CXone. Your account representative creates Knowledge Hub KBs for you.

  5. In KB Query Extraction Prompt drop-down, select the appropriate KB Query Extraction prompt configuration to use. This prompt determines whether a request can be answered from the Knowledge Base and extracts a clean, searchable question from the interaction. You can choose the default system prompt or any custom prompts created in GenAI Prompts under the KB Query Extraction category. For details on how to configure KB Query Extraction Prompt refer to the Configure AI Prompt for Copilot for Agents KB Query Extraction topic.

  6. Enable the Show Automatic KB Answers to automatically display relevant KB answers during an interaction based on the customer’s message. When disabled, KB answers appear only when the agent explicitly triggers them. When enabled, use the KB Answer Type drop-down to choose whether Copilot for Agents return Primary, Secondary, or Both KB Answer responses.

  7. 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. Use the KB Answer Type drop-down to choose whether manual queries return Primary, Secondary, or Both KB Answer responses.

  8. Configure the fields under Primary KB Answer Configuration.

    Field Details
    Card Title Enter the label to display at the top of the Primary KB Answer card in Copilot for Agents. Default is Primary Answer. This value is required and cannot be left blank.
    KB Answer Prompt Use this drop-down to select the prompt profile you want to use for KB answers.
    Article Count The maximum number of KB articles used to generate the KB answer. You can enter a number 1 through 5.
    Primary Assets Are Shareable

    Enable to display the Insert Article icon: a document with a plus sign. and Send Article icon: a paper airplane. icons for links or images from KB answers.
    Primary Like and Dislike Feedback Enable to display the Like icon of a thumbs up. and Dislike icon of a thumbs down. icons for KB answers.
    Primary Process Steps Enable to use the process steps add-on.
    Enable KB Web Links Turns on KB web links.
    Web Link Maximum Count The maximum number of KB web links displayed at once.
    Enable KB Images Turns on KB images.
    Image Maximum Count The maximum number of KB images displayed at once.
    Primary Content Sub-Filters and Metadata

    Allows you select tags and values to filter by. This restricts KB answer access to the knowledge source. For example, Plan = Gold only gives the KB answers access to articles with the Plan filter set to Gold.

    You can configure filters using various operators between filters and filter groups.

    Click Add Filter Group, then configure a filter by entering a key, selecting an operator, and entering a value. Click Add Filter to add another filter to the group. You can add up to five filter groups, with five filters per group.

    9. OPERATOR CONSOLE API FILTER NAME

    SUPPORTED ATTRIBUTES 

    DATA TYPE

    		FILTERED RESULTS
    Equals = equals string, number, boolean Attribute matches the value you provide.
    Not equals != notEquals string, number, boolean Attribute does not match the value you provide.
    Starts with ^ startsWith string, number, boolean Attribute starts with the value you provide.
    Greater than > greaterThan number Attribute is greater than the value you provide.
    Greater than or equals >= greaterThanOrEquals number Attribute is greater than or equal to the value you provide.
    Less than < lessThan number Attribute is less than the value you provide.
    Less than or equals <= lessThanOrEquals number Attribute is less than or equal to the value you provide.
    In : in string list Attribute is in the list you provide.
    Not in !: notIn string list Attribute is not in the list you provide.

  9. If you turned on Enable Secondary KB Answers, configure the fields under Secondary KB Answer Configuration.

    Field Details
    Card Title Enter the label to display at the top of the Secondary KB Answer card in Copilot for Agents. Default is Secondary Answer. This value is required and cannot be left blank.
    KB Answer Prompt Use this drop-down to select the prompt profile you want to use for KB answers.
    Article Count The maximum number of KB articles used to generate the secondary KB answer.

    Answer Length

    The maximum word count for secondary KB answers.
    Secondary Assets Are Shareable

    Enable to display the Insert Article icon: a document with a plus sign. and Send Article icon: a paper airplane. icons for links or images from secondary KB answers.
    Secondary Like and Dislike Feedback Enable to display the Like icon of a thumbs up. and Dislike icon of a thumbs down. icons for secondary KB answers.
    Secondary Process Steps Enable to use the process steps add-on.
    Enable KB Web Links Turns on KB web links.
    Web Link Maximum Count The maximum number of KB web links displayed at once.
    Enable KB Images Turns on KB images.
    Image Maximum Count The maximum number of KB images displayed at once.
    Secondary Content Sub-Filters and Metadata

    Allows you select tags and values to filter by. This restricts KB answer access to the knowledge source. For example, Plan = Gold only gives the KB answers access to articles with the Plan filter set to Gold.

    You can configure filters using various operators between filters and filter groups.

    Click Add Filter Group, then configure a filter by entering a key, selecting an operator, and entering a value. Click Add Filter to add another filter to the group. You can add up to five filter groups, with five filters per group.

    Click Apply Filters from Primary to copy the tags you specified in this setting under Primary KB Answer Configuration.

  10. If you enable Include Agent Utterances Copilot uses both customer and agent utterances when generating suggested responses. When disabled, Copilot bases suggestions only on customer utterances.

  11. Click Save. The Copilot for Agents profile is now created.

Using Direct Knowledge Management (Expert) Connector

  1. Click the Knowledge tab at the top of the profile.
  2. Click Enable KB Answers.

  3. In the Knowledge Source drop-down, select Knowledge Management (Expert).

  4. Enter your Client Key, Client Secret, and Site URL.
  5. To limit this Copilot for Agents profile's access to a specific section of your Knowledge Management (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.
  6. To limit the number of Knowledge Management (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. You can enter a number 1 through 5.

  7. To require a match percentage for kernels, enter the decimal form of a percentage in Kernel 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. You can enter a number 0.05 through 0.9.

    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.

  8. Under Knowledge Management (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.

  9. 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 Knowledge Management (Expert) knowledge base to do this.

  10. In Knowledge Management (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 Knowledge Management (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 Knowledge Management (Expert) articles when generating KB answers. In the Public and Private Content Presentation drop-down, select one of the following:

    • Public-only: Only use public Knowledge Management (Expert) articles to generate KB answers.

    • Private-only: Only use private Knowledge Management (Expert) articles to generate KB answers.

    • Separate Public and Private: Use both public and private Knowledge Management (Expert) articles to generate KB answers. Information from public Knowledge Management (Expert) articles is displayed in the main KB answer card. Information from private Knowledge Management (Expert) articles is displayed in a sub-card.

    • Combine Public and Private: Use both public and private Knowledge Management (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 Knowledge Management (Expert) articles can be shared with customers through digital interactions:

      • Disable Private Shareable Assets to hide the Insert Article icon: a document with a plus sign. and Send Article icon: a paper airplane. 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 icon: a document with a plus sign. and Send Article icon: a paper airplane. 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.

  11. To allow agents to provide feedback about KB answers generated using public KB articles, enable Public Feedback. You can configure the types of feedback agents can provide in the Feedback Detail Card section on the Configuration tab.

  12. To allow agents to provide feedback about KB answers generated using private KB articles, enable Private Feedback. You can configure the types of feedback agents can provide in the Feedback Detail Card section on the Configuration tab.

  13. In the Response Length drop-down, select the target word count for KB answers.

  14. Enable KB Web Links to display links to knowledge articles. These links can be generated from any supported knowledge source, not only Knowledge Management (Expert). Configure the Maximum number of links that are displayed. You can enter a number from 1 through 5.

  15. Enable KB Images to display images from knowledge content, based on connector capabilities. Configure the Maximum number of images that are displayed. You can enter a number from 1 through 5. To see which connectors support image parsing and document attachments, refer to Connector Support for Image Parsing and Document Parsing.

  16. 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 account representative must first enable Process Steps for your system.

  17. Click Save. The Copilot for Agents profile is now created.

Enable AI Agents (Cognigy) for Process Automation (Task Assist)

The Process Automation tab is where you add, configure, activate, deactivate, and manage workflows for a Copilot profile, and define how they use conversation data.

  1. In NiCE CXone, click the app selector and select General > AI Studio > Profiles.

  2. Select the profile you want, then open the Process Automation tab.

  3. Add a Workflow

    1. On the Process Automation tab, select Add a Workflow . The All Workflows window opens.

    2. Use the Search field to find a workflow by name or keyword, or filter by Project using the Select Projects dropdown.

    3. Select the checkbox next to each workflow you want to add (you can add more than one), then select Confirm. The workflows appear in the workflow table on the tab.

  4. Set the workflow timeout: In the Workflow Timeout (in seconds) field, set the maximum time Copilot waits for a response from AI Agents (Cognigy) after starting a workflow. If no valid response arrives in time, the request times out. The default is 30 seconds.

  5. Send conversation context (optional): Turn on Add conversation context to let the workflow use information from the live conversation. Choose one:

    • Send Full Transcript — sends the entire conversation history.

    • Send Transcript Summary — sends a condensed summary instead of the full transcript.

  6. Define the form (Form Designer): The Form Designer defines the form an agent fills in for the workflow. Forms use the Adaptive Card format (version 1.6).

    1. In the Select Template dropdown, choose a predefined template — the editor fills in with a ready-made form layout. Or, to build your own, paste your Adaptive Card schema into the schema field. You can create or edit a schema at adaptivecards.io/designer.

    2. Select Preview to see how the form will look to an agent.

    3. Select Clear Form to remove the current schema if needed.

    4. Select Save to apply the form to the workflow.

  7. Pre-fill form fields (optional): The Form Pre-Fill Logic section lets a form open with fields already filled in, so agents don't re-enter information that's already known. Choose a template, or add fields manually:

    1. Select Add Field.

    2. Enter a Field Name to identify the form field.

    3. Select a Field Source: Transcript (the system uses AI to find the value in the conversation) or JSON Data (the value comes from data passed in from a Studio script).

    4. Enter a Field Description to help the system find the right value in the transcript.

    5. If the source is JSON Data, enter the JSON Key that matches the key configured in your Studio script. A sample script snippet is provided for reference.

    6. Repeat for each field.

    • The Field Name in Form Pre-Fill Logic must exactly match the field's ID in the Adaptive Card schema. If they don't match, the field won't pre-fill.

    • Pre-fill applies to the starter form defined here in the Copilot Profile. In-flow forms (built inside the AI Agents (Cognigy) flow) drive the step-by-step experience and are populated within the flow itself — using data passed in from Studio or collected at an earlier step — rather than through this pre-fill section.

  8. Only active workflows can be triggered by agents.

    1. On the Process Automation tab, find the workflow in the table.

    2. Select the More options (⋮) icon next to it.

    3. Select Activate or Deactivate.

    4. Select Save if prompted.

    An activated workflow shows as Active; a deactivated one shows as Inactive.

  9. Rules and automatic triggering (optional): The Associated Rules section shows any rules linked to the workflow. Rules can trigger a workflow automatically based on conditions. A rule can run a workflow in one of two modes:

    1. Recommended — the workflow is suggested to the agent, who chooses whether to run it.

    2. Auto Run — the workflow runs automatically, without agent action.

    Use Recommended for anything the customer experiences directly or where the agent should stay in control. Reserve Auto Run for routine, low-risk steps.

    When you're done, select Save to apply your changes on the Process Automation tab.

Assign Skills and a Transcription Service

Configure the fields on the Assignments tab of the profile.

If you have already set up Copilot for Agents using scripting, you can continue with that implementation. If you are new to Copilot for Agents, and you are fine using skills to determine Copilot for Agents assignments, you can use the Assignments tab to assign skills and skip the scripting step.

  1. Click the Assignments tab at the top of the profile.

  2. Set Voice Transcription Provider to your transcription service.

  3. In the Assign Skills to Copilot section, click Add Skills to select the skills to assign to the profile.

  4. Click Add to List after selecting all the desired skills select the skills to assign to the profile.

  5. Click Save.

Assign a Rule to a Copilot for Agents Profile

Before you assign a rule to a Copilot for Agents profile, you must create the rule and add at least one element to it. For more information, see Create a Rule and Add an Element .

  1. Select the Rules tab at the top of the profile.

  2. Click Add Copilot Rule.

  3. In the Add Copilot Rule window, search for a specific rule or select a rule from the list.

  4. Click Confirm.