-
Notifications
You must be signed in to change notification settings - Fork 0
Interface Guide
The interface is divided into three main areas:
- Sidebar — on the left, used to navigate between pages
- Timeline — at the top of every page, used to navigate through the simulation history
- Content area — the main area, displays the currently selected page
The first page you see when the GUI opens. It shows a dashboard with the total count of agents, messages, intentions, and environments in the system. Below the dashboard, you can find the Intentions Report — a chronological log of all intentions that occurred during the simulation, showing which agent triggered it, the triggering event, and the intention details. The report is paginated for readability.
This is a good page to keep open while the simulation is still running, as the counters update in real time.
Displays all agents in the system as a grid of cards. Each card shows the agent's name, current cycle, number of beliefs and goals, and the current action being executed. You can use the search bar to filter agents by name.
Clicking View Details opens the Agent Detail Window, which has three tabs:
Overview Shows the agent's current state at the selected point in time: running intentions, current beliefs, and goals.
Agent's Mind Shows the full history of beliefs, goals, and intentions that changed during execution. Useful for understanding how an agent's reasoning evolved over time.
Environment and Channels Lists the environments and channels the agent is connected to, along with the current percepts it can perceive.
Lists all environments in the system. Selecting one displays three things:
- Connected Agents — which agents are currently linked to the environment at that point in time
- Percepts — the current state of all percepts, displayed as a searchable drop-down table
- Changes History — a chronological log of every modification to the environment's percepts, including the action type (CREATE, DELETE, or CHANGE), the percept content, and the action that triggered the change
Shows all messages exchanged between agents. You can filter messages by selecting a specific agent on the left panel. Each message card displays the sender, receiver, timestamp, performative, and content.
The highlight of this page is the Sequence Diagram Generator. Select two or more agents and the interface generates a UML-style diagram of their communication, with arrows indicating direction and showing the performative and content of each message. You can zoom in and out on the diagram, and export it as PNG or SVG.
The timeline sits at the top of every page. It lets you navigate through the entire simulation history even after the simulation has already finished.
It operates in two modes:
- Live mode — the interface updates in real time as new data arrives, and the slider follows automatically
- Historical mode — activated by dragging the slider or using the navigation buttons; the interface shows the system state at the selected point in time
Available controls:
| Control | Description |
|---|---|
| ⏮ | Jump to the beginning of the simulation |
| ⏭ | Jump to the end |
| ◀ / ▶ | Step backwards or forwards by 100ms |
| ⏸ / ▶ | Pause or resume playback |
| Speed selector | Replay at 0.25× to 8× speed |
Note: new data continues to be recorded normally while in Historical mode — you are not pausing the simulation, only your view of it. To actually pause the simulation, use the Pause/Play button on the Menu page.