Listen and reply — QiChatbot


In this tutorial, we will use the QiChatbot in order to give Pepper the capability to chat around a subject.


Before stepping in this tutorial, you should be familiar with the action notion.

For further details, see: Running Actions on Pepper.

You should also know how to use Android resources.

Let’s start a new project

  • Start a new project, let’s call it QiChatbotPepper.
  • Robotify it and make sure it implements the QiSDK & the Robot Life Cycle.

For further details, see: Creating a robot application.

Creating a topic file

Conversational topics are stored in .top files in the raw resources. A topic file contains rules the robot uses while conversing with a human.

Step Action

Add a new topic to the resources

In Android Studio, choose File > New > Chat topic.

Enter greetings for the File name. Then click on the Create button.

The file is added to your /res/raw/ folder and opens.

In the file, add the following code:

topic: ~greetings()

concept:(hello) [hello hi hey "good morning"]

u:(~hello) ~hello

More details about this QiChat code

The u symbol represents a user rule and it is formatted like this:

u:(human input) robot answer

When the robot hears the input, he says the specified answer.

The concept symbol represents a set of phrases.


To discover how to design much more sophisticated topics, see: QiChat - Syntax.

Your topic file is now ready and we will see how to use it.

Building the topic

Topics are represented by the Topic class. We will use the TopicBuilder class to build one.

Put the following code in the onRobotFocusGained method:

// Create a topic.
Topic topic = TopicBuilder.with(qiContext) // Create the builder using the QiContext.
                          .withResource(R.raw.greetings) // Set the topic resource.
                          .build(); // Build the topic.

Using the topic

We will use the created Topic in a QiChatbot.

Put the following code in the onRobotFocusGained method:

// Create a new QiChatbot.
QiChatbot qiChatbot = QiChatbotBuilder.with(qiContext)

We used the previously created Topic here!

Now, we will use the QiChatbot in a Chat action. Add a Chat field in your MainActivity:

// Store the Chat action.
private Chat chat;

Let’s use the Chat interface; create it in the onRobotFocusGained method:

// Create a new Chat action.
chat = ChatBuilder.with(qiContext)

The Chat interface has a addOnStartedListener method that allows us to be notified when the Chat action starts. We will use it to log to the console:

// Add an on started listener to the Chat action.
chat.addOnStartedListener(() -> Log.i(TAG, "Discussion started."));

Do not forget to remove this listener on Chat in the onRobotFocusLost method:

// Remove on started listeners from the Chat action.
if (chat != null) {

We can now run the Chat in the onRobotFocusGained method:

// Run the Chat action asynchronously.
Future<Void> chatFuture = chat.async().run();

And display a log trace indicating that the Chat finished with error.

// Add a lambda to the action execution.
chatFuture.thenConsume(future -> {
    if (future.hasError()) {
        Log.e(TAG, "Discussion finished with error.", future.getError());

Let’s try it

github_icon The sources for this tutorial are available on GitHub.

  1. Install and run the application.

    For further details, see: Running an application.

  2. Choose “Listen and reply”.

    The log trace “Discussion started.” is displayed in the console.

  3. Say one of the following sentences:




    good morning.

    Pepper responds one of these sentences.
  4. If you say one again, Pepper will change his answer.

You are now able to have a Chat with Pepper!