diff --git a/README.md b/README.md index 074e624..6fdcd02 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,20 @@ -# A Multi-Level Explainability Framework for BDI Multi Agent Systems - Narrative Generator Component +# Narrative Generator Component This repository contains a prototype implementation of the **Narrative Generator** for our research project _A Multi-Level Explainability Framework for BDI Multi Agent Systems_. You access directly the deployed web application **[here](https://yan-elena.github.io/agent-explanation/)** without installing anything. -## The Multi-Level Explainability Framework - +## A Multi-Level Explainability Framework for Engineering and Understanding BDI Agent Systems -This framework aims to address the problem of AI-systems explainability at multiple levels: implementation, design, and domain levels. In particular, the idea is to use the logs of the JaCaMo BDI Multi-Agent System produced by the **[Logger Component](https://github.com/yan-elena/agent-logging)** and automatically extract narratives at multiple levels. + The primary levels of abstraction identified in this study are as follows: -- The **Implementation Level**: a detailed narrative closely related to the Agent and Multi-Agent Systems useful for debugging and testing. -- The **Design Level**: a level that describes the agent behavior regardless of its implementation useful for analysis and verification. -- The **Domain Level**: a high-level narrative that explains the behavior with reference to the domain and requirements of the system. (work in progress) +- The **Implementation Level**: a detailed narrative closely related to the Agent and Multi-Agent Systems for debugging and testing. +- The **Design Level**: a level that describes the agent behaviour regardless of its implementation for analysis and verification. +- The **Domain Level**: a high-level narrative that explains the behaviour with reference to the domain and requirements of the system - *(work in progress)*. ## Usage Following the instructions presented in the **[Logger Component](https://github.com/yan-elena/agent-logging)** to generate the `log files` of your JaCaMo project. -Once the log files have been obtained, they can be loaded in the Home Page: +Once you have the log files, you can upload them to the Home Page.