Skip to content

BuiltInFIPA

Jump to bottom
Arthur edited this page Jul 22, 2026 · 1 revision

FIPA Skill

Extension: gama.extension.fipa

The FIPA skill offers primitives and built-in variables which enable agents to communicate with each other using the FIPA (Foundation of Intelligent Physical Agents) interaction protocol.

To use this skill, declare it in the species definition:

species my_species skills: [fipa] {
    ...
}

Variables

Variable Type Description
conversations list A list containing the current conversations of the agent (ended conversations are automatically removed)
accept_proposals list<modelable> List of 'accept_proposal' performative messages in the agent's mailbox
agrees list<modelable> List of 'agree' performative messages
cancels list<modelable> List of 'cancel' performative messages
cfps list<modelable> List of 'cfp' (call for proposal) performative messages
failures list<modelable> List of 'failure' performative messages
informs list<modelable> List of 'inform' performative messages
proposes list<modelable> List of 'propose' performative messages
queries list<modelable> List of 'query' performative messages
refuses list<modelable> List of 'refuse' performative messages
reject_proposals list<modelable> List of 'reject_proposal' performative messages
requests list<modelable> List of 'request' performative messages
requestWhens list<modelable> List of 'request-when' performative messages
subscribes list<modelable> List of 'subscribe' performative messages

Actions

cfp — Call for Proposal

Send a call for proposal to a list of agents.

Facet Type Description
to list<modelable> A list of receiver agents
content list<any> The content of the message (required, no facet name)
protocol string A string representing the name of the interaction protocol (default: "no_protocol")

request — Request

Send a request to another agent.

Facet Type Description
to list<modelable> A list of receiver agents
content list<any> The content of the message (required, no facet name)
protocol string A string representing the name of the interaction protocol (default: "no_protocol")

request_when — Request-When

Send a request-when to another agent.

Facet Type Description
to list<modelable> A list of receiver agents
content list<any> The content of the message (required, no facet name)
protocol string A string representing the name of the interaction protocol (default: "no_protocol")

subscribe — Subscribe

Subscribe to receive messages of a given type.

Facet Type Description
to list<modelable> A list of receiver agents
content list<any> The content of the message (required, no facet name)
protocol string A string representing the name of the interaction protocol (default: "no_protocol")

inform — Inform

Inform another agent about something.

Facet Type Description
to list<modelable> A list of receiver agents
content list<any> The content of the message (required, no facet name)
protocol string A string representing the name of the interaction protocol (default: "no_protocol")

query — Query

Query another agent for information.

Facet Type Description
to list<modelable> A list of receiver agents
content list<any> The content of the message (required, no facet name)
protocol string A string representing the name of the interaction protocol (default: "no_protocol")

reply — Reply

Reply to a message. This action should only be 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 as the performative. For example, to reply with a 'request' performative, use request.

Facet Type Description
message modelable The message to be replied (required, no facet name)
performative string The performative of the replying message (required, no facet name)
content list<any> The content of the replying message (optional)

start_conversation — Start Conversation

Starts a conversation/interaction protocol.

Facet Type Description
to list<modelable> A list of receiver agents
content list<any> The content of the message (required, no facet name)
performative string A string representing the message performative
protocol string A string representing the name of the interaction protocol

end_conversation — End Conversation

Ends an existing conversation.

Facet Type Description
conversation_id string The ID of the conversation to end (required, no facet name)

Deprecated Actions

Deprecated Replacement
send Use start_conversation instead

See Also

Home

  1. What's new (Changelog)
  2. Migration Guide (2025-06 → 2026-06)

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. Getting Started
    2. Headless Legacy
    3. Headless Batch
  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. Classes and Objects
    1. Class Definition and Instantiation
    2. Attributes and Actions
    3. Inheritance
    4. Virtual Classes
    5. Advanced Features
  7. Exploring Models
    1. Run Several Simulations
    2. Batch Experiments
    3. Exploration Methods
  8. Optimizing Models
    1. Runtime Concepts
    2. Analyzing code performance
    3. Optimizing Models
  9. Multi-Paradigm Modeling
    1. Control Architecture
    2. Defining Differential Equations

Recipes

  1. Manipulate OSM Data
  2. Cleaning OSM Data
  3. Diffusion
  4. Using Database
  5. Using Dataframes
  6. Using FIPA ACL
  7. Using BDI with BEN
  8. Using Driving Skill
  9. Manipulate dates
  10. Manipulate lights
  11. Using comodel
  12. Save and restore Simulations
  13. Using network
  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. Stats Extension
  8. Sound Extension
  9. BDI Extension
  10. FIPA Skill
  11. Expressions
    1. Literals
    2. Units and Constants
    3. Pseudo Variables
    4. Variables And Attributes
    5. Operators (Definition)
    6. Operators [A-A]
    7. Operators [B-C]
    8. Operators [D-H]
    9. Operators [I-M]
    10. Operators [N-R]
    11. Operators [S-Z]
  12. Exhaustive list of GAMA Keywords

Developing GAMA

  1. Installing the development version
    1. Install GAMA source code with Eclipse plugin
  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. Incremental Model
  4. Luneray's flu
  5. BDI Agents
  6. Forager RL
  7. SIR Analysis
  8. 3D Model

Community

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

Versions of GAMA

Resources

  1. Videos
  2. Conferences
  3. Pedagogical materials

Clone this wiki locally