---
title: "Knowledge"
space: "Framework"
url: "https://docs.frappe.io/framework/flow/knowledge"
updated: "2026-11-18"
---

A knowledge base is content an agent can search: help articles, policies, closed tickets. Use one when the content is too long to fit in the agent's instructions.

The quickest way to create one is to attach the files to a chat and ask Flow for an agent that uses them. The rest of this page covers doing it by hand.

## Set an embedding model

Flow needs an embedding model to search text by meaning. You set it once for the site.

1. Under **Settings** &gt; **Models**, add an embedding model such as `openai/text-embedding-3-small`.
2. Under **Settings** &gt; **Knowledge** &gt; **Settings**, choose it as the **Embedding Model**.

## Create a knowledge base

1. Go to **Settings** &gt; **Knowledge** and click **New knowledge base**.
2. Write a **Description**. The agent reads it to decide when to search.
3. Add one or more sources.
4. Open the agent and add the knowledge base under **Knowledge Bases**.

| Source  | What Flow indexes                                                                                         |
| ------- | --------------------------------------------------------------------------------------------------------- |
| Text    | Text you paste in.                                                                                        |
| File    | A PDF, Word, Excel, text or image file.                                                                   |
| URL     | A public web page of up to 10 MB. Enter the final address, because Flow doesn't follow redirects.         |
| DocType | The records of a DocType, such as closed tickets. Turn on **Auto Sync** to pick up new records every day. |


:::caution
Anyone who can use the agent can read its knowledge bases, whatever their own permissions. Don't add records those users shouldn't see.
:::