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.
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:
A detailed and technical level that follows Jason's operational semantics and reasoning cycle.
A higher level that narrates the agent's decisions following its cognitive abstraction according to the Belief-Desire-Intention model.
Some events are associated with an explanation of a previous event that caused it.