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

# Build your first AI agent — Agenvik quick start

> Go from sign-up to a live Agenvik agent in under 30 minutes. Upload knowledge, train, tune behaviour, and embed on your website.

This guide takes you through the first setup flow: create an Agent, add Knowledge Sources, train it, tune Behaviour, and prepare a Channel.

## What you will learn

* How to create a new Agent from the dashboard
* How to add Text and Q\&A Knowledge Sources
* How to start training and test the result
* How to prepare the Web Channel for launch

## Before you start

Sign in to the Agenvik dashboard and open **Agents** from the sidebar. If your workspace has reached its active agent limit, archive an unused agent or review your subscription before creating another one.

<Frame>
  <img src="https://mintcdn.com/arokart/bVqC9z00iBm9fRgB/images/product-ss/agents-list.png?fit=max&auto=format&n=bVqC9z00iBm9fRgB&q=85&s=40d6e3ae614e3587df2d9f26532ae1a2" alt="Agenvik agents list placeholder" width="1512" height="943" data-path="images/product-ss/agents-list.png" />
</Frame>

## Step 1: Create an Agent

1. Open **Agents**.
2. Click the create button in the page header.
3. Enter a clear agent name, such as `Sales Support Agent` or `Product FAQ Agent`.
4. Save the Agent.

<Frame>
  <img src="https://mintcdn.com/arokart/bVqC9z00iBm9fRgB/images/product-ss/create-agent-dialog.png?fit=max&auto=format&n=bVqC9z00iBm9fRgB&q=85&s=57a2d64cf8d0be1c7f326b42c733b474" alt="Create agent dialog placeholder" width="1512" height="943" data-path="images/product-ss/create-agent-dialog.png" />
</Frame>

Use one Agent per distinct use case. This keeps knowledge, behaviour, and analytics easier to understand later.{/* LEAD_GENERATION_DISABLED: original text included "leads," — restore when re-enabling */}

## Step 2: Add Knowledge Sources

Open the Agent and find **Knowledge Sources**. Agenvik supports:

* **Text**: free-form content, policies, instructions, product notes, or FAQs written as rich text.
* **Q\&A**: structured question-and-answer pairs for exact responses and common customer questions.
* **PDF**: upload a PDF document and Agenvik indexes the full content automatically.
* **Website URL**: paste a URL and Agenvik reads and indexes the page (Starter and above).

Click **Add**, choose the source type, and follow the prompts to save the content.

<Frame>
  <img src="https://mintcdn.com/arokart/bVqC9z00iBm9fRgB/images/product-ss/knowledge-sources-empty.png?fit=max&auto=format&n=bVqC9z00iBm9fRgB&q=85&s=d9bb777f4c6cb0e845262332376d8c64" alt="Empty knowledge sources placeholder" width="1512" height="943" data-path="images/product-ss/knowledge-sources-empty.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/arokart/bVqC9z00iBm9fRgB/images/product-ss/add-text-source.png?fit=max&auto=format&n=bVqC9z00iBm9fRgB&q=85&s=f5fc7fe0fb74a7ab5be49b53d5a5d290" alt="Add text source placeholder" width="1512" height="943" data-path="images/product-ss/add-text-source.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/arokart/bVqC9z00iBm9fRgB/images/product-ss/add-qa-source.png?fit=max&auto=format&n=bVqC9z00iBm9fRgB&q=85&s=de1f8f559da44af5144eea1de5fbe2aa" alt="Add Q&A source placeholder" width="1512" height="943" data-path="images/product-ss/add-qa-source.png" />
</Frame>

## Step 3: Train the Agent

After at least one Knowledge Source is ready, click **Train**. Agenvik queues ready sources and indexes them for the Agent.

<Frame>
  <img src="https://mintcdn.com/arokart/bVqC9z00iBm9fRgB/images/product-ss/train-agent-dialog.png?fit=max&auto=format&n=bVqC9z00iBm9fRgB&q=85&s=5e75a7e04296ac17b55e56433bb3a4d0" alt="Train agent dialog placeholder" width="1512" height="943" data-path="images/product-ss/train-agent-dialog.png" />
</Frame>

Training uses your plan's daily training limit. If the button is disabled, check whether the Agent is locked, whether any sources are ready, or whether today's training runs are already used.

## Step 4: Tune Behaviour

Use **Behaviour** to define how the Agent should answer.

* **System Prompt**: the Agent's role and core instructions
* **Tone**: friendly, professional, or neutral
* **Verbosity**: short, balanced, or detailed
* **Fallback Message**: what the Agent says when it cannot answer
* **Guardrails**: boundaries for topics, claims, or escalation rules

<Frame>
  <img src="https://mintcdn.com/arokart/bVqC9z00iBm9fRgB/images/product-ss/behaviour-settings.png?fit=max&auto=format&n=bVqC9z00iBm9fRgB&q=85&s=f13da6260b048a89f14e0e14d0354e8d" alt="Behaviour settings placeholder" width="1512" height="943" data-path="images/product-ss/behaviour-settings.png" />
</Frame>

## Step 5: Configure the Web Channel

Use **Channel** to control the web chat experience. Set the display name, subtitle, welcome message, input placeholder, and primary color.

<Frame>
  <img src="https://mintcdn.com/arokart/bVqC9z00iBm9fRgB/images/product-ss/web-channel-settings.png?fit=max&auto=format&n=bVqC9z00iBm9fRgB&q=85&s=6e3afb8cd4831dc0bf0498aa5a4dd16b" alt="Web channel settings placeholder" width="1512" height="943" data-path="images/product-ss/web-channel-settings.png" />
</Frame>

The preview on the right side of the Agent page helps you check the greeting, color, and input text before launch.

## Step 6: Review the Agent

Before you share the Agent, ask test questions that reflect real visitors:

* A simple question directly covered by a Knowledge Source
* A question with multiple possible meanings
* A question outside your business scope
  {/* - A lead-intent question, if Lead Generation is enabled */}{/* LEAD_GENERATION_DISABLED: uncomment to restore */}

## Next steps

<CardGroup cols={2}>
  <Card title="Improve answer quality" icon="sparkles" href="/user-guides/quick-start/best-practices">
    Learn practical ways to improve knowledge, behaviour, and testing.
  </Card>

  <Card title="Install the web widget" icon="code" href="/developer-guide/install-web-widget">
    Add the Agent to your website once it is ready for visitors.
  </Card>
</CardGroup>
