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

# Companion setup guide

> Follow the three-step setup guide in Companion to train your AI agent, take it live and bring in your team. Use it to set up a new organization.

The setup guide is a three-step path that Companion walks a new organization through: train the AI agent on your business, take it live on your channels, then bring in your team. Use it as the guided alternative to the [Quickstart](https://docs.open.cx/quickstart.md), with Companion doing the work in a chat.

> [!NOTE]
>
> The guide appears in your [OpenCX dashboard](https://platform.open.cx/companion) until all three steps are done or skipped. Starting a step requires the **Companion** Write permission, and each change Companion makes needs the matching permission, such as **AI knowledge base** Write for instructions.

## Where to find the guide

* **Companion page:** a **Get started** card below the composer, with your progress such as **1/3**.
* **Inside a chat:** a **Setup** button with a progress ring at the bottom right opens the guide as a **Setup** tab, headed **Setup your workspace**. See [Workspace tabs](https://docs.open.cx/companion/workspace-tabs.md).
* **Inbox:** with no session selected, the inbox shows **Get your AI agent live** with the same steps.

Progress belongs to the organization, so every teammate sees the same steps checked.

## The three steps

| Step | What it covers | Done when |
| - | - | - |
| **Discover & Train** · 15 min | Map your business, build AI knowledge, create instructions | An instruction is published. The checklist also shows **AI profile published**. |
| **Go Live** · 10 min | Configure channels, connect helpdesk, launch your AI | Your workspace has its first session (**First conversation received**). |
| **Grow** · 5 min | Add your team, optimize, expand to new channels | Your organization has a second member (**Teammate invited**). |

The times are estimates shown in the guide.

> [accordion] Discover & Train
>
> Companion asks for your website if you haven't added one, adds it as a knowledge source and reads your key pages, such as FAQ, pricing and policies. It then sends one set of questions: your goal, the top things customers ask, whether the AI needs to take actions, your helpdesk, the channels to launch on, and how the agent should sound (tone, languages, name, greeting and topics that must always go to a person).
>
> From your answers it proposes a plan and waits for your go-ahead. Then it writes and publishes the AI Profile, creates an instruction for each top question, sets up actions if you need them, and runs three test conversations: a common question, a frustrated customer who should be handed off, and an off-topic question. Test sessions get a test tag so you can filter them out.

> [accordion] Go Live
>
> Companion plans only the channels you chose. It asks once before turning on [Autopilot](https://docs.open.cx/safety/autopilot-settings.md) for them, since the AI then answers real customers. It walks you through email, creates a phone agent for voice, and helps connect your helpdesk. It can't change the website widget's settings, so it tells you what to set and links you to the page. It then runs a test conversation on each channel and fixes what fails.

> [accordion] Grow
>
> Companion helps you invite teammates, suggests routing based on your team, reviews how the AI is doing and where it lacks knowledge, and plans your next channel.

> [!NOTE]
>
> Any session counts toward **Go Live**, including the test conversations from **Discover & Train**. A checked step doesn't mean Autopilot is on: check your channels before you rely on it.

## Run a step

**1. Start the current step**

Select **Start** on the first unfinished step, on the **Get started** card or in the inbox. It reads **Continue** once part of the step is done. Later steps stay dimmed until the earlier ones are finished.

**2. Send the request**

The step's request fills the composer. Add anything Companion should know, then send it.

**3. Answer and approve**

Answer Companion's questions and review its plan. Nothing changes until you give the go-ahead.

**4. Follow the progress**

The bar above the composer shows each task as Companion works. When it finishes, Companion marks the step done and moves to the next one.

## How steps get checked

* **From your workspace:** each step is checked as soon as its condition in the table above is met, even if you did the work yourself outside Companion.
* **By Companion:** it marks a step complete when it finishes the step's tasks.
* **By you:** select **Mark done** on a step in the **Setup** tab.
* **Skip:** tell Companion "skip" or "not now" during a step. A skipped step counts as done.

## Close the guide or come back to it

The ✕ in the **Setup** tab closes the tab, not the guide. Come back through the **Setup** button in any chat, the **Get started** card, or the inbox.

The guide disappears once every step is done or skipped. To retire it early, ask Companion to skip the remaining steps.

***

## Related Documentation

> [card] [Quickstart](https://docs.open.cx/quickstart.md)
>
> Set up a live agent by hand.

> [card] [Companion introduction](https://docs.open.cx/companion/introduction.md)
>
> What Companion can do for you.

> [card] [Workspace tabs](https://docs.open.cx/companion/workspace-tabs.md)
>
> Review drafts and tests beside the chat.

> [card] [AI Instructions](https://docs.open.cx/ai-instructions/overview.md)
>
> Instructions and the AI Profile.


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