Skip to Content
Baseera Docs

Create an agent

Create an agent in the dashboard, give it a name and a purpose, and get version 1 live.

An agent is one assistant inside one of your products. It has instructions, a model, optional knowledge and optional tools. You create it in a minute and refine it afterwards.

You need the Owner, Admin or Developer role. Viewers can look at agents but not create them.

Before you start

Add a model provider key first, so you can pick a model in the next guide. If you have none yet, the Agents page says "No agents yet. Add a model provider key, then create your first agent." See Provider keys.

Create the agent

Open Agents in the sidebar and press New agent in the bar above the page. You can also press Ctrl or Cmd plus K and choose Create an agent.

Fill in the New agent dialog:

  • Name: 2 to 80 characters, for example "Orders assistant".
  • Your product: the address where the assistant will run, for example app.example.com. It becomes an allowed domain so the agent can start sessions there. Optional.
  • What should it help with?: one or two sentences, for example "Review orders before they are confirmed and draft messages to customers." Baseera adds it to the starting system prompt. Optional.
  • Main language: Arabic or English. The starter prompt and the platform rules follow it.

Press Create agent.

What you see

Baseera creates the agent, publishes it as version 1, and opens its Integrate page. You can chat from your app straight away once you have a provider key, a model and a publishable key. Edits you make later go to a draft and reach users only when you publish. See Preview and publish.

The agent starts with these defaults: the Chat and Immersive modes on, the tone Neutral, and a starter system prompt in the language you chose. Queue mode shows as "Coming soon" and is not available yet.

A new agent has no model until you choose one. Until then, your app gets an "agent not configured" error instead of a reply. Pick a provider key and a model on the Assistant page next.

What can go wrong

MessageWhat it means and what to do
"Check the name and the length of the text."The name is outside 2 to 80 characters, or the help text is too long.
"That is not a valid product address. Use a domain such as app.example.com."Your product must be a plain domain. Remove paths, spaces and credentials.
"You are not allowed to create agents in this organization."Your role is Viewer. Ask an owner or admin to change it.
"Could not create the agent. Try again."A temporary failure. Press Create agent again.

If saving the domain fails after the agent exists, the agent stays. Add the domain later on Deploy & access, under Allowed domains.

Next steps

On this page