Skip to main content
0 reactions

Fixed: Agent config “is missing a unique value for ‘agent.id’” in Rasa Mantle

A designed card reading Rasa Fix: Missing agent.id Warning, with a warning sign and two labels: shown on the first rasa train, and fix: set agent.id yourself.
Fixed: the missing agent.id warning in Rasa Mantle

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:

Output (the lines that matter)Plain text
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'.
A Terminal window after the first rasa train: two warnings that agent.yml is missing a unique value for agent.id, each with a generated id, followed by the line saying the Mantle model package was saved.
The first rasa train: two agent.id warnings, then the saved model.

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.yml (excerpt, before training)YAML
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.yml (excerpt)YAML
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:

TerminalBash
rasa train

After the Fix

No agent.id warning this time, just the trained model:

Output (the lines that matter)Plain text
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'.
A Terminal window after running rasa train with agent.id set to banking-assistant: only the Mantle beta notice and the line saying the model package was saved, with no agent.id warning.
With agent.id set, rasa train shows no agent.id warning.

The remaining warning only says that Mantle is in beta. It appears with every Rasa command.

Common Mistakes

MistakeDo this instead
Taking the warning for a failed trainingCheck the last line: “Mantle model package saved” means training worked.
Putting id at the top level of agent.ymlPut it inside the agent: block, next to language and persona.
Changing the id every time you trainPick 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

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