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

# Train your AI agent with custom knowledge

> Learn how to train your BluBash AI agent using text, documents, and web links so it can answer questions accurately based on your business information.

Training is the most important step in making your AI agent perform effectively. Through training, you teach the agent about your business, products, services, and how to interact with your customers. The more thorough and specific your training, the more accurate and useful the agent's responses will be.

## Why training matters

* **Business-specific knowledge** — The agent learns about your company and what you offer.
* **Accurate responses** — Better training leads to more reliable answers.
* **Proper context** — The agent understands the scope of your business.
* **Fewer errors** — Reduces the chance of incorrect or irrelevant replies.

## How to access training

<Steps>
  <Step title="Open AI Agents">
    In the left sidebar, click **AI Agents**.
  </Step>

  <Step title="Select your agent">
    Click on the agent you want to train.
  </Step>

  <Step title="Open the Training tab">
    Click the **Training** tab at the top of the page.
  </Step>
</Steps>

## Training methods

### Text training

Add instructions and information in plain text format. This is best for concise, specific guidance.

**When to use text training:**

* Behavioral instructions
* Short, objective information
* Customer service guidelines
* Answers to frequently asked questions

**How to add text training:**

<Steps>
  <Step title="Click the Text tab">
    Select the **Text** tab in the training section.
  </Step>

  <Step title="Enter your content">
    Type the training content in the text field.
  </Step>

  <Step title="Save the training">
    Click **Add Training** to save.
  </Step>
</Steps>

**Examples:**

```
Start every conversation by introducing yourself and asking how you can help the customer.
```

```
When a customer asks about pricing, let them know our plans start at $99/month.
```

```
If a customer asks to speak with a human, immediately transfer them to the support team.
```

<Tip>
  Use short, objective sentences. Avoid redundancy, be specific in your instructions, and use practical examples whenever possible.
</Tip>

***

### Document training

Upload files with detailed information about your company. This is ideal for longer, structured content.

**When to use document training:**

* Product manuals
* Company policies
* Catalogs
* Technical documentation
* Extensive FAQs

**Accepted formats:**

* PDF (`.pdf`)
* Word (`.doc`, `.docx`)
* Plain text (`.txt`)
* Markdown (`.md`)
* Spreadsheets (`.xlsx`, `.csv`)

**How to add document training:**

<Steps>
  <Step title="Click the Document tab">
    Select the **Document** tab in the training section.
  </Step>

  <Step title="Select a file">
    Click **Select Document** and choose the file from your computer.
  </Step>

  <Step title="Wait for processing">
    The document will be processed automatically. Processing time depends on file size.
  </Step>
</Steps>

<Info>
  Document processing may take a few minutes for larger files. You will receive a notification when the training is complete.
</Info>

***

### Web training

Add URLs from your website so the agent can learn from your published content.

**When to use web training:**

* Product pages
* Blog posts
* About pages
* Help centers
* Landing pages

**How to add web training:**

<Steps>
  <Step title="Click the Web tab">
    Select the **Web** tab in the training section.
  </Step>

  <Step title="Paste the URL">
    Enter the page URL in the field provided.
  </Step>

  <Step title="Add the training">
    Click **Add Training** to save.
  </Step>
</Steps>

<Warning>
  Make sure the pages you link to are publicly accessible. Pages protected by a login cannot be processed.
</Warning>

## Managing your training entries

**View training entries:** All added training items appear in organized lists by type. Each entry shows its current status: Processing, Trained, or Failed.

**Delete a training entry:**

1. Find the entry in the list.
2. Click the trash icon.
3. Confirm the deletion.

<Warning>
  Deleting a training entry is permanent and may affect the agent's knowledge base. Make sure you want to remove it before confirming.
</Warning>

## Best practices

1. **Start with the basics** — Add core company information, main products and services, and contact details or business hours.
2. **Be specific** — Use concrete examples, detailed descriptions, and avoid ambiguity.
3. **Keep it up to date** — Add new products and services as they launch, update pricing and promotions, and remove outdated information.
4. **Test after each addition** — Run the agent test after adding new training to verify the responses are correct.
5. **Organize by topic** — Use documents for long-form content and text entries for quick instructions.

## Important notes

* The agent learns from **all** training entries you provide.
* More recently added training takes priority over older entries.
* Document and link processing can take a few minutes.
* There is no limit to how many training entries you can add.
* It is recommended to test the agent after each new training addition.