Setup

The Setup screen is a quick workspace for the most common settings of your agent, with a live chat beside it so you can try every change straight away. Found in the agent sidebar under Home β†’ Setup.

The screen has two panels: Configuration on the left and Chat on the right. On a narrow screen only one panel shows at a time; switch with the Configuration and Chat buttons at the top.

Depending on your workspace, Setup opens in one of two ways. Both have the same Configuration panel:

  • As a full page, without the agent sidebar. It then has its own top bar and the chat panel has extra buttons (see below).
  • Inside the normal CMS layout, with the agent sidebar on the left. The chat panel then has only the reload button.

Top Bar

Shown only when Setup opens as a full page.

Home (house icon)Goes to the Dashboard.
OrganizationsOpens the Organizations page: your organizations and their agents.
User menuYour account menu, with sign-out.

Agent Card

Agent type chipThe kind of agent chosen when it was created, for example Customer Support, Data Analytics or Custom Solution. The type decides the order of the feature cards below and the wording of their descriptions.
Avatar, name and missionThe agent's avatar, name and mission, as set under Persona.
Organization chipThe organization that owns the agent, when it belongs to one.
Edit (pencil icon)Opens Edit Agent Information, with three tabs: Profile, Behavior and Introduction. They hold the same fields as Persona β†’ Profile, Persona β†’ Behavior and Conversation β†’ Introduction. Click Save to apply; it is disabled while an image is still uploading.

Recently Added Resources

Recently Added ResourcesShown once the agent has knowledge resources. Click the header to expand or collapse the list. Each row shows the resource type and title, with an icon and label for its processing status (for example Active, Processing or Failed).
Resource titleOpens the processing log of that resource.
Processing documentsA card above the list, shown while an uploaded document is processing or after one failed: "Processing documents Β· n of m done", a progress bar, and each document's state (Ready once the agent can use it). The page refreshes every 5 seconds while a document is processing. A failed document has Try again; the note under the card says to make sure the computer is online when documents are read with a subscription.

After Create your first agent

Right after the Create your first agent flow, Setup shows extra notes above the cards.

Model noteWhen the agent uses your subscription or API key, for example "Tim uses your ChatGPT subscription for chat and documents. Document search and logos use Qlar." AI Models opens the organization's Tasks tab.
Connect a subscriptionWhen you started connecting a subscription but finished on Qlar credit: "Your agent uses Qlar credit for now. Connect your Claude or ChatGPT subscription to chat without spending credit." The link opens the Sources tab.
Needs a lookOne line for each step the flow couldn't finish, for example "Your data wasn't connected. Open the SQL Database card below to connect it."
TourFour short steps, once per agent in this browser: the documents being processed (only when documents were added), the preview, drafts and Publish, and resources that apply right away. Skip ends it.

Feature Cards

Each card has a title, a short description and an action label. Most cards open a panel beside Setup; two go to another page. Each panel has a link at the top to the full page of the same feature. Closing a panel with unsaved changes asks you to discard them first. The descriptions differ per agent type, the titles do not.

ResourcesManage Resources. Opens Add training resources, where you add several documents and videos at once. See Knowledge β†’ Documents.
Resources PermissionsManage Permissions. Opens a panel for the permission codes that restrict who may see sensitive resources. See Users β†’ Permissions.
Custom APIConnect API. Opens a panel to set up API integrations the agent can call. See Tools β†’ Custom API.
Web ScrapingConfigure Scraping. Goes to Tools β†’ Web Scraping. Shown only for the Custom Solution agent type.
Chat FormManage Chat Form. Opens a panel to add and configure chat forms, which turn data collection into a conversation. See Tools β†’ Plugins.
WhatsApp IntegrationOpen WhatsApp Setup. Opens WhatsApp integration setup. A chip in the corner shows Configured or Not Set. See Channels β†’ WhatsApp.
SQL Database ReaderConnect Database. Opens a panel to add database connections the agent can query. See Tools β†’ Plugins.
Create & Run SimulationsStart a Simulation. Goes to Simulation β†’ Scenarios.
Other AgentsManage Agents. Opens a panel to connect other agents that this agent can delegate to. See Tools β†’ Other Agents.
Agent KeysManage Keys. Opens a panel to create keys that let other agents connect to this one. See Channels β†’ Agent Keys.

Chat Panel

The chat panel runs your agent so you can test it as you configure.

Reload (circular arrow)Restarts the chat in the panel with a new conversation.
PreviewFull page only. Opens the draft version of the agent (your latest saved changes) in a new browser tab.
PublishFull page only, and only while the agent has unpublished changes. Publishes the draft so users get your latest changes. Shows Publishing... while it runs.
ViewFull page only. Opens the published version of the agent in a new browser tab.
ShareFull page only. Shares the agent's chat link, or copies it to the clipboard.

Related guide: Setup and Publish