Instructions and model
Write the system prompt, choose a provider key and model, set tone and rate limits, and style the assistant with a theme.
The Assistant page holds everything that shapes how the agent answers: its name, instructions, languages, model and limits. The Theme page holds how it looks inside your product. Both save to the draft, so nothing reaches your users until you publish.
You need the Owner, Admin or Developer role to edit. Viewers see the pages read-only.
Write the instructions
Open the agent and choose Assistant in the sidebar.
Set Name (2 to 80 characters) and Description (up to 280 characters, optional). Choose a Tone: Brief, Neutral or Warm. The tone adds one fixed line to the platform rules. It is a choice from a closed list, not free text.
Open the Advanced group and write the System prompt, up to 20,000 characters. Click a variable to insert it. Baseera fills it in on every turn:
| Variable | Filled with |
|---|---|
{{assistant.name}} | The agent's name |
{{tenant.name}} | The customer account of the signed-in user |
{{user.name}} | The user's name |
{{user.locale}} | The user's language |
{{page}} | The page the user is on |
{{entity.type}} | The type of the record the user has open |
{{entity.ref}} | The reference of that record |
A variable with no value becomes empty. A name that is not in the list is sent as written, and the form tells you: "Not a supported variable, it will be sent as written".
Choose the Main language. The agent replies in it by default, and its starter prompt and the platform rules follow it. Switch on Also reply in to add the second language.
Press Save draft. You see "Saved to the draft. It goes live when you publish it on Deploy."
What you cannot change
Under Platform rules you see text that Baseera adds after your prompt on every turn. You cannot edit or remove it. Under Fixed guardrails the page lists what the platform enforces on every agent. They are facts, not settings. The agent will:
- Never share one user's or tenant's data with another.
- Never make a change before the user approves.
- Always cite the source when it uses knowledge.
- Always reply in Arabic when the user writes Arabic.
Write your instructions as the business's rules on top of these. A rule in your prompt cannot switch a guardrail off.
Modes and stored data
- Modes: Chat and Immersive can be on. Queue shows "Coming soon".
- Store tool inputs and results: when off, Baseera keeps only tool names and status after each turn. Turn it on if you want to save real conversations as tests, because a test cannot be built from a turn whose tool data was not stored.
Choose the provider key and model
In the Model section, pick a Provider key. Only active keys of your organization are listed. If the list is empty, press Add a provider key and follow Provider keys.
Pick a Model. Each provider has a short, curated list. Choose Other model id… and type a Model id for any model your key can use.
Optionally set Temperature (0 to 2) and Max output tokens (up to 128,000). Leave them empty to use the provider's defaults.
Press Save draft.
Saving creates a new draft. The next turn after you publish uses it, and turns that are already running finish on the version they started with.
If the key the agent used was removed, the page says "Key removed: choose another" and your app gets a "provider key missing" error until you choose another key and publish. If no model is set, your app gets "agent not configured".
What the agent costs
The Usage (last 7 days) tile on this page shows Model calls, Sessions, Tenants, Input tokens, Output tokens and Estimated cost. The estimate uses list prices. Your provider's bill is the authoritative number.
Set rate limits
Under Rate limits you set how many new messages are accepted per minute:
| Field | Default | Allowed range |
|---|---|---|
| Per user | 20 | 1 to 600 |
| Per agent (all users) | 300 | 1 to 10,000 |
| Per tenant | 100 | 1 to 5,000 |
Leave a field empty to use the default. Replies that continue after a tool runs are not counted. A user who goes over the limit sees "You are sending messages too fast." For monthly caps in money or tokens, see Spending limits.
Style the assistant with a theme
Open Theme in the agent's sidebar.
Use the Editing switch to choose Light or Dark. Every colour has a value for each mode.
Set the Brand colours (Accent, Main action, Text on main action, Card, Card text, Frame, Frame text) and the State colours (Critical, Warning, Info, Success, Draft, Live). Type a plain colour as #RRGGBB, rgb(), hsl() or oklch(), or use the picker. A colour you leave empty keeps the Baseera default.
Choose the Corner radius and the Font: Default, Serif, Rounded or Monospace. These fonts cover Arabic.
Under Logo press Upload a logo to replace the bubble mark. Use a still PNG or WebP exported without metadata. SVG is not accepted.
Press Save theme. You see "Saved to the draft. Publish to send it to your app."
Each colour shows a contrast badge: Readable, Low contrast or Too low to save. Critical and Warning are used as text on the card, so they must reach a 4.5 to 1 ratio against the card before you can save. The others warn but still save. The Sample on the page draws the real assistant with your colours as you edit. Reset to defaults restores the originals.
Your app picks the published theme up without a code change. A theme your app sets in code still wins, field by field.
What can go wrong
| Message | What to do |
|---|---|
| "Check the model: choose an active key, a valid model id, a temperature from 0 to 2 and up to 128,000 output tokens." | Fix the field named in the message. A key removed since you opened the page also causes it. |
| "Rate limits must be whole numbers within the ranges shown." | Use whole numbers inside the ranges in the table. |
| "You can view this agent but not change it." | Your role is Viewer. |
| "These colours need 4.5:1 against the card before you can save: ..." | Darken the named colours, or lighten the card. |
| "The file is larger than ... KB" or "The image must be at most ... pixels." | The logo is limited to 256 KB and 512 by 512 pixels. |
| "Animated images are not accepted." | Export a still image. |