Skip to main content
0 reactions

Rasa CALM vs Mantle: Which Should You Use?

Title card comparing Rasa’s two engines: CALM, built on flows, generally available and not for new agents, and Mantle, built on skills, beta in Rasa Pro 3.21 and recommended.
Rasa CALM vs Mantle at a glance.

Rasa Pro has two engines for running conversations: CALM, its stable engine since 2023, and Mantle, the new engine that arrived in Rasa Pro 3.21. Here’s how they differ, what Rasa now recommends, and which one to use.

The Short Answer

Use Mantle for new agents. Rasa’s own FAQ (opens in a new tab) says CALM is no longer the recommended engine, although it is still supported and existing agents keep running on it. Mantle is a beta in Rasa Pro 3.21, so check what it can’t do yet before you rely on it in production.

CALM vs Mantle in One Table

CALMMantle
How you describe a taskFlows: step-by-step YAML that lists every step of a taskSkills: plain-language instructions in a skill.md file, with optional fixed steps and hard rules
What the LLM doesTurns each message into commands that start and drive flowsPicks the next move inside one loop, within the limits the framework sets
Status in Rasa Pro 3.21Generally availableBeta, started with rasa init --engine mantle
Rasa’s recommendationNo longer recommended for new agentsRecommended for new agents
IntentsSupportedNot supported: intents work only with CALM
Answers from documentsEnterprise Search, with vector stores such as Qdrant and MilvusReference files inside your project; external stores aren’t built yet
Saving conversations to a databaseTracker stores, such as SQL databases and RedisThe same kinds of tracker stores, set in integrations.yml

How CALM Builds an Agent

In CALM you write flows. Each flow is one task, written in YAML as a list of steps, such as asking for a value, calling an action or giving a response. An LLM reads each message and turns it into commands, such as starting a flow or filling in a value, and the flow’s steps run in order. Built-in conversation patterns handle corrections, cancellations and changes of topic around a flow (Rasa’s docs (opens in a new tab)).

How Mantle Builds an Agent

In Mantle you write skills. A skill is a folder with a skill.md file that says, in plain words, what the skill does. Mantle runs one LLM in a loop with the framework in charge: it settles what it can by itself, lets the LLM choose the next move, and checks every choice against your rules (Mantle overview (opens in a new tab)).

When steps must always happen in a fixed order, you add an ordered block (opens in a new tab). When a mistake would be expensive, you add a guarantee (opens in a new tab) that the framework enforces, whatever the LLM decides.

When CALM Still Makes Sense

  • You already run a CALM or intent-based agent. Rasa says it keeps running, and CALM is still supported.
  • You need something Mantle doesn’t have yet, such as searching Qdrant or Milvus.

For everything else, start with Mantle.

Why This Series Uses Mantle

The Rasa Tutorial on JD Bots builds every agent with Mantle, because it’s the engine Rasa recommends for new agents. Each Mantle feature that’s still missing gets its own part as soon as Rasa ships it.

Common Mistakes

MistakeWhat to do instead
Starting a new agent with CALM because more tutorials exist for itRasa recommends Mantle for new agents.
Using intents in a Mantle agentIntents work only with CALM. Mantle uses skills.
Expecting a Mantle agent to keep its conversations after a restartBy default, Mantle keeps them in memory only. To save them, set a tracker store, such as SQL or Redis, in integrations.yml.

FAQ

Will CALM be removed?

Rasa says CALM is still supported. Rasa’s release and maintenance policy (opens in a new tab) lists how long each Rasa Pro version gets updates.

Is Mantle free?

Mantle is part of Rasa Pro, so the free Developer Edition licence key covers it within its limits. Is Rasa Free? explains those limits.

Is Mantle ready for production?

Rasa marks it as beta in Rasa Pro 3.21. Check Rasa’s What’s Next (opens in a new tab) page for the features that aren’t built yet before you depend on it.

Conclusion

CALM builds agents from flows and is still supported, but Rasa now recommends Mantle, which builds agents from skills with the framework in charge of every step. Choose Mantle for a new agent, and keep CALM only for an agent you already run, or for a feature Mantle doesn’t have yet.

Additional Resources

Rasa and other names mentioned are trademarks of their respective owners. JD Bots isn’t affiliated with or endorsed by Rasa Technologies.

0 comments