Create and integrate Customer Experience Agent Studio agents

Before you can create any kind of virtual agent, you must create a CX Agent Studio agent and integrate it with CCAI Platform. This section explains how to do that.

Create CX Agent Studio virtual agents

For information about creating a Customer Experience Agent Studio virtual agent, see Agents .

Create conversation profile for CX Agent Studio virtual agents

For information about how to create a conversation profile for your CX Agent Studio agent, see Connect an agent application to a new conversation profile

CCAI Platform integrates with CX Agent Studio using the Dialogflow API. To access the API, you need a Google Cloud service account and an associated key. Because these are project-specific, you can reuse them if you are using multiple virtual agents from a single project.

The following steps walk you through creating a service key in Google Cloud. For more information about Google service accounts see What are service accounts?

If you have already created a service key with access to CX Agent Studio, you can skip this section. Note that you must enter a service key into the CCAI Platform Portal to link a CX Agent Studio virtual agent.

To create a service account, grant the correct permissions and generate a service account key. Follow these steps:

  1. Navigate to the Google Cloud console . A default project appears.

  2. In the toolbar drop-down, select the Google project that you used to set up your CX Agent Studio agent.

  3. Select IAM & Admin.

  4. In the side navigation select Service Accounts. The service account console will load.

  5. Click +Create Service Account.

  1. Enter the service account details.

    1. Display name for this service account.

    2. Service account ID is required and must be unique.

    3. Describe what this service account will do.

    4. Grant this service account access to a project.

  2. In the Select a roledrop-down: Assign the Dialogflow API Admin role to the service account.

  3. Click Continue.

The Google Cloud service accounts page displays any service accounts associated with your project.

Service accounts page

To create a service account key see Create a service account key . Follow Google recommended best practices for storing your key.

Based on how your company handles segmentation within Customer Experience Agent Studio, you can create multiple virtual agent platform entries and add specific Customer Experience Agent Studio agents, or create one platform with many Customer Experience Agent Studio agents.

Repeat the previous steps for each Customer Experience Agent Studio agent that you need to onboard to the CCAI Platform Portal.

Add a virtual agent platform

Select this option to onboard virtual agents built using CX Agent Studio.

  1. Go to Settings > Developer settings > Virtual agent platform.

  2. Click + Add Platform.

    The Add a virtual agent platformdialog appears.

    Add a virtual agent platform page

  3. Enter a name for the new platform, consider using the project name that the virtual agents were created in.

  4. Select from the following service:

    • Conversational Agents / CX Agent Studio
  5. Click Create.

  6. Adjacent to the new virtual agent platform in the virtual agent platforms list, toggle the virtual agent platform to On.

Virtual agents onboarded using CX Agent Studio will use the StreamingAnalyzeContent API that will best support DTMF inputs and future virtual agent upgrades.

Virtual agent platform statuses

CCAI Platform validates service account keys based on JSON structure and key validity. A CX Agent Studio virtual agent is fully authenticated only when its key is in the Validstate:

  • Valid: All workflows in the platform are valid.

  • Needs Attention: One or more workflows in the platform are Invalid. Replace with valid service account keys to resolve.

  • Invalid:All workflows in the platform are Invalid. When a platform status is invalid, the platform is automatically disabled. Replace invalid service account keys with valid keys to resolve.

If the status is Invalidor Needs Attention,generate service account keys for any invalid keys, and replace the invalid keys with the new ones. For more information, see Create and delete service account keys .

When the configuration steps are complete, your virtual agents are ready. For more information about how to manage them, see Assign virtual agents to queues .

Design a Mobile Site
View Site in Mobile | Classic
Share by: