Introduction
Core Concepts
The fundamental building blocks of the Consonant platform.
The Hierarchy
Consonant organizes work into a clear hierarchy to manage complexity.
Project
└── Agents (The Workers)
└── Resources (Tools/DBs)
└── Policies (The Rules)
└── Goals (The Work)
└── Plan
└── Tasks
1. Project
A namespace for a related set of agents and policies. Usually maps to a team or a specific application.
2. Agent
An autonomous unit of execution. An agent has:
- Identity: A unique name and address.
- Runtime: A Docker image and resource configuration.
- Capabilities: What it can do (described in natural language for the planner).
3. Goal
A high-level objective submitted by a user or another system. Goals are what you want to achieve, not how to achieve it.
Example: "Refund all users who complained about downtime in the last 24h"
4. Plan & Tasks
When a Goal is received, the Control Plane generates a Plan. Each Task is assigned to a specific Agent.
Dynamic Planning
Unlike rigid workflows, Plans in Consonant are dynamic. If a Task fails, the Control Plane can modify the remaining Plan to attempt recovery or try a different strategy.