Project Installation

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

https://discord.gg/WqcvB8cDfm Make sure you use your own name (and not a nickname) in Discord.
If you do not have one, Create a GitHub Account: https://docs.github.com/en/get-started/onboarding/getting-started-with-your-github-account

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’.

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.

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.

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