Skip to content

UsingFIPAACL

Jump to bottom
benoitgaudou edited this page Aug 25, 2018 · 13 revisions

Using FIPA ACL

The communicating skill offers some actions and built-in variables which enable agents to communicate with each other using the FIPA interaction protocol. This document describes the built-in variables and actions of this skill. Examples are found in the models library bundled with GAMA.

Variables

  • accept_proposals (list): A list of 'accept_proposal' performative messages of the agent's mailbox having .
  • agrees (list): A list of 'accept_proposal' performative messages.
  • cancels (list): A list of 'cancel' performative messages.
  • cfps (list): A list of 'cfp' (call for proposal) performative messages.
  • conversations (list): A list containing the current conversations of agent. Ended conversations are automatically removed from this list.
  • failures (list): A list of 'failure' performative messages.
  • informs (list): A list of 'inform' performative messages.
  • messages (list): The mailbox of the agent, a list of messages of all types of performatives.
  • proposes (list): A list of 'propose' performative messages .
  • queries (list): A list of 'query' performative messages.
  • refuses (list): A list of 'propose' performative messages.
  • reject_proposals (list): A list of 'reject_proposals' performative messages.
  • requests (list): A list of 'request' performative messages.
  • requestWhens (list): A list of 'request-when' performative messages.
  • subscribes (list): A list of 'subscribe' performative messages.

Actions

accept_proposal

Replies a message with an 'accept_proposal' performative message

  • returns: unknown
  • message (message): The message to be replied
  • content (list): The content of the replying message

agree

Replies a message with an 'agree' performative message.

  • returns: unknown
  • message (message): The message to be replied
  • content (list): The content of the replying message

cancel

Replies a message with a 'cancel' peformative message.

  • returns: unknown
  • message (message): The message to be replied
  • content (list): The content of the replying message

cfp

Replies a message with a 'cfp' performative message.

  • returns: unknown
  • message (message): The message to be replied
  • content (list): The content of the replying message

end_conversation

Replies a message with an 'end_conversation' peprformative message. This message marks the end of a conversation. In a 'no-protocol' conversation, it is the responsible of the modeler to explicitly send this message to mark the end of a conversation/interaction protocol.

  • returns: unknown
  • message (message): The message to be replied
  • content (list): The content of the replying message

failure

Replies a message with a 'failure' performative message.

  • returns: unknown
  • message (message): The message to be replied
  • content (list): The content of the replying message

inform

Replies a message with an 'inform' performative message.

  • returns: unknown
  • message (message): The message to be replied
  • content (list): The content of the replying message

propose

Replies a message with a 'propose' performative message.

  • returns: unknown
  • message (message): The message to be replied
  • content (list): The content of the replying message

query

Replies a message with a 'query' performative message.

  • returns: unknown
  • message (message): The message to be replied
  • content (list): The content of the replying message

refuse

Replies a message with a 'refuse' performative message.

  • returns: unknown
  • message (message): The message to be replied
  • content (list): The content of the replying message

reject_proposal

Replies a message with a 'reject_proposal' performative message.

  • returns: unknown
  • message (message): The message to be replied
  • content (list): The content of the replying message

reply

Replies a message. This action should be only used to reply a message in a 'no-protocol' conversation and with a 'user defined performative'. For performatives supported by GAMA (i.e., standard FIPA performatives), please use the 'action' with the same name of 'performative'. For example, to reply a message with a 'request' performative message, the modeller should use the 'request' action.

  • returns: unknown
  • message (message): The message to be replied
  • performative (string): The performative of the replying message
  • content (list): The content of the replying message

request

Replies a message with a 'request' performative message.

  • returns: unknown
  • message (message): The message to be replied
  • content (list): The content of the replying message

send

Starts a conversation/interaction protocol.

  • returns: msi.gaml.extensions.fipa.Message
  • receivers (list): A list of receiver agents
  • content (list): The content of the message. A list of any GAML type
  • performative (string): A string, representing the message performative
  • protocol (string): A string representing the name of interaction protocol

start_conversation

Starts a conversation/interaction protocol.

  • returns: msi.gaml.extensions.fipa.Message
  • receivers (list): A list of receiver agents
  • content (list): The content of the message. A list of any GAML type
  • performative (string): A string, representing the message performative
  • protocol (string): A string representing the name of interaction protocol

subscribe

Replies a message with a 'subscribe' performative message.

  • returns: unknown
  • message (message): The message to be replied
  • content (list): The content of the replying message

Home

  1. What's new (Changelog)

Platform

  1. Installation and Launching
    1. Installation
    2. Launching GAMA
    3. Updating GAMA
    4. Installing Plugins
  2. Workspace, Projects and Models
    1. Navigating in the Workspace
    2. Changing Workspace
    3. Importing Models
  3. Editing Models
    1. GAML Editor (Generalities)
    2. GAML Editor Tools
    3. Validation of Models
  4. Running Experiments
    1. Launching Experiments
    2. Experiments User interface
    3. Controls of experiments
    4. Parameters view
    5. Inspectors and monitors
    6. Displays
    7. Batch Specific UI
    8. Errors View
  5. Running Headless
    1. Headless Batch
    2. Headless Server
    3. Headless Legacy
  6. Preferences
  7. Troubleshooting

Learn GAML step by step

  1. Introduction
    1. Start with GAML
    2. Organization of a Model
    3. Basic programming concepts in GAML
  2. Manipulate basic Species
  3. Global Species
    1. Regular Species
    2. Defining Actions and Behaviors
    3. Interaction between Agents
    4. Attaching Skills
    5. Inheritance
  4. Defining Advanced Species
    1. Grid Species
    2. Graph Species
    3. Mirror Species
    4. Multi-Level Architecture
  5. Defining GUI Experiment
    1. Defining Parameters
    2. Defining Displays Generalities
    3. Defining 3D Displays
    4. Defining Charts
    5. Defining Monitors and Inspectors
    6. Defining Export files
    7. Defining User Interaction
  6. Exploring Models
    1. Run Several Simulations
    2. Batch Experiments
    3. Exploration Methods
  7. Optimizing Model Section
    1. Runtime Concepts
    2. Optimizing Models
  8. Multi-Paradigm Modeling
    1. Control Architecture
    2. Defining Differential Equations

Recipes

  1. Manipulate OSM Data
  2. Diffusion
  3. Using Database
  4. Using FIPA ACL
  5. Using BDI with BEN
  6. Using Driving Skill
  7. Manipulate dates
  8. Manipulate lights
  9. Using comodel
  10. Save and restore Simulations
  11. Using network
  12. Headless mode
  13. Using Headless
  14. Writing Unit Tests
  15. Ensure model's reproducibility
  16. Going further with extensions
    1. Calling R
    2. Using Graphical Editor
    3. Using Git from GAMA

GAML References

  1. Built-in Species
  2. Built-in Skills
  3. Built-in Architecture
  4. Statements
  5. Data Type
  6. File Type
  7. Expressions
    1. Literals
    2. Units and Constants
    3. Pseudo Variables
    4. Variables And Attributes
    5. Operators [A-A]
    6. Operators [B-C]
    7. Operators [D-H]
    8. Operators [I-M]
    9. Operators [N-R]
    10. Operators [S-Z]
  8. Exhaustive list of GAMA Keywords

Developing GAMA

  1. Installing the GIT version
  2. Developing Extensions
    1. Developing Plugins
    2. Developing Skills
    3. Developing Statements
    4. Developing Operators
    5. Developing Types
    6. Developing Species
    7. Developing Control Architectures
    8. Index of annotations
  3. Introduction to GAMA Java API
    1. Architecture of GAMA
    2. IScope
  4. Using GAMA flags
  5. Creating a release of GAMA
  6. Documentation generation

Tutorials

  1. Predator Prey
  2. Road Traffic
  3. 3D Tutorial
  4. Incremental Model
  5. Luneray's flu
  6. BDI Agents

Community

  1. Team
  2. Projects using GAMA
  3. Scientific References
  4. Training Sessions

Versions of GAMA

Resources

  1. Videos
  2. Conferences
  3. Code Examples
  4. Pedagogical materials
Clone this wiki locally