Jadex User Guide

Release 0.941

24. May 2006
http://vsis-www.informatik.uni-hamburg.de/projects/jadex/

Alexander Pokahr

Lars Braubach

Andrzej Walczak

Distributed Systems Group
University of Hamburg, Germany
http://vsis-www.informatik.uni-hamburg.de

If you have support questions about Jadex please use the sourceforge help forum and mailing list for that purpose (available at http://sourceforge.net/projects/jadex/).


Table of Contents

1. Introduction
1.1. Requirements and Installation
1.2. Getting Started
1.2.1. Compile an Example
1.2.2. Start an Example Agent
2. Platform Adapters
2.1. The Jadex Standalone Adapter
2.1.1. Starting the Jadex Standalone Adapter
2.2. The JADE Adapter
2.2.1. Starting the JADE Adapter
2.2.2. Agent Migration and Persistence
2.2.3. Using JADE Behaviours
3. Concepts of the Jadex BDI Reasoning Engine
3.1. The BDI Model of Jadex
3.1.1. The Beliefbase
3.1.2. The Goal Structure
3.1.3. Plan Specification
3.2. Agent Definition
3.3. Execution Model of a Jadex Agent
4. Agent Specification
4.1. Overview
4.2. Structure of Agent Definition Files (ADFs)
5. Imports
5.1. Import Examples
6. Capabilities
6.1. Capability Definition
6.2. Using Capabilities
6.3. Elements of a Capability
6.3.1. Making an Element Accessible for the Outer Capability
6.3.2. Defining an Abstract Element
6.4. Predefined Capabilities
7. Beliefs
7.1. Defining Beliefs in the ADF
7.2. Accessing Beliefs from within Plans
7.3. Dynamically Evaluated Beliefs
7.4. Propagation of Belief Changes
8. Goals
8.1. Common Goal Features
8.1.1. Example Goal
8.1.2. BDI Flags
8.2. Perform Goal
8.3. Achieve Goal
8.4. Query Goal
8.5. Maintain Goal
8.6. Creating and Dispatching New Goals
8.7. Goal Deliberation with "Easy Deliberation"
8.8. Meta Goal
9. Plans
9.1. Defining Plan Heads in the ADF
9.1.1. Plan Triggers
9.1.2. Defining Plan Applicability with Pre- and Context Conditions
9.1.3. Waitqueue
9.1.4. Parameters, Binding, and Parameter Mapping
9.2. Implementing a Plan Body in Java
9.2.1. Plan Success or Failure and BDI Exceptions
9.2.2. Atomic Blocks
10. Events
10.1. Goal Events
10.2. Internal Events
10.3. Message Events
10.3.1. Receiving Messages
10.3.2. Sending Messages
11. Expressions
11.1. Expression Syntax
11.2. Expression Properties
11.3. Reserved Variables
11.4. Expressions Examples
11.5. ADF Expressions
11.6. OQL-like Select Statements
12. Conditions
12.1. ADF Conditions
13. Properties
14. Initial States
14.1. Capabilities
14.2. Beliefs
14.3. Goals
14.4. Plans
14.5. Events
15. Dynamic Models
15.1. Adding/Removing Capabilities at Runtime
15.2. Creating/Deleting Beliefs at Runtime
15.3. Creating/Deleting Goal Types at Runtime
15.4. Creating/Deleting Plan Types at Runtime
15.5. Creating/Deleting Event Types at Runtime
16. External Processes
A. Changes and Compatibility Issues
A.1. New Features in 0.94
A.2. Incompatibilities to Release 0.932
A.2.1. Changes in the ADF Definition
A.2.2. API Changes
B. FAQ+HOWTO
C. Legal Notice
C.1. Third-Party Software
Bibliography