# Creating a Knowledge Base

Creating a Knowledge Base in Zaia Endless is a straightforward process.\
Each base can hold multiple items and serve as a reusable knowledge layer for different Agents or Squads.

***

### 🪄 Step 1 — Open the Knowledge Module

1. Navigate to **Builder → Agents → \[Select your Agent] → Knowledge**
2. Click **New Knowledge Base +** in the top-right corner.

***

### 🧠 Step 2 — Define the Base

In the **Add Knowledge Base** window:

* **Name:** Choose a clear and descriptive title (e.g. *Support FAQs*, *Internal Docs*, *Sales Playbook*).
* **Description (optional):** Add internal notes for organization or context.

Click **Create Knowledge Base** to finalize.

Your new base will now appear in the list.

***

### 📚 Step 3 — Add Items

Each Knowledge Base can contain multiple items, which are the actual content sources.

Click **Add Item +**, then select one of the following:

#### 📝 Text

* Ideal for FAQs, structured guides, or internal definitions.
* Paste up to **1,000,000 characters** of content.
* Click **Update** to save and start training.

#### 📄 PDF

* Upload a `.pdf` file from your computer.
* The platform will automatically extract, process, and index the text content.
* Click **Add** to confirm.

***

### 🔄 Step 4 — Training & Status

After adding content, the system automatically begins **training** — converting text into vector embeddings for retrieval.

| Status         | Description                                |
| -------------- | ------------------------------------------ |
| **Pending**    | Waiting to start training.                 |
| **Processing** | Data is being analyzed and embedded.       |
| **Completed**  | Training finished successfully.            |
| **Failed**     | An issue occurred; edit or retry the item. |

You can hover over the **Status** indicator to view detailed information.

***

### 🧩 Step 5 — Update or Manage

At any time:

* Click the **Edit (✏️)** button to rename or update the base description.
* Click the **⋮** menu beside an item to edit, delete, or retrain it.
* Adding new items will automatically trigger training again.

***

### 💡 Tip

Keep content concise, clean, and well-structured.\
Use consistent headings and avoid redundant data to improve embedding quality and retrieval precision.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zaia.app/knowledge-bases/creating-a-knowledge-base.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.