yan-elena / domestic-robot-example

Domestic robot example configured for the multi-level explainability framework

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Domestic robot example

The Domestic robot example is from the Jason book, available at https://github.com/jason-lang/jason/tree/master/examples/domestic-robot . The description is reported as follows:

"A domestic robot has the goal of serving beer to its owner. Its mission is quite simple, it just receives some beer requests from the owner, goes to the fridge, takes out a bottle of beer, and brings it back to the owner. However, the robot should also be concerned with the beer stock (and eventually order more beer using the supermarket’s home delivery service) and some rules hard-wired into the robot by the Department of Health (in this example this rule defines the limit of daily beer consumption)."

In this repository, the example is configured to be used with the logging component for a Multi-level explainability framework for engineering and understanding BDI Agent Systems.

After running the system, the generated log files of the system can be found in the /log folder, and the .json files can be loaded into the explanation web application to explore the generated narrative of the example at different levels of abstraction.

Narrative of the domestic robot example:

Once the supermarket, owner and robot files are uploaded, the user can select the agent with which he wants to view the narration.

Through the web application, it is possible to explore the different levels of explanation of the various agents in the system:

Narrative at Implementation Level

A detailed and technical level that follows Jason's operational semantics and reasoning cycle.

Narrative at Design Level

A higher level that narrates the agent's decisions following its cognitive abstraction according to the Belief-Desire-Intention model.

Explanation of a specific event

Some events are associated with an explanation link to a previous event that caused it.

About

Domestic robot example configured for the multi-level explainability framework


Languages

Language:ASL 82.0%Language:Java 18.0%