An IA Domain usually serves a unique area of user interest, for example "Travel" or "Billing Support". You can add multiple Domains in your Account.
Once the IA Domain is added to your account, you can view and synchronize its settings and components (i.e., Intents and Entities) with the NLP engine using the Admin Console. However, actual IA Domain component maintenance is performed directly in the Dialogflow NLP engine.
Note: The Intelligent Assistant must be enabled for your account in order to work with an IA Domain. For details, click here.
Adding an IA Domain
You add an IA Domain after its Agent has been configured (usually by the Account Admin) on the DialogFlow NLP engine for your account.
Note: When working on a Multi Environment platform, you need to duplicate the DialogFlow Agent for each Environment you will use. In Interact, select the desired Environment (e.g., Test) and add an IA Domain to that Environment using the unique Developer Access Token from your duplicate Agent.
- From the Admin Console Intelligent Assistant menu, select Domains. The Account Domains page will be displayed.
- Click Add New Domain. The IA Domain settings will be displayed:
- Enter a unique name for the IA Domain in the Domain Name field. In most cases, you'll want a Domain Name to be identical to the name of its associated Agent in the Dialogflow NLP engine. However, it does not need not match the Agent name.
The name can contain: A-Z, a-z, 0-9, and _ (underscore) characters.
- In the Domain Language field, select the language that has been assigned to the corresponding Agent on the Dialogflow NLP engine.
Each IA Domain can have exactly one associated language. To add another language for a selected IA Domain, you need to create and assign a different Agent on the Dialogflow NLP engine.
- In the Developer Token field, enter the Developer Access Token that was provided by Dialogflow for the Agent that will be associated with this IA Domain. (You can copy and paste this randomly-generated string directly from the Dialogflow Agent settings page.)
- When you are finished adding values, click Save in the lower right corner of the panel. You can exit the operation at anytime without saving the new Domain by clicking Cancel.
- Before you can start using this IA Domain, you must synchronize the Domain data in Interact with its corresponding data in the NLP engine by clicking on Sync, as described in the next section.
Syncing an IA Domain
All IA Domain data is maintained and managed in the Dialogflow NLP engine at all times. To ensure that the Domain data is completely matched and up-to-date with its associated Dialogflow data, manual synchronization is needed.
Note: In order to synchronize an IA Domain, its associated Agent first must be assigned a Webhook via the Fulfillment panel in DialogFlow.
A sync is required when a new IA Domain is created. Syncs are also performed manually in order to integrate any changes you make to the NLP engine data. To perform a sync:
- Select the IA Domain that you want to synchronize.
- Click the Sync button:
The IA Domain will be synchronized with its corresponding Agent in the Dialogflow NLP engine.
A spinner is displayed while the sync operation is being performed. The length of time it takes to complete the sync depends on the number of components as well as the amount of data maintained by the corresponding Agent.
- When the sync is finished, a completion popup is displayed with details on which IA Domain components have been affected and how they were changed, as shown below:
When a sync operation is only partially successful, the message will display which IA Domain components failed to synchronize and also provide some details on the reason(s) for the failure, as in the example below:
Note: The sync operation always analyzes and synchronizes data for all Intents and Entities of the IA Domain, no matter where you have clicked the sync button.
- After a sync is performed successfully, the Last sync time field is updated to reflect the precise time and date of the sync.
Deleting an IA Domain
When you delete an IA Domain, you are not deleting its corresponding Agent or any data that is maintained in the Dialogflow NLP engine.
Note: In order to also delete Custom Type or Enum variables which are associated with an IA Domain, you need to remove all references to these variables from Interact elements before deleting the Domain.
You can delete an IA Domain at any time using the Delete button:
- Select and display the IA Domain that you want to delete.
- Click Delete .
A warning message will be displayed.
- Click Delete Domain. The selected IA Domain will be deleted and a completion message will be displayed.