Getting started with AI Copilot¶
In this getting started guide, you will learn how to configure your AI Copilot Workspace.
Before you Begin¶
AI Copilot is automatically activated on Cognigy Trial and Cognigy shared SaaS environments.
To activate this feature in other environments, do the following:
- On Cognigy dedicated SaaS environment, contact Cognigy technical support.
- On Cognigy on-premises environment, install Cognigy AI Copilot with Cognigy.AI Helm Chart.
Create Flows¶
To get started with the service:
- Go to the Cognigy.AI interface.
- Create a virtual agent or use an existing one.
- Copy the Project ID from your URL, for example,
https://app.cognigy.ai/agent/642c6a2cb45919dfae7b4428/
, where the Project ID is642c6a2cb45919dfae7b4428
. - Save the copied Agent ID for the later use.
- Go to the left-side menu and click Build > Flows.
- Create a Flow or use an existing one, which will include a handover or transfer to a human agent
- Create the additional flow for AI Copilot.
Check that you have two Flows: the Main Flow and the AI Copilot Flow.
Configure the AI Copilot Config¶
With the AI Copilot Config API you can configure the position and size of the tiles in your grid. This gives full flexibility to use the AI Copilot Workspace as efficient as possible.
Get an API Key¶
To get your API key, follow these steps:
- In the upper-right corner of the Cognigy.AI interface, click User Menu > My Profile.
- In the API Keys section, click +.
- Add an API key name and click Confirm. The API key will appear in the list.
- Copy this API Key and go to the AUTHENTICATION section on the Cognigy OpenApi site.
- Paste the API Key to the following fields:
- API Key (X-API-Key)
- API Key (api_key)
- Click Set near both fields.
Create an AI Copilot Config¶
To create your AI Copilot Config, follow these steps:
- Create an AI Copilot configuration by using the Post request.
- Define the grid size in the
config.grid
object of the configuration by specifying the number of rows and columns. - Choose the placement of your tiles by adding the starting position and size of each tile in your grid.
- Add the Project ID you copied earlier to ensure that the Config is mapped to the right Agent.
{
"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"
}
When the request is created, you will see the response code 201
.
Create an Endpoint¶
To create your Endpoint, follow these steps:
- Go to the Cognigy.AI interface.
- In the left-side menu, select Deploy > Endpoint.
- Click +New Endpoint.
- In the New Endpoint window, add an Endpoint name and select your virtual agent Flow that hands you over to a human agent.
- In the Endpoint type list, select your desired Endpoint.
- Click Save.
- Go to Handover Settings.
- In Copilot Flow, select the AI Copilot Flow, that you created in the first steps.
- In Copilot Config, select the config, which you recently created via API.
- (Optional) A transcript tile to display the conversation with the customer can be added by enabling the toggle in the AI Copilot Settings.
- Click Save.
Configure an AI Copilot Flow¶
- To configure your first workspace, go into to the AI Copilot Flow.
- Add your desired AI Copilot Flow Nodes.
- Add the content, which will be displayed within the AI Copilot Workspace.
- Ensure that the tile ID in the Nodes matches the tile ID chosen in the AI Copilot configuration; this defines the size and placement of the widgets within the Workspace.
Explore an AI Copilot workspace¶
To observe the AI Copilot workspace, start a conversation with your virtual agent.
At one point, you will be handed over to a human agent.
If you are using the standalone
version of AI Copilot, you will receive the link to your AI Copilot Workspace at this point.
When a customer is handed over, not only is the conversation history with the bot and the current intent forwarded to the human agent, but also a specific link to access the AI Copilot Workspace.
In case you are using the embedded
version, the AI Copilot Workspace will be shown within an iFrame in your Agents Desktop.
Once the human agent engages with the conversation, the grid will show an empty state with outlines of the widgets.
The widgets will populate their content once the customer starts the conversation.