Create and analyze a conversation using the console

Prerequisites

  1. Make sure that the Cloud Storage, Speech-to-Text and Insights APIs are enabled on your Google Cloud project.

Overview

Conversations can be viewed in Conversational Insights after a corresponding Conversation object has been created and analyzed. This how-to guide walks you through the process of creating and analyzing a conversation using the Insights console.

Stage on Cloud Storage

Chat Conversation

  1. Upload the conversation's chat transcript as an object in your Cloud Storage bucket. Make a note of the object path, which is formatted as gs://<bucket>/<object>.

    The chat transcript file must be supplied as a JSON-formatted file that matches the CCAI conversation data format.

Voice Conversation

  1. Upload the conversation's audio and transcript files as objects in your Cloud Storage bucket. Make a note of the two object paths, which are formatted as gs://<bucket>/<object>.

Create a conversation

  1. Navigate to the Insights console.
  2. If prompted, sign in using your Google Account.
  3. Enter your project ID.
  4. Click the Import button at the top left of the conversations list view.
  5. Select either the Voice or Chat tab, depending on the type of conversation you want to create.

Chat conversation

  1. Enter the Cloud Storage bucket path for the transcript file in the Transcript URI field.
  2. Enter the agent ID in the Agent ID field. This is the unique identifier used by Insights for the agent in the conversation.

Voice conversation

  1. Enter the Cloud Storage bucket path for the audio file in the Audio URL field.
  2. Enter the Agent ID in the agent ID field. This is the unique identifier used by Conversational Insights for the agent in the conversation.
  3. Select either 1 or 2 to indicate the audio track the agent is on.
  4. Enter the Cloud Storage bucket path for the transcript file in the Transcript URI field.

Once you have entered the required information, click Import to import the conversation into Conversational Insights. When the conversation is finished being created, you will receive a notification indicating that the conversation has been successfully imported.

Analyze a conversation

Once a Conversation object is created in Insights, it must be analyzed in order to produce useful results. A single Conversation object can be analyzed many times, and each separate analysis creates a new Analysis object. If the languageCode field is not set, Insights will automatically infer it. Refer to the language support documentation for a list of languages supported for analysis.

  1. Click the name of the conversation in the conversation list view table.
  2. Once the conversation details page has loaded, click the button at the top of the page that reads "Start analysis".
  3. The analysis may take some time. You can leave the page and come back later.
  4. Once the analysis has completed, you will see the results on the conversation details page.

View your conversations

You can view your Conversational Insights conversations and analyses in the console. When an operation reports completion, a new table entry for the conversation and analysis will appear. If a conversation has multiple analyses, the console displays the results from the most recent analysis.

To view the conversation cover page:

  1. Navigate to the Conversational Insights console.
  2. If prompted, sign in using your Google Account.
  3. Enter your project ID.

Before you create any conversations, the page is empty. After conversations are created, the results appear on this page.