Dialog topic

What is a Dialog topic

Creating a Dialog topic is an easy way to provide your robot with conversational skills.

A Dialog topic is a multilingual set of QiChat scripts , including:

  • a DLG file, representing the Dialog topic and registering the supported languages, and
  • one to n TOP file(s), each one containing the QiChat script of language supported by the Dialog topic .
  • You can only create topic for languages amongs your current application’s supported languages set.

Launching a Dialog topic

  • By default, a Dialog topic can be launched, via a Dialog box , in any Behavior included in the same Project .
  • If declared in the project’s Manifest as a Collaborative Dialog , the Dialog topic is also launched at robot start up, enriching its global dialog skills.

Creating a Dialog topic

To create a Dialog topic :

Step Action

Choose File > Add new content > Dialog topic... .

https://developers.softbankrobotics.com/sites/default/files/repository/51_html_nao/_images/add_dialog_topic_en.png

Note: you can also click the create_import_btn Add content button in the Project files panel , and choose Create dialog topic .

Type a file Name .

Warning

  • You won’t be able to change it later, so choose it well.
  • Use only alphanumeric characters: no space, no special characters.
Choose the languages supported by your Dialog topic .
Choose if this Dialog topic should appear or not in the Manifest of your application as collaborative dialog .

Click the OK button.

Your Dialog topic is created.

All related files are created in a folder named as the topic name, located at the project root.

https://developers.softbankrobotics.com/sites/default/files/repository/51_html_nao/_images/dialog_topic_created.png

Editing a Dialog topic

To add or remove supported languages for the Dialog topic :

  • In the Project content panel, double click the .DLG file.

Note

Like dialog topic creation, you can only add or remove languages that are part of your application’s supported languages.

https://developers.softbankrobotics.com/sites/default/files/repository/51_html_nao/_images/dialog_editor.png

To edit the Qichat script in a given language:

  • In the Project content panel, double click the corresponding .TOP file.

    https://developers.softbankrobotics.com/sites/default/files/repository/51_html_nao/_images/dialog_script_editor.png

To go further, see the tutorial: Creating Dialog boxes .

Importing a Dialog topic in another Project

To reuse a Dialog topic created in another Project :

Step Action
Choose File > Import content > Folder and select the folder containing the Dialog topic to import.