Skip to content

Commit

Permalink
update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
yan-elena committed May 5, 2024
1 parent 472596c commit 1d1cc75
Showing 1 changed file with 7 additions and 8 deletions.
15 changes: 7 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -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
<img src="https://github.com/yan-elena/agent-explanation/assets/78790594/d77f7f57-79fc-4a60-86f8-1410f2c0e7c7" width=50%>
## 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.
<img src="https://github.com/yan-elena/agent-logging/assets/78790594/054d9927-5c17-4694-9f7f-04e363161e1f" width=50%>

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.

<img src="https://github.com/yan-elena/agent-explanation/assets/78790594/2f3ba3c4-bd31-41ea-bd5f-ff588ee9824f" width=50%>

Expand Down

0 comments on commit 1d1cc75

Please sign in to comment.