> ## Documentation Index
> Fetch the complete documentation index at: https://agent-docs.magicwebs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up your workspace

> Work through the six setup steps that teach your agents the business: company profile, facts, agents, knowledge base, catalogue and enquiry stages.

The setup checklist walks you through everything your agents need to start answering well. Open it from **Setup** on the dashboard, or go to `/onboarding` in your workspace.

![The setup overview showing 97 percent complete and six step cards](https://mintcdn.com/magicwebs/lXS3DuVdQz1WpiFT/images/console/setup-overview.png?fit=max\&auto=format\&n=lXS3DuVdQz1WpiFT\&q=85\&s=5b2818bc7a3b4d6e9cc2b4e65040c75b)

The dial shows your overall progress. Each card shows one step, how complete it is, and the next thing missing. Nothing here blocks the rest of the console: you can reopen and change any step at any time, and agents read the new version on their very next reply.

## The six steps

**1. Company profile**

**Needed:** company name, what the company does (two or three sentences; this is the most-read line in the whole setup), industry, a phone number or email, and currency, timezone and locale.

**Optional:** tagline, website, address, and what the agents should call you.

**2. Company facts**

Short, specific lines every agent may state, such as opening hours, delivery areas, payment terms or booking amounts. One-tap topics are offered: Opening hours, Delivery, Payment terms, Lead time, Returns policy, Service area, Minimum order, Warranty.

> [!WARNING]
>
> Saving replaces the whole list. A fact you remove is gone for every agent.

**3. Agents**

Create at least one agent and take it live. Your first agent brings the front desk and the follow-up desk with it; there is nothing to set up for either. Every agent needs a **"Hand over to me when…"** line, or the front desk will never send it a conversation.

![The Agents step with the front desk, follow-up desk and three specialists](https://mintcdn.com/magicwebs/Y5otz65o1vDClhV_/images/console/onboarding-step-agents.png?fit=max\&auto=format\&n=Y5otz65o1vDClhV_\&q=85\&s=f488fbff900e1ace94d9dccac1cebc36)

**4. Knowledge base**

Add at least one source and wait until it shows **searchable**. Three or more sources is better. See [Knowledge base](https://agent-docs.magicwebs.ai/build/knowledge-base.md).

**5. Catalogue**

Add at least one product or service, each with a description. Store a price wherever you want agents to quote one. See [Catalogue](https://agent-docs.magicwebs.ai/build/catalogue.md).

**6. Enquiry stages**

Build the lead pipeline the follow-up desk files conversations into. Start with **Use the standard pipeline** (New enquiry, Qualified, Details collected, Quoted, Negotiating, Won, Lost) and adjust it. You need a **won** and a **lost** stage; otherwise customers who have already bought keep being chased.

![The Enquiry stages step with the pipeline list](https://mintcdn.com/magicwebs/Y5otz65o1vDClhV_/images/console/onboarding-step-stages.png?fit=max\&auto=format\&n=Y5otz65o1vDClhV_\&q=85\&s=ac052d57c3a57a28568f804dc6ecf3d3)

## How the percentage works

Each step's percentage is the share of its checks that are met; the overall dial is the average of the six steps. A step shows **Ready** once all its required checks are met. Optional checks only move the percentage.

> [!TIP]
>
> After setup, open the [playground](https://agent-docs.magicwebs.ai/build/playground.md) and chat with your front desk the way a customer would. It's the quickest way to find gaps before customers do.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.