Agent Debugger

To support debugging of the agent behaviour, a debugging tool can be found here.

This includes a jasonDebugging folder that contains the following files:

• DebugEnvironment.java
• debugging.mas2j
• various .asl files that contain behaviours written in AgnetSpeak
• testPercepts.txt

A file called tests.log is generated by the debugger.

To run the debugger, it is recommended that the Jason plugin be used to open the debugging.mas2j file. The plugin is available for both JEdit (included with Jason) or Eclipse.

The debugging.mas2j file contains information for the Jason plugin that identifies the environment to use as well as which agent behaviour files to use. In this case, the DebugEnvironment.java should be specified. This environment program parses the testPercepts.txt file (which can be manually written but can also be generated by the savi simulation). This file contains perceptions that are passed to the agent at each reasoning cycle.

When running the debugger using the Jason plugin, it is particularly valuable to use the Jason Mind Inspector. This allows the user to examine the agent state at each reasoning cycle and is very useful for debugging.