# Using other NLP engines
The eva NLP (NTT DATA proprietary Natural Language Processing engine) comes integrated as default.
In this chapter, you'll learn how to connect the virtual agent to an external NLP engine (natural language processing).
eva allows you to use different cognitive engines:
1. IBM Watson Assistant.
2. Google Dialogflow Essentials.
3. Microsoft Luis.
To use any of these, just follow the step by step below.
In case you are using any of the externals NLP and want to move your virtual agent to the eva NLP, just select it on the NLP menu.
### IBM Watson Assistant
Watson is a service package offered by IMB. Among them, there is a question-answering software that applies natural language processing, information retrieval, knowledge representation, automated reasoning and machine learning technologies to answer questions posed in natural language.
1\) Go to
2\) Log in with your IBMid
3\) Click on "skills" in the upper left corner
4\) Then click “create skill” to create a virtual agent on Watson
5\) If you have existing skills, select one, then click on the menu in the upper right corner of the selected skill card.
6\) Click on “view API details”
7\) If you are using a newer account, copy the links and codes after Assistant URL and Api Key insert them on eva. Remember to switch to the newer version in eva.
8\) If you are using an older account, copy the links and codes after v1 Workspace URL, Username and Password and insert them on eva. Remember to switch to the older version in eva.
### Google Dialogflow Essentials
Dialogflow is a human-computer interaction framework that works on natural language.
1\) Go to
2\) Then click on “go to console”.
3\) Click on settings on the upper left corner (the cogwheel icon - see image).
4\) Click the link right after “Project ID”.
5\) You will be taken to a page in the Google Cloud Platform.
6\) Once in the Google Cloud Platform, click on the link below “e-mail”.
{% hint style="warning" %}
**Important:** Remember to charge your agent permission or else your intents won’t work
{% endhint %}
7\) Go to IAM on the upper left corner of the menu (as shown in the image below).
8\) Once there, click on the edit icon (pencil) on the right of the agent named as Dialogflow Integrations (see image below).
9\) Now, select “Dialogflow” and then “Dialogflow API Admin” (as shown in the image below).
10\) Once you changed your agent permission, go to “service accounts” and then click on the menu on the right of the agent you want to use.
{% hint style="warning" %}
**Important:** If you don’t have a Service Account, click on “Create Service Account” and create one
{% endhint %}
11\) Click on “create key” and select JSON.
12\) Save the JSON file on your computer.
{% hint style="info" %}
New option to configure Dialogflow multi region.
{% endhint %}
13\) (Optional) If you want to use a Dialogflow agent from a specific region, you need to modify the JSON file with a new parameter called Dialogflow\.region. This parameter must contain the official region identifier described in this table:
| Country grouping | Geographic location | Region ID |
| ---------------- | ------------------------------------------------------------ | -------------------- |
| Europe | Belgium | europe-west1 |
| Europe | London | europe-west2 |
| Asia-Pacific | Sydney | australia-southeast1 |
| Asia-Pacific | Tokyo | asia-northeast1 |
| Global | Dialogflow delivery is global, data at rest is within the US | global |
If this parameter does not exist when creating the bot in eva, the global region will continue to be used by default as it has been to date.
Example Dialogflow metadata JSON with “region” parameter:
```
{
"type": "service_account",
"project_id": "projectId",
"private_key_id": "d8313783b67e14489ef0ea8b2fafd2b23c62c507",
"private_key": "-----BEGIN PRIVATE KEY-----CRIPTED_KEY-----END PRIVATE KEY-----\n",
"client_email": "email@ email.iam.gserviceaccount.com",
"client_id": "1234",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://oauth2.googleapis.com/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/...",
# NEW PARAMETER --------------------------------
"region": "australia-southeast1"
# NEW PARAMETER --------------------------------
}
```
14\. Upload this file when creating a Dialogflow virtual agent in eva to complete the integration.
### Microsoft Luis
Language Understanding (LUIS) is a cloud-based API service that applies custom machine-learning intelligence to a user's conversational, natural language text to predict overall meaning, and pull out relevant, detailed information.
To integrate LUIS to eva, you have to have an active Azure account with created resources.
1\) Go to luis.ai
2\) Login with your Microsoft account.
3\) Create an app or click on an existing one.
4\) Click on “manage”.
5\) Then click on “Azure Resources” at the left.
6\) Copy the example query, located on the bottom of the screen.
7\) Then, click on authoring resource and copy the primary key.
8\) Paste the Example Query on the URL prediction field and the primary key on the authoring key field.
#### Using system entities in Luis
eva supports Luis version 2. When using the datetimeV2 system entity in Luis, you can use subcategories, such:
date
time
datetime
daterange
timerange
datetimerange
Those subcategories should be added after a dot (.).
So, if you are using the date subcategory, the entity name should be builtin.datetimeV2.date
Where builtin.datetimeV2 is the system entity name and date is the subcategory.
For further information, check
### Microsoft QnA Maker
QnA Maker is a cloud-based Natural Language Processing (NLP) service that creates a conversational layer over data. It can be used to find the most appropriate answer for any given natural language input.
1\) Go to
2\) Login.
3\) Click on "My Knowledge Bases".
4\) \*If you already have knowledge bases, skip to the next page.
5\) Click “create a knowledge base”.
6\) You must have an active Azure account.
7\) Fill the required fields and click “create”.
8\) Select a knowledge base.
9\) Click on “settings”.
10\) Then go to “postman”, on the bottom of the page, and copy the code.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.conversational-ai.syntphony.com/user-guide/_eva-3.4.1_1/using-eva/natural-language/using-other-nlp-engines.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.