Versions Compared

Old Version 13

changes.mady.by.user Koen Hindriks

Saved on

compared with

New Version 14

changes.mady.by.user Koen Hindriks

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

To get started with this project, you (and your group members) need to set up the software tools needed.

1: Create and Prepare Your Dialogflow Agent (One Per Team)

Note

Only one team member needs to do this.

You need a Google account for this.

You do not need to change any settings (you will use the default English language).

2: Join GitHub Classroom and Clone the Student Project

XXX

  • Git clone the project. ADD INSTRUCTIONS.

  • Add JSON key file of your Dialogflow agent that you downloaded and saved above to the agent folder in the folder where you cloned the project.

3: Install MARBEL

  • We assume that you have already installed Eclipse and the MARBEL plug-in. If not, pleasehttps://goalapl.atlassian.net/wiki/spaces/GOAL/pages/2143977473/Download+and+Install+the+MARBEL+Plugin. Please check whether you are using the latest version of the plug-in by using the Eclipse menu (Help → Check for Updates).

  • Launch Eclipse (You can choose to create a new workspace if you like).

  • Go to Window → Preferences → MARBEL → Logging and check the box for the ‘Write logs to files’ option; then go to MARBEL → Runtime and uncheck the box for ‘Include initial KR updates’.

Note

Make sure to set the preferences. Without unchecking the runtime option, it will be hard if not impossible to run your agent in Debug Mode. Checking the logging option will enable saving log files to a folder automatically, which will be useful for analyzing your agent’s behavior (conversations).

  • Import the MARBEL dialog manager project in Eclipse by selecting File → Import → MARBEL Agent Programming → Existing MARBEL Project, clicking Next, browsing to the agent folder in which you cloned the project, selecting the dialogmngr.mas2g file, clicking Open, and finally, clicking Finish.

Note

Do not check the option Copy into workspace!

  • Open the .mas2g file, specify as flowkey the name of the JSON key file, and as flow agent the Project ID (you can find this by checking the settings of your Dialogflow agent https://dialogflow.cloud.google.com/).

4: Install SIC

Please follow the instructions https://socialrobotics.atlassian.net/wiki/spaces/CBSR/pages/260276225/Local+Installation#Installation https://socialrobotics.atlassian.net/wiki/spaces/CBSR/pages/260276225/The+Social+Interaction+Cloud+Manual#Using-Dialogflow%7D%7Bthis.

Note

Only works with Google Chrome which you therefore also need and can download here:https://www.google.com/chrome/.

5: Launch the conversational agent system

  • Open a command terminal and navigate to the folder (called docker by default) where you cloned the SICproject.

  • Enter docker-compose up dialogflow webserver and hit enter.

  • Open a second terminal and navigate to the subfolder sic-local in the docker folder.

  • Enter java -jar computer-browser.jar and hit enter. This will lead to a new browser window. Press ‘Ok’ without filling in a password.

  • Run the .mas2g file.

  • Check the boxes ending with ‘browser' in the subsequently appearing window, and press 'Ok'.

After running java -jar computer-browser.jar a pop-up should appear like the one in the left-hand corner of the picture below. Click okay without filling in a username and password.

Then a google chrome window should open. It should say it is being controlled by automated test software and display long string of random characters. In your terminal it should say ‘ChromeDriver was started successfully’ in one of the lines.

When you run the .mas2g file in your agent, another popup should appear like the one in the left-hand corner of the picture below. The empty box should be ticked next to the browser code that matches your google chrome window code, and then you hit OK

You should now see a window rendering the browser plug-in and hear the agent start talking. The rest now is up to you!