# Knowledge Base Search Tool

The **Knowledge Base (KB) Search Tool** allows your Agent to query structured repositories of documents, FAQs, guides, or policies that you create inside **Zaia Endless**. It is the most efficient way to ensure your Agent always has access to updated, reliable information without overloading the main prompt.

***

### 🔎 What is a Knowledge Base?

A **Knowledge Base** in Endless is a container where you upload or create information such as:

* Company policies and procedures
* Product documentation
* Pricing tables or plan descriptions
* Frequently Asked Questions (FAQs)
* Training or onboarding guides

The KB is **not free text** like the Agent prompt. Instead, it is structured, allowing for faster, more accurate searches when the Agent needs specific details.

***

### ⚙️ How the Tool Works

* The **description field** is essential: the Agent decides to use the KB Search Tool based on this description. Write it clearly and specify what type of information the Agent should retrieve.
* You must link the tool to an existing Knowledge Base by providing its **ID**.
* If no KB exists, you can create one directly from the tool configuration.

Once active:

1. The Agent checks if the question matches the KB’s scope.
2. If yes, it retrieves the most relevant entries.
3. The response is integrated into the Agent’s final answer.

***

### 📐 When to Use a Knowledge Base

* If the information will **change frequently**, e.g., updated pricing, policies, or technical docs.
* If the Agent needs **structured retrieval** rather than static memory.

> ✨ Tip: Keep evergreen, stable knowledge (like tone, role, or simple rules) in the main prompt, and use KBs for dynamic or long documents.

***

### 🛠️ Setup Example

**Scenario**: You want your Agent to answer questions about your SaaS pricing.

1. **Create a Knowledge Base**
   * Name: *Pricing and Plans*
   * Upload a document or FAQ with details of all plans and prices.
2. **Add the KB Search Tool**
   * **Description**: “Use this tool when the user asks about prices, plans, upgrades, or billing policies.”
   * **Knowledge Base ID**: *Pricing and Plans*
3. **Result**
   * If a customer asks: *“What’s included in the Pro Plan?”*, the Agent queries the KB and responds with up-to-date information.

***

### ✅ Best Practices

* Write a **clear, action-oriented description** so the Agent knows exactly when to use the KB.
* Keep content **well-structured**: use headings, bullet points, and FAQs.
* Update KBs regularly so your Agent never provides outdated information.
* Avoid redundancy: don’t duplicate the same text in both the prompt and the KB.
