Skip to content

Dialogflow Engine

The Dialogflow engine is responsible for understanding user inputs and providing relevant responses based on pre-defined intents and entities. It uses natural language processing (NLP) and machine learning algorithms to identify the user’s intent and extract relevant information from their inputs. It also enables developers to build complex conversational flows, manage context, and integrate with external APIs. To use the Dialogflow engine for Natural Language Understanding, you need to create the agent and train the model on Dialogflow if you don’t have one already. The following sections detail the agent creation and training steps and also explain how to obtain the information needed to configure the Dialogflow ES Adapter. Once all the configurations are done, you can start testing the conversation behavior/flow of the bot using your Dialogflow ES model.

Train the Dialogflow Engine

Dialogflow ES NLU is one of the external NLU adapters. If you want to configure the Dialogflow ES adapter, you need the Project ID and private key obtained from the JSON file in the google cloud console. See Enable the Dialogflow API and Create Service Account Credentials to understand how to obtain the Project ID and the Private Key. These sections explain training and usage of the Dialogflow NLU engine.

Prerequisites: You need to have at least one agent created on the Dialogflow Essentials page, to be able to configure the intent, entity nodes, or FAQs.

To enable intent and entity detection using the Dialogflow engine during a user conversation, you need to create the intents and entities on the Dialogflow Essentials cloud page with the same names used during their creation on Kore.ai XO Platform.

The following steps explain how to create an agent, intent and test the configuration.

  1. Go to Dialogflow Essentials and click Create Agent, if you don’t have any available agent. In this example an agent with the name Test_Dialogflow is created.
    Create an agent

  2. Click Create Intent to create an intent with the same name as in your VA.
    Create an intent with the same name as in your VA

  3. In this example an intent with name Phone Number Verification is created as we have the same user intent in the VA.

  4. Under Action and Parameters, add Action as per the name of the entity. Add the Parameter Name, Entity, Value and the Prompt details.
    Add action, parameter, entity, value, prompt

  5. Under Responses → Default, add the Text Response to be displayed for the user.
    Add text response

  6. Click Save to save the configuration.

  7. Go to Training in the left side menu and enter the intent name at User Says.
    Go go Training and enter Intent name

  8. Enter the intent name same as it is in the VA, in the top most right corner of the page in Try Now, to test the Dialogflow configuration.

  9. The configured text response would be displayed under the Default Response.
    Configured text response displayed under Default Response

    Note

    You can configure any intents, entities or FAQ details which you require to be identified using the Dialogflow ES adapter.

Enable the Dialogflow API

You can activate the Dialogflow API feature for your agent within Dialogflow cloud page. Follow these steps:

  1. Click the Gear icon next to the agent name from the top left of the Dialogflow dashboard.
    Click the Gear icon next to the agent name

  2. The General Settings page is displayed. From there scroll down, to note the project ID value.
    Note the project ID

    Note

    The Project ID will be used to fill the credentials while enabling the Dialogflow adapter on the Kore.AI platform.

  3. Click on the project ID to open google cloud.

  4. You will navigate to the Google Cloud dashboard.
  5. Select APIs & Services → Enabled APIs & Services from the left resources menu.

  6. Click + Enable APIs and Services from the top of the display and find the Dialogflow API option.
    Click Enable APIs and Services

    Find Dialogflow API option

  7. Upon activation of Dialogflow API, select Manage to open the Dialogflow API management dashboard.
    Dialogflow API management dashboard

Create Service Account Credentials

The next step on the Dialogflow API management dashboard is to create a set of credentials to use the API, and to connect to the Dialogflow cloud from the Kore.ai platform.

Service Account Creation

Follow these steps to create service account:

  1. Click the button Create Credentials at the top of the screen.

    Note

    If you already have service accounts with credentials, you can access them from the Credentials option in the left navigation menu.

    Click 'Create Credentials'

  2. In the Create Credentials page, the Dialogflow API is by default selected in the Select an API drop-down.
    Dialogflow API is by default selected in the Select an API drop-down

  3. Select Application Data option for What data will you be accessing? as you are creating a service account. Click Next.
    What data will you be accessing? - Application Data

  4. Select No. I’m not using them and click Next.
    No. I’m not using them

  5. In the Service account details page, provide details for service account name, ID and description as shown below.
    Service account details - account name, ID and description

  6. Click Create and Continue. The service account is created.

  7. Grant access permissions to this service account and also grant users access to this service account if required in the next pages that get displayed.
    Grant permission to Service Account

    Grant permission to User

Private Key Generation

Follow these steps to generate the private key:

  1. Click on the service account created under Service Accounts in the API & Services page as shown below.
    Click on the Service account

  2. The service account details are displayed as shown in the following screenshot. Go to the Keys tab.
    Service account details - Keys tab

  3. Select Create a new key in the Add Key drop-down to generate the private key.
    Create a new private key

  4. In the displayed pop-up, select JSON as the option to generate the private key.
    JSON option to create Private key

    Note

    The JSON option is by default selected.

A file containing the JSON Private Key information for use in the External NLU settings of Kore.ai platform, is downloaded and saved to your computer.

JSON Private Key information - file created and downloaded to computer

The file has the layout as follows:

{
"type": "***",
"project_id": "***",
"private_key_id": "***",
"private_key": "***",
"client_email": "***",
"client_id": "***",
"auth_uri": "***",
"token_uri": "***",
"auth_provider_x509_cert_url": "***",
"client_x509_cert_url": "***"
}

Note

Save this JSON payload securely. You will not be able to access it again. The entire content of this JSON file must be copied into the private key field inside the Kore.AI External NLU adapter settings. See Adapter Configuration to know more.

To understand the testing and debugging of your VA, to validate the working of the DialogFlow NLU, see Test and Debug.