Skip to content

AI Copilot Configuration

The AI Copilot configuration refers to the size and position of widgets in your grid. The AI Copilot workspace can be customized to display various types of content, including HTML, adaptive cards, or iframes. This customization enables human agents to quickly access important data, such as user profiles or ticket information related to the user's issue, without needing to spend additional time searching the knowledge database.

AI Copilot comes with a default, pre-configured grid, which you can modify by using the Copilot: Set Grid Node. Alternatively, the AI Copilot configuration can be created, modified, and deleted using the AI Copilot API and can serve as a template if selected from the Copilot Config within the Endpoint settings.

AI Copilot Grid

The AI Copilot workspace is based on a fully customizable grid layout, where widgets can be added to display different information.

The grid gives you the possibility to configure the number of columns, rows, as well as the gaps between them.

You can edit the grid in the following ways:

(Optional) Create a Custom Grid via the API

If you want to create a new AI Copilot Config template instead of using the default one, you can do so in the API.

Create an API Key

  1. Open the Cognigy.AI interface.
  2. On the Projects page, in the upper-right corner, click User Menu user-menu > My Profile.
  3. In the API Keys section, click +.
  4. Add an API key name and click Confirm. The API key will appear in the list.
  5. Copy this API Key and go to the AUTHENTICATION section on the Cognigy OpenApi site.
  6. Paste the API Key to the following fields:
    • API Key (X-API-Key)
    • API Key (api_key)
  7. Click Set near both fields.
  8. Go to your Project in Cognigy.AI.
  9. Copy the Project ID from your URL, for example, https://app.cognigy.ai/agent/642c6a2cb45919dfae7b4428/, where the Project ID is 642c6a2cb45919dfae7b4428.
  10. Go to the Post request.
  11. Add the Project ID you copied earlier to the projectId field in the JSON body of the request.
  12. Check your connection by clicking Try.

When the request is created, you will see the response code 201.

Create a Custom Grid using the API Post Request

To create your custom AI Copilot Config Grid with the API, follow these steps:

  1. Go to the Post request.
  2. Define the grid size in the config.grid object of the configuration by specifying the number of rows and columns.
  3. Choose the placement of your tiles by adding the starting position and size of each tile in your grid.
  4. Add the Project ID you copied earlier to ensure that the Config is mapped to the right Project.

{
   "name": "AI Copilot Config sample",
   "description": "A sample configuration for AI Copilot showcasing the layout of tiles",
   "config": {
      "grid": {
         "columns": 3,
         "rows": 8,
         "gap": 10
      },
      "tiles": {
         "identity-assist": {
            "x": 1,
            "y": 1,
            "rows": 4,
            "columns": 1
         },
         "transcript-assist": {
            "x": 2,
            "y": 1,
            "rows": 2,
            "columns": 2
         },
         "next-action": {
            "x": 2,
            "y": 3,
            "rows": 2,
            "columns": 2
         },
         "knowledge-assist": {
            "x": 2,
            "y": 5,
            "rows": 4,
            "columns": 2
         },
         "event-assist": {
            "x": 1,
            "y": 5,
            "rows": 4,
            "columns": 1
         }
      }
   },
   "projectId": "your-project-id"
}
5. Create the request by clicking Try.

When the request is created, you will see the response code 201.

Tile ID

Version badge

Each tile must have a name, for example, map, profile, or history, that works as a unique identifier. This exact tile ID is needed for the AI Copilot Node configuration, to ensure the content is displayed in the right Widget.

If AI Copilot receives updates for a Tile ID not present in the AI Copilot configuration, the tile will not be rendered. In such cases, a warning indicator will be displayed in the lower-right corner of the workspace, indicating that an "unknown tile update" has been received.

URL

Version badge

If you are using AI Copilot as a standalone application, the AI Copilot URL follows the pattern:

https://${AICopilotBaseUrl}/?userId=${userId}&sessionId=${sessionId}&URLToken=${URLToken}

Where:

  • AICopilotBaseUrl — the base URL of AI Copilot. It represents the main web address where the AI Copilot service is hosted.
  • sessionId — the Cognigy Session ID. A session is a period of interaction or communication between the human agent and the AI Copilot Workspace.
  • userId — the Cognigy User ID. It helps AI Copilot associate the interaction with a specific user, allowing for tracking user-specific information.
  • URLToken — the Endpoint token on the Cognigy side. To find this token, navigate to the Endpoint linked with AI Copilot. In the Config URL field, copy the token found after https://endpoint-trial.cognigy.ai. For example, in the URL https://endpoint-trial.cognigy.ai/f38791ae20d4961acf0e97d9f377c4fe3df92894e1eff1c7a774a8ed089a4590, the token would be f38791ae20d4961acf0e97d9f377c4fe3df92894e1eff1c7a774a8ed089a4590. Note that only authorized users can access or interact with the AI Copilot system through this URL.

For example:

https://ai-copilot-trial.cognigy.ai/?sessionId=session-17738489-e767-4d47-b669-cb0dd2e899e0&userId=52476cc5-710c-40db-8108-e99109f45d91&URLToken=a4d5c86c98f27730311591f28d194510e05ffed30ca148e3344970defd418e7d

If you are utilizing the embedded AI Copilot workspace, you can also use this URL to investigate the workspace before deploying it to production.

Transcript Tile

The Transcript Tile in the AI Copilot workspace acts as a chat interface for human agents. It allows them to seamlessly read messages from end users and respond without having to switch back to the main chat interface.

To activate the Transcript Tile feature for the AI Copilot workspace, go to the Endpoint Settings editor and then to the Copilot section. This Tile is recommended only for contact centers that use a standalone AI Copilot workspace, such as the one provided by Genesys.

The Transcript Tile feature is intended specifically for chat use cases. For voice-related scenarios, use the Copilot: Transcript Tile Node.

Setting Description
Enable Transcript Tile with ID 'transcript' in the AI Copilot Workspace If the option is enabled, you can view the session messages on the Transcript Tile. To display this tile, you must include the transcript tile ID it in your AI Copilot Config via API.
Enable the chat input for the Transcript Tile to enable the agent to send messages to the customer If the option is enabled, the human agent can send messages to the end user from the Transcript Tile.
Enable redaction of Transcript Tile messages If the option is enabled, a credit card number in the messages of the Transcript Tile will be masked and replaced with the placeholder CREDIT_CARD_NUMBER.

More Information