In this part of the Rasa Tutorial, you create your first AI agent with Rasa Pro’s Mantle engine, connect it to Claude, and chat with it in your browser. You’ll run Rasa’s setup wizard, change one file and run two commands.
By the end, you’ll have a working demo agent in your my-rasa-agent folder. It answers in the Rasa Inspector, a chat page that also shows what the agent did behind each reply.
This is Part 2 of the Rasa Tutorial. The parts in Module A, Start Here:
- Part 1: What Is Rasa? Rasa Pro and Mantle Explained
- Part 2: Create Your First Mantle Agent (you are here)
All parts of the Rasa Tutorial
Module A: Start Here
Module B: Building Skills
- Part 3: Write a Skill’s Instructions
- Part 4: Tools: Let Your Agent Run Python
- Part 5: Memory: Remember What Matters
- Part 6: References: Answer from Your Documents
- Part 7: Responses: Control the Exact Wording
Module C: Progressive Control
- Part 8: Tool Constraints
- Part 9: Scoped Instructions
- Part 10: Ordered Blocks
- Part 11: Sub-skills and Composition
Module D: Orchestration
- Part 12: The Runtime Loop: How Mantle Handles a Turn
- Part 13: Guarantees and Guardrails
- Part 14: Skills and Routing
- Part 15: Context Management
Module E: Agent Setup
- Part 16: agent.yml: Identity, Persona and Rules
- Part 17: integrations.yml: Claude, Model Groups and Routing
- Part 18: MCP Tools
- Part 19: Hooks
Module F: Testing
- Part 20: Simulate and Evaluate Your Agent
- Part 21: Scenarios and Assertions
- Part 22: Build Faster with the Rasa Copilot
Module G: Voice
- Part 23: Talk to Your Agent in the Browser
- Part 24: Designing for Voice
- Part 25: Connect a Phone Line
- Part 26: Test and Monitor Voice
Module H: Channels
- Part 27: The REST Channel and a Website Chat Widget
- Part 28: Microsoft Teams
Module I: Observability
- Part 29: Tracing with Langfuse
- Part 30: Metrics and Conversation Events
Module J: Deploy
- Part 31: Run Your Agent with Docker
- Part 32: CI/CD for a Rasa Agent
- Part 33: Deploy to Kubernetes with Rasa’s Helm Chart
- Part 34: Load Testing
- Part 35: Deploy on AWS
- Part 36: Deploy on Azure
- Part 37: Deploy on Google Cloud
Module K: Rasa Studio
- Part 38: Rasa Studio with a Mantle Agent
Module L: Wrap-up
- Part 39: Final Project, Cheat Sheet and What to Learn Next
Cost: Rasa’s Developer Edition licence is free. Claude is pay-per-use: Claude Sonnet 5.5, the model this series uses, costs $2 per million input tokens and $10 per million output tokens (Claude pricing (opens in a new tab)). In this part, each message you send makes three calls to Claude. Every Claude call I made for this part cost $0.05 in total, as shown on the Cost page of the Claude Console.
Prerequisites
- Rasa Pro installed in a folder named
my-rasa-agent, with your licence key in its.envfile: Installing Rasa Pro: Setting Up Your Development Environment. - A Claude API key. Step 1 shows where to get one.
Step 1: Add Your Claude API Key
Open Terminal, go to your project folder and turn on its virtual environment:
cd my-rasa-agent
source .venv/bin/activate
Your prompt now starts with (my-rasa-agent), so every rasa command uses the Rasa Pro you installed in this folder.
Your agent needs an LLM to think with, and this series uses Claude. If you don’t have a Claude API key yet, How to Get a Claude API Key (opens in a new tab) shows how to create one in the Claude Console.
Add the key to the .env file, under your Rasa licence key. Replace YOUR_CLAUDE_API_KEY with your key:
echo 'ANTHROPIC_API_KEY=YOUR_CLAUDE_API_KEY' >> .env
>> adds a line to the end of the file. A single > would replace the file and delete your licence key. ANTHROPIC_API_KEY is the name Rasa’s docs use for Claude’s key; Anthropic is the company that makes Claude.
Step 2: Create Your Mantle Agent with the Setup Wizard
Rasa’s setup wizard creates a starter agent in the current folder:
rasa init --engine mantle
rasa init creates a new project, and --engine mantle picks Mantle, Rasa’s LLM-native engine. Mantle is in beta, so Rasa commands print a warning that it’s experimental.
The wizard asks three questions. Answer them like this:
- Please enter a path where the project will be created: press Enter to use the current folder.
- Enter your OpenAI API key: press Enter. The wizard only asks for an OpenAI key, and this series uses Claude instead. It asks three times, so press Enter each time.
- Validate and train your agent now? Type
n. The new agent is set up for OpenAI, so you’ll switch it to Claude before training it.
The wizard found your licence key in .env by itself. Here’s what it printed:
Welcome to Rasa! 🤖
? Please enter a path where the project will be created [default: current directory]
Created project directory at '/Users/user/my-rasa-agent'.
Setting up your Mantle agent...
2026-11-18 23:30:59 WARNING rasa.utils.beta - Mantle is currently experimental and under active development 🔬.
Reusing RASA_LICENSE from your environment.
Enter your OpenAI API key (input hidden):
OpenAI API key cannot be empty.
Enter your OpenAI API key (input hidden):
OpenAI API key cannot be empty.
Enter your OpenAI API key (input hidden):
OpenAI API key cannot be empty.
No OpenAI API key provided; its entry in .env will be blank.
Wrote secrets to /Users/user/my-rasa-agent/.env (permissions 0600).
Installing agent skills...
Registered the Rasa MCP server for Claude Code, Cursor.
Downloading Mantle documentation for your coding agent...
? Validate and train your agent now? No
Skipping validation and training.
Ok 👍🏼. You can train and inspect your agent any time by running 'rasa train' and 'rasa inspect' inside the project directory.
Besides your agent, the wizard set up helpers for two AI coding assistants, Claude Code and Cursor: Rasa’s agent skills, a connection to Rasa’s tools, and a copy of the Mantle docs. You don’t need them for this series.
Step 3: Look Around Your Agent’s Project
Your folder now holds a complete agent. These are the files you’ll work with:
my-rasa-agent/
├── agent.yml
├── integrations.yml
├── AGENTS.md
├── .env
└── skills/
└── view_transactions/
├── skill.md
├── memory.yml
└── tools.py
| File | What it holds |
|---|---|
agent.yml | The agent itself: its language, its persona (how it talks), the model group it uses and its global rules. |
integrations.yml | The LLM the agent calls, and the channels it talks on. |
skills/view_transactions/skill.md | One skill: what it does, when to use it, and its instructions in plain English. |
skills/view_transactions/memory.yml | What the skill remembers during a conversation, such as the account the user picked. |
skills/view_transactions/tools.py | Python functions the skill can call. Here they return made-up demo accounts and transactions. |
AGENTS.md | Notes about the project for AI coding assistants. |
.env | Your keys. Never share it. |
The starter is a small banking agent that shows recent transactions. The later parts of this series go through each of these files.
Step 4: Switch Your Agent to Claude
The agent’s LLM is set in integrations.yml. Open it in a text editor, such as TextEdit or VS Code. The wizard set it to OpenAI:
model_groups:
- id: main_model
models:
- provider: openai
model: gpt-5.2
api_key: ${OPENAI_API_KEY}
Change the three lines under models: so the block reads:
model_groups:
- id: main_model
models:
- provider: anthropic
model: claude-sonnet-5-5
api_key: ${ANTHROPIC_API_KEY}
provider: anthropicsends the agent’s requests to Claude.model: claude-sonnet-5-5picks Claude Sonnet 5.5. You’ll find every model name on Claude’s models overview (opens in a new tab).api_key: ${ANTHROPIC_API_KEY}reads your key from.env, so the key itself never sits in this file.id: main_modelnames this model group.agent.ymluses that name to pick the LLM for the agent.
Save the file. Here’s the complete integrations.yml. The channels section turns on the REST channel, for apps that talk to your agent, and the Inspector. The commented lines at the end show how to connect remote tools, which a later part covers.
# External integrations for your Mantle agent.
# The orchestrator names its group in agent.yml (`orchestrator.model_group`).
model_groups:
- id: main_model
models:
- provider: anthropic
model: claude-sonnet-5-5
api_key: ${ANTHROPIC_API_KEY}
channels:
rest:
enabled: true
inspector:
enabled: true
# Optional — remote MCP tools (uncomment and set MCP_BANKING_TOKEN).
# Import a tool in skill.md with: import_tools: [mcp/banking:get_balance]
#
# mcp_servers:
# - name: banking
# url: http://localhost:8000/mcp/
# token: ${MCP_BANKING_TOKEN}
# # tool_timeout: 30
# # meta_map:
# # static:
# # source: "rasa_agent"
# # from_memory:
# # - field: user_id
# # param: user_id
Advertisement
Step 5: Train Your Agent
rasa train
rasa train checks your agent’s files and packs them into a model file in a new models folder. It took about 10 seconds:
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'.
The first time, Rasa warns that agent.yml has no agent.id and adds one for you, so the warning doesn’t come back (here’s how to set your own id). The last line names your trained agent.
Step 6: Chat with Your Agent in the Rasa Inspector
rasa inspect
rasa inspect starts your agent on your computer and opens the Rasa Inspector in your browser. It was ready after about 15 seconds:
2026-11-18 23:33:45 INFO root - Rasa server is up and running.
Development inspector for channel inspector is running. To inspect conversations, visit http://localhost:5005/webhooks/inspector/inspect.html?projectUrl=http%3A%2F%2Flocalhost%3A5005&channel=inspector
The log also shows a few WARNING lines, for example that Rasa doesn’t recognise the name claude-sonnet-5-5 when it estimates prompt sizes (why that one is harmless). They don’t stop your agent. If the browser doesn’t open, copy the address from the last line into it.
Claude writes the agent’s greeting:

Type Show my recent transactions and press Enter. The agent lists two demo accounts and asks which one you want. Type Everyday Checking, and it shows that account’s transactions:

Claude formats some replies with Markdown, such as ** around names and a table made of | characters. The Inspector shows those characters as they are.
Now click Inspect at the top of the page. Inspect mode shows what happened behind each reply:

- Left: the conversation, with every LLM call to
claude-sonnet-5-5and how long it took, and every tool call, such asget_recent_transactions. Click one to see its details. - Middle: the active skill, View Transactions, with the instructions from its
skill.md. - Right: the skills used so far, and the agent’s memory, which now holds the account you picked.
When you’re done, go back to Terminal and press Ctrl+C to stop the agent.
Clean Up
If the agent is still running, press Ctrl+C in Terminal to stop it. Claude charges only when your agent calls it, so a stopped agent costs nothing. Keep the my-rasa-agent folder: the next part builds on it.
Common Mistakes
| Mistake | Do this instead |
|---|---|
Adding the Claude key with > instead of >> | > replaces .env and deletes your licence key. Add the licence line back with >>. |
| Answering Yes to “Validate and train your agent now?” | Answer No, switch integrations.yml to Claude, then run rasa train. |
Pasting your Claude key into integrations.yml | Keep the key in .env. integrations.yml only names it with ${ANTHROPIC_API_KEY}. |
Changing a skill or agent.yml without training again | Run rasa train, then rasa inspect, so the Inspector uses your changes. |
Opening a new Terminal window and running rasa straight away | Run source .venv/bin/activate in the project folder first. |
Troubleshooting
| Problem | Fix |
|---|---|
zsh: command not found: rasa | Turn on the virtual environment: source .venv/bin/activate. |
Unknown model name 'claude-sonnet-5-5', using 'cl100k_base' encoding as fallback | Harmless. Rasa estimates prompt sizes with a tokenizer that doesn’t know Claude’s model names, so it uses a general one. Here’s why. |
missing a unique value for 'agent.id' on the first rasa train | Harmless. Rasa adds an id to agent.yml, so it appears only once. Set your own id. |
Replies show ** and | characters | That’s Markdown. The Inspector shows it as plain text. |
| The browser doesn’t open | Copy the address that rasa inspect prints into your browser. |
FAQ
Do I need an OpenAI API key?
No. The wizard asks for one, but this series uses Claude. Leaving it empty adds a blank OPENAI_API_KEY= line to .env, which does no harm.
Can I use a different Claude model?
Yes. Change model: in integrations.yml, for example to claude-opus-5-5 (Claude Opus 5.5, $4 and $20 per million input and output tokens) or claude-haiku-5-5 (Claude Haiku 5.5, $0.10 and $0.50). Then start rasa inspect again.
What are the .claude and .cursor folders?
Hidden folders the wizard made for the AI coding assistants Claude Code and Cursor. Your agent doesn’t use them.
Where are my conversations saved?
By default, only in the agent’s memory, so they’re gone when you stop it. To keep them, set a tracker store, such as SQL or Redis, in the tracker_store section of integrations.yml (integrations.yml reference (opens in a new tab)).
Is Mantle ready for production?
Not yet. Mantle is in beta and may change, which is why Rasa commands say it’s experimental.
Conclusion
You created a Mantle agent with Rasa’s setup wizard, switched it to Claude Sonnet 5.5, trained it and chatted with it in the Rasa Inspector, where you saw each Claude call and tool call behind its replies. In the next part, you’ll write a skill’s instructions yourself.
← Previous: Installing Rasa Pro: Setting Up Your Development Environment
Next → Part 3: Write a Skill’s Instructions
Additional Resources
- Getting Started with Mantle (opens in a new tab) (Rasa docs)
- integrations.yml reference (opens in a new tab) (Rasa docs)
- Project structure (opens in a new tab) (Rasa docs)
- Trying your assistant in the Inspector (opens in a new tab) (Rasa docs)
- Models overview (opens in a new tab) (Claude docs)
Related
- How to Get a Free Rasa Pro License Key (Developer Edition)
- 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