Create Your First Agent
Open in CMSThis guide walks you through creating your first AI agent with the New Agent wizard. You do not need to upload documents or connect a database for this tutorial.
You will build Atlas, the operations assistant of Kirana Group, a fictional company with offices, project sites, and warehouses. Atlas helps Kirana's employees with internal policies, safety rules, and compliance questions. The same agent is used throughout these guides and in Configuring Your Agent.
Before you start
- You have a Qlar account and can open the CMS.
- Keep the answers from the table below at hand. The whole wizard takes about five minutes.
Scenario used in this tutorial
| Wizard question | Value |
|---|---|
| Agent type | SOP and internal knowledge |
| Business or institution name | Kirana Group |
| Industry | Logistics & Transportation |
| Business website | Leave empty |
| Agent name | Atlas |
| Communication style | Clear & concise - Straightforward, easy to understand |
| Conversation Initiative | Guided - Answers, and now and then offers one useful next step. |
| Language | Auto |
| Should the logo include a character? | Symbol only - Clean, professional mark |
| What visual style should the agent have? | Sharp & technical - Precise, structured, data feel |
| Knowledge areas | Company policies & guidelines, Safety protocols & SOPs, Compliance & regulatory requirements |
Step 1: Open New Agent
Open Organizations from the account menu (your avatar at the top right of the CMS), select the organization the agent should belong to (here Kirana Group), and click New agent above its agent cards on the Agents tab. The agent is created in that organization, even if you are working in another one right now.

If you have no agent at all yet, the CMS opens Create your first agent by itself, a guided flow that builds a sample Personal agent for you (see Quick Start: Your First Agent); new users first see the Welcome page. To build a Service agent like Atlas, click Use the template wizard there, or use New agent as above. You can also click the agent at the top left of the CMS and choose New agent at the bottom of the switcher.
Step 2: Choose the agent type
The wizard opens with the page title Create agent and, under Choose a template, a card for each agent type. Each type asks its own setup questions and comes with its own defaults. Custom solution lets you start from a blank slate. The list of types can differ per workspace.
For Atlas, click SOP and internal knowledge. It is made for agents that help employees find company information, policies, and procedures.
Personal or service agent? In your own Individual organization the wizard first asks Who will this agent serve?: pick Personal agent (an assistant for you alone, which may use your Claude or ChatGPT subscription models) or Service agent (serves other people). There is no default, so a template opens only after you pick one. In a Collective organization, or someone else's Individual organization, the wizard says the agent will be a service agent. Atlas serves colleagues, so it is a service agent. See Personal vs Service Agents.

Step 3: Describe your organization
Step 1 of 4 asks about your business. The answers help the wizard write a better default persona for your agent.
- What is your business or institution name? β
Kirana Group - Which industry does your business or institution belong to? β
Logistics & Transportation. The list has no construction option. Kirana runs project sites and warehouses, so this is the closest fit. - What is your business website? β leave it empty. If your company has a public website, enter it here so the agent can learn your brand.
Click Continue.

Step 4: Set up the agent's behavior and look
Step 2 of 4 defines how the agent talks and what it looks like.
- What would you like to name this agent? β
Atlas. Fun fact: the placeholder in this field literally suggests "Marcus, Atlas, Sage". - How should the agent communicate with employees? β
Clear & concise - Straightforward, easy to understand - How much should the agent take the lead after answering? β keep the default
Guided. This is the agent's Conversation Initiative:Reactiveonly answers what is asked,Guidednow and then offers one useful next step, andProactiveactively proposes what to explore next. You can change it later on the Behavior page. - What language should the agent use? β keep the default
Auto. The agent replies in the user's language: a question in English gets an English answer, a question in Indonesian gets an Indonesian answer. You can also type a fixed language. - Should the logo include a character? β
Symbol only - Clean, professional mark - What visual style should the agent have? β
Sharp & technical - Precise, structured, data feel
The last two answers are used to generate a logo and an avatar for your agent. You can replace them with your own images later.
Click Continue.

Step 5: Choose the knowledge areas
Step 3 of 4 asks What internal knowledge areas will this agent cover? Tick every area the agent should help with. For Atlas, tick:
- Company policies & guidelines
- Safety protocols & SOPs
- Compliance & regulatory requirements
The other options are Warehouse operations procedures, Fleet management & maintenance, Shipping documentation standards, and Other. Leave them unticked.
Click Create agent.

Step 6: Skip the training resources and wait while the agent is built
Step 4 of 4, Add training resources, is optional. You can add files or online resources now, or add them later in Documents. You do not need any for this tutorial, so click Continue.

The wizard then shows Bringing your agent to life with a progress list. It sets up the agent's look, creates the dark mode and light mode logos and the avatar, styles dark and light mode, and adds the final touches.

The screen says it may take a couple of minutes. In our test it took about 40 seconds. Keep the page open; the next screen appears on its own.
Step 7: Your agent is created
When everything is ready, you see Agent created and Atlas is ready to help you. Training continues in the background, but you can already configure the agent and chat with it.

Click Continue.
Step 8: Meet Atlas on the Dashboard
You land on the agent's Dashboard (under Home in the agent sidebar). A new agent has no conversations yet, so it shows No statistics available.
On the right is the live preview, where Atlas is already active. It shows:
- The Kirana Group logo the wizard generated.
- A short welcome message (one or two sentences) written from your answers in the agent's language, shown under the logo.
- Three suggested questions your employees might ask.
- An Ask Atlas input at the bottom.

Step 9: Try a conversation
Type a question in Ask Atlas and press Enter (or click the send button). For example:
What should I check before using a ladder on site?

Atlas answers in the same panel. It lists general checks: the ladder's condition, whether it suits the task, where you place it, how you set it up, and the surroundings. It also tells you to follow your site's ladder procedure.

These two screenshots show the preview of an agent the wizard just created, so it has the generated logo and welcome message. Yours is worded differently, because the wizard writes the welcome message and the answers anew each time.
That is a sensible answer, but it comes from general knowledge. Atlas does not know Kirana's own ladder rules yet, because you have not given it any documents. In Documents you upload Kirana's SOP, and from then on Atlas answers from your rules and names the SOP it used.
The preview runs your latest saved configuration, so you can test changes here before your users see them. See Setup and Publish for how saving, previewing, and publishing fit together.
Check the result
- The Organizations page shows Atlas under Kirana Group, and the top bar shows Kirana Group and Atlas.
- The preview shows a logo, a welcome message, and three suggested questions.
- Atlas answers a question in the language you asked it in.
Troubleshooting
"Agent Limit Reached" appears when I click New Agent. Each user can own a limited number of agents, and the message shows the maximum. Delete an agent you no longer need, or ask your administrator.
The wizard stays on "Bringing your agent to life" for a long time. Generating the logos and avatar often takes under a minute, but it can take a couple of minutes. Keep the page open and wait for the confirmation screen.
I made a mistake in the wizard. Everything you entered can be changed later from the agent sidebar, for example the name and logo in Profile and the tone in Behavior. You do not need to create the agent again.
Atlas gives a general answer instead of Kirana's rule. That is expected until you add knowledge. Upload your SOPs in Documents.
Next steps
| If you want to⦠| Go to |
|---|---|
| Give Atlas Kirana's own logo and welcome message, and make it live | Setup and Publish (next step) |
| Teach Atlas Kirana's approval policy | Documents |
| Configure your agent step by step, from the basics to advanced features | Configuring Your Agent |