# Build your first agent

> A 5-minute walkthrough — paste your website, let Owlish discover your brand, attach a couple of sources, and chat with the agent.

import Screenshot from "../../../components/docs/Screenshot.astro";

By the end of this walkthrough you'll have a working agent grounded in your own content, ready to drop on your site. The new-agent wizard does most of the heavy lifting — paste a URL, pick what kind of agent you want, and Owlish discovers your brand and primes the knowledge base for you.

You'll need:

- An Owlish account. New accounts start on a free trial.
- A website you own (or can crawl) for the agent's first knowledge source.

## Step 1 — Paste your website and pick a use case

Sign in at [console.owlish.bot](https://console.owlish.bot). The first time you log in, Owlish creates your workspace and drops you on the new-agent wizard. Step 1 asks for two things:

- The **URL** of the website the agent should learn from.
- A **use case** — Customer Support, Sales, Internal Helpdesk, etc. The use case applies a sensible bundle of defaults so you don't start from a blank canvas.

<Screenshot src="/screenshots/agents-01-create-agent-start.webp" alt="New agent wizard asking for a website URL and use case." label="Console · New agent · Step 1 (URL + use case)" description="The wizard's first step asking for a website URL and use-case picker." />

## Step 2 — Discovery

While you wait a few seconds, Owlish fetches the site and pulls out a starter pack: brand metadata, a logo, a primary color, and a list of internal links it could ingest. You don't have to do anything here — the wizard auto-advances when discovery finishes.

## Step 3 — Sources

Step 3 lets you confirm or extend the knowledge base before the agent is created. Three source types:

- **File** — upload PDFs, DOCX, etc.
- **Website** — the URL from Step 1 is already added; you can add more.
- **Direct Response** — paste a question and a canonical answer. Best for FAQ-style content that doesn't live anywhere else yet.

You don't have to add anything here; the website from Step 1 is enough to get started. You can come back to the [Knowledge Base](/docs/knowledge-base/overview) any time.

## Step 4 — Review

Confirm the basics: **agent name** (defaults from the discovered brand), **logo** (auto-fetched, replaceable), and **primary color** (auto-detected from the site). These are starting values — you can change all of them later from the agent's Brand tab.

<Screenshot src="/screenshots/agents-04-create-agent-review.webp" alt="New agent review step with agent name, logo, primary color, and create button." label="Console · New agent · Step 4 (Review)" description="Review step with agent name, logo, and primary color, plus a Create button." />

Click **Create**.

## Step 5 — You're in the Playground

Owlish drops you on the agent's page, which is structured as a Playground — a live chat with the agent on one side and four configuration tabs on the other:

- **Content** — what the visitor sees: greetings, suggested questions, prechat form, message placeholder.
- **Brand** — theme, profile picture, launcher icon and color, button label.
- **Behavior** — toggles like prechat enable/require, stream responses, attachments, feedback collection.
- **Model** — model picker, temperature, and the **Instructions** field (the agent's system prompt / persona).

<Screenshot src="/screenshots/agents-05-playground.webp" alt="Agent playground with configuration tabs and a live widget preview." label="Console · Playground" description="The agent's Playground page with a live chat on the right and Content/Brand/Behavior/Model tabs on the left." />

Try a few questions in the chat panel. Pay attention to whether answers cite a source (every grounded answer should), whether the tone matches what you'd want, and whether the agent refuses cleanly when it doesn't know. To shape the tone or restrict scope, edit the **Instructions** on the Model tab.

## Step 6 — Deploy across channels

Knowledge, branding, and channels live on separate pages, accessible from the agent's sidebar:

- **Knowledge Base** — `/workbench/knowledge-base/sources`. Add or sync sources here.
- **Channels** — `/workbench/agents/[agent]/channels`. Connect the web widget, configure allowed domains, and connect the supported chat or messaging channels for your plan.

Open **Channels** and configure the **Web widget** first — it's included in every plan and gives you the embed snippet for your site. Slack, Microsoft Teams, and Google Chat are available on Growth and above; WhatsApp, Messenger, and Telegram are available on Scale.

## What's next

You have a working agent. From here, the most common next steps are:

- **[Customize the widget](/docs/deploy/widget-customization)** — most of this is on the agent's Content / Brand / Behavior tabs.
- **[Add more knowledge](/docs/knowledge-base/overview)** — beyond the auto-crawled site.
- **[Connect Slack](/docs/deploy/slack)** or Microsoft Teams for an internal channel (paid plan).
- **[Set up human handoff](/docs/helpdesk/human-handoff)** so an operator can step in.
- **[Invite a teammate](/docs/settings/members)** to share the workspace.

---

Source: https://owlish.bot/docs/quick-start/build-your-first-agent