Step 1: Profile
Setting up your agent's profile is like filling in the badge a new employee wears on their first day: it tells everyone who this agent is and what it's here to help with. The profile is the first step when you create an agent, and it covers the name, description, and picture that people see when they start a chat. A clear profile helps people know what the agent does before they even send a message.
Before you start
- You don't need anything saved yet — this is the very first step of creating an agent.
- Have a short, clear idea of what this agent is for (for example, "answering product questions" or "qualifying sales leads"). You'll write that into the name and description.
Step-by-step
- Open the agent creation canvas and click the Profile node.
- Fill in the fields below.
- Click Save to create your agent.
Image: The profile step showing name, description, and avatar fields on the creation canvas
What you fill in
| Field | Required | What it does |
|---|---|---|
| Name | Yes | The agent's display name (for example, "Sales Assistant" or "Support Bot") |
| Description | Yes | A short explanation of what the agent does. Shown on the agent card and in channel greetings |
| Avatar | No | A picture that represents the agent. If you leave it blank, Nirvai creates one for you automatically |
| Model | Yes | The AI model your agent runs on. Different models vary in what they can do, how fast they respond, and how much they cost |
Writing a good name
Your agent's name shows up everywhere — in chat headers, channel messages, automation steps, and the Agent Control Panel (where you manage all your agents). Make it descriptive so you and your users can tell agents apart at a glance:
| Good names | Why |
|---|---|
| Sales Qualifier | Makes the purpose clear |
| Product FAQ Bot | People know what to ask |
| Onboarding Guide | Describes the interaction |
| Avoid | Why |
|---|---|
| Agent 1 | Gives no hint of what it does |
| Bot | Too generic |
| My AI | Unhelpful in a list of agents |
Writing a good description
The description does two jobs:
- For your users — it appears as the greeting or context in chat and channel messages.
- For you — it reminds you what the agent is for when you're juggling several of them.
Keep it to one or two sentences. Focus on what the agent does and who it's for:
"Answers customer questions about our product features, pricing, and availability. Trained on our latest product catalog and FAQ."
"Qualifies inbound leads by researching their company and deciding whether they're a good fit. Uses web search and our CRM data."
Choosing an avatar
The avatar gives your agent a face. It shows up in:
- The Agent Control Panel grid
- Chat conversations
- Channel messages (WhatsApp, Instagram, and others)
- Automation step cards
You can upload any image (PNG or JPG). If you skip this, Nirvai creates a default picture based on the agent's name.
When you have several agents, give each one a distinct avatar. It makes them far easier to spot at a glance in the Agent Control Panel and when you're building automations.
Troubleshooting
| Problem | Fix |
|---|---|
| The Save button stays greyed out | Make sure the Name, Description, and Model fields are all filled in — they're required. |
| My uploaded picture won't appear | Use a PNG or JPG file. If it still doesn't show, try a smaller image or refresh the page and upload again. |
| I picked the wrong model | You can change the model anytime — reopen the Profile step, pick a different one, and save. |
What's next
After you save your profile, click the Starters node on the canvas to continue to Step 2: Conversation Starters.
Saving the Profile step creates your agent. From here on, each step saves on its own — you can move between nodes freely and your work is kept.