> ## 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.

# AI agent best practices — Agenvik

> Improve your Agenvik agent's accuracy: structure knowledge sources, write clear system prompts, test before launch, and monitor conversations for gaps.

Use this page as a checklist when an Agent is not answering the way you expect, or when you want to prepare a polished launch.

## What you will learn

* How to make Knowledge Sources easier for the Agent to use
* How to write Behaviour settings that create consistent answers
* How to test before launch
* How to use Conversations and Analytics after launch

## Make Knowledge Sources specific

Agents work best when your source content is explicit. Avoid vague statements that require guessing.

<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="Well structured text source placeholder" width="1512" height="943" data-path="images/product-ss/add-text-source.png" />
</Frame>

Strong source content usually includes:

* Clear product names, plan names, and feature names
* Exact steps customers should follow
* Known limitations and eligibility rules
* Links written as plain visible URLs when the Agent should share them
* Separate sections for pricing, support, setup, and troubleshooting

## Use Q\&A for critical answers

Use **Q\&A** when a question needs a precise, repeatable answer. This is useful for refunds, pricing rules, handoff rules, business hours, and compliance-sensitive responses.

<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="Q&A source best practice placeholder" width="1512" height="943" data-path="images/product-ss/add-qa-source.png" />
</Frame>

Keep each Q\&A focused. If one answer covers several topics, split it into multiple entries.

## Write Behaviour like an operating guide

The **System Prompt** should explain the Agent's job, audience, and boundaries. The **Guardrails** field should cover things the Agent must avoid or escalate.

<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 best practices placeholder" width="1512" height="943" data-path="images/product-ss/behaviour-settings.png" />
</Frame>

A strong Behaviour setup includes:

* Who the Agent helps
* What the Agent can answer
* When the Agent should say it does not know
* How it should ask for missing context
* When it should direct the visitor to support{/* LEAD_GENERATION_DISABLED: original text was "collect a lead or direct the visitor to support" — restore when re-enabling */}

## Choose tone and verbosity intentionally

Use **Friendly** for conversational support, **Professional** for sales or B2B workflows, and **Neutral** for factual help centers. Use **Short** for fast FAQ answers, **Balanced** for general support, and **Detailed** for technical or process-heavy guidance.

## Test with real customer questions

Before launch, test the Agent with questions from actual conversations, support tickets, sales calls, or website search terms.

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

Test for:

* Accuracy: the answer matches your source content
* Completeness: the visitor gets the next step
* Boundaries: the Agent avoids unsupported claims
* Tone: the response fits your brand
* Recovery: the fallback message is helpful

## Monitor after launch

Use **Conversations** to inspect individual threads and **Analytics** to find patterns across many interactions.

<Frame>
  <img src="https://mintcdn.com/arokart/bVqC9z00iBm9fRgB/images/product-ss/conversation-inbox.png?fit=max&auto=format&n=bVqC9z00iBm9fRgB&q=85&s=4d00494f65c61f36529eaadb5a6b881f" alt="Conversation review placeholder" width="1512" height="943" data-path="images/product-ss/conversation-inbox.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/arokart/bVqC9z00iBm9fRgB/images/product-ss/analytics-dashboard.png?fit=max&auto=format&n=bVqC9z00iBm9fRgB&q=85&s=51332b72ececea88ea7168c1385445e0" alt="Analytics dashboard placeholder" width="3024" height="2806" data-path="images/product-ss/analytics-dashboard.png" />
</Frame>

Turn repeated weak answers into better Text sources, Q\&A entries, or Behaviour instructions.

## Next steps

<CardGroup cols={2}>
  <Card title="Knowledge Sources" icon="folder" href="/user-guides/agents/knowledge-sources">
    Learn how to add, edit, delete, and train sources.
  </Card>

  <Card title="Conversations" icon="message-circle" href="/user-guides/inbox/conversations">
    Review live conversations and identify content gaps.
  </Card>
</CardGroup>
