The first time you run rasa train on a new Rasa Mantle agent, Rasa warns that agent.yml “is missing a unique value for ‘agent.id’”. It isn’t an error: Rasa gives your agent a generated id and writes it into the file. Here’s why it happens, and how to give your agent a readable id of your own.
What I Was Doing
I was building my first Mantle agent with Rasa Pro 3.21.4, following Rasa Tutorial — Part 2: Create Your First Mantle Agent. After the setup wizard created the project, I switched the agent to Claude and ran rasa train for the first time.
What I Expected
A trained agent, with no warnings about my files.
What I Got
The same warning twice, each time with a different generated id, then the trained model:
2026-11-18 23:32:08 WARNING rasa.mantle.config.agent_spec - [warning ] The agent config '/Users/user/my-rasa-agent/agent.yml' is missing a unique value for 'agent.id'. Proceeding with generated id '20261118-233208-brilliant-permutation' and overwriting 'agent.id' in the file.
2026-11-18 23:32:09 WARNING rasa.mantle.config.agent_spec - [warning ] The agent config '/Users/user/my-rasa-agent/agent.yml' is missing a unique value for 'agent.id'. Proceeding with generated id '20261118-233209-ragged-rating' and overwriting 'agent.id' in the file.
2026-11-18 23:32:09 INFO rasa.mantle.model_archive.snapshot - [info ] Mantle model package saved at 'models/20261118-233209-either-halibut.tar.gz'.

Training still worked: the last line names the model file it saved.
What I Checked
The agent: block that the setup wizard wrote into agent.yml has a language and a persona, but no id:
agent:
language: en
persona: |
You are a friendly, concise banking assistant. Answer clearly, and ask one
short clarifying question whenever a request is ambiguous.
Rasa’s agent.yml reference (opens in a new tab) explains it: id is optional, and when it’s missing, Rasa generates a unique id in the form YYYYMMDD-HHMMSS-<duoname> and writes it back into agent.yml, with a warning. After training, my file had a new last line in the agent: block, id: 20261118-233209-ragged-rating, the second of the two generated ids.
Why It Happens
Every Mantle agent has an id, a stable name for the agent. Rasa’s starter project leaves it out, so the first rasa train makes one up from the date, the time and two random words, and saves it. You’ll see it at the top of the Rasa Inspector. Once the file has an id, the warning doesn’t appear again.
The Fix
Nothing breaks if you keep the generated id. To give your agent a readable id instead, open agent.yml in a text editor and set id inside the agent: block. I replaced the generated id with banking-assistant:
agent:
language: en
persona: |
You are a friendly, concise banking assistant. Answer clearly, and ask one
short clarifying question whenever a request is ambiguous.
id: banking-assistant
Use a short name that describes your agent, like Rasa’s own example telco-support, and keep it once your agent is in use. Then train again:
rasa train
After the Fix
No agent.id warning this time, just the trained model:
2026-11-19 00:02:09 WARNING rasa.utils.beta - Mantle is currently experimental and under active development 🔬.
2026-11-19 00:02:10 INFO rasa.mantle.model_archive.snapshot - [info ] Mantle model package saved at 'models/20261119-000210-oily-bug.tar.gz'.

The remaining warning only says that Mantle is in beta. It appears with every Rasa command.
Common Mistakes
| Mistake | Do this instead |
|---|---|
| Taking the warning for a failed training | Check the last line: “Mantle model package saved” means training worked. |
Putting id at the top level of agent.yml | Put it inside the agent: block, next to language and persona. |
| Changing the id every time you train | Pick one id and keep it. It’s your agent’s stable name. |
FAQ
Does the warning come back on every train?
No. Once agent.yml has an id, generated or your own, Rasa uses it and doesn’t warn again.
Can I keep the generated id?
Yes. It works the same way; it’s just harder to recognise.
Where do I see my agent’s id?
At the top left of the Rasa Inspector, which rasa inspect opens.
Conclusion
The “missing a unique value for ‘agent.id’” warning only means Rasa named your agent for you. Set your own id in the agent: block of agent.yml, and the warning won’t appear.
Additional Resources
- agent.yml reference (opens in a new tab) (Rasa docs)
- Project structure (opens in a new tab) (Rasa docs)
Related
- Rasa Tutorial — Part 2: Create Your First Mantle Agent
- Rasa Tutorial for Beginners: Mastering Rasa Pro in Python, with every part of the series
Rasa, Claude and other names mentioned are trademarks of their respective owners. JD Bots isn’t affiliated with or endorsed by Rasa Technologies or Anthropic.
0 comments