Versions Compared

Old Version 27

changes.mady.by.user Gardner, I.V. (Bella)

Saved on

compared with

New Version 28

changes.mady.by.user Reimann, M.M. (Merle)

Saved on

Key

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

The Project CA builds upon the material taught in the Multi-Agent Systems course. You will use some additional tools and software to develop your recipe recommendation agent in this project. We will use git, Dialogflow, Prolog and MARBEL, and Bootstrap for visuals. For more on these, see the Project Background Knowledge. To connect these different tools, we will make use of the Social Interaction Cloud (SIC) which runs in a Docker container. The agent will connect with this infrastructure to be able to interface with a browser for displaying a webpage for visual support and Dialogflow for voice-based user interaction. For programming, the browser, Bootstrap, a front-end open-source toolkit for building websites will be used. Below you’ll find the instructions for setting up everything on your computer.

Set Up

1: Join Discord and GitHub Classroom and Clone the Student Project

Info

Hot Tip: GitHub has a great education package if you sign up with your student email https://education.github.com/pack#offers

  • Join the GitHub classroom via this link: https://classroom.github.com/a/HP8FeZ1C. Only one member of your team (the first to join) needs to make a team in the classroom. Please use the following naming convention: group-n, where n is your group numer.

  • Clone the project repository on your local device: copy the HTTPS link from the GitHub Classroom and execute git clone <COPY PASTE HTTPS LINK HERE> inside a terminal in a folder in your user directory.

2: Install MARBEL

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

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

  • Go to Window → Preferences (or on Mac: Eclipse → Settings) → 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) and is needed to collect the required conversation data.

  • 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! If you import the project into Eclipse, you should be able to see on what branch you are working in your git repository and be able to make use of git functionality available in Eclipse.

3: Install SIC

Please follow the instructions on the SIC Installation page.

Note

Make sure to install SIC in a different folder than your Eclipse workspace.

Note

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

4: Run it!

Check out this page on how to run your agent Run your Conversational Agent

Info

All done? Proceed back to https://socialrobotics.atlassian.net/wiki/spaces/PM2.