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

# AI Knowledge Base

The Knowledge page lets your AI Agent learn from documents, web pages, and question-and-answer pairs. You can also upload attachments that the AI Agent can send to users without learning from or splitting the file.

<Note>
  Knowledge is shared by all versions of the AI Agent and updates in real time.
</Note>

## Add knowledge

1. Open your AI Agent and select **Knowledge**.
2. Click **Add knowledge**.
3. Select one of the following knowledge types, then click **Next**:
   * **Document**: The AI Agent parses, chunks, and indexes the file so it can answer questions from the content.
   * **Online data**: The AI Agent crawls web pages and uses the retrieved content as a knowledge source.
   * **Q\&A**: The AI Agent follows a prepared answer for predictable questions.
   * **Attachment**: The AI Agent sends the original file when appropriate. It does not learn from or split the file.
4. Complete the setup for the selected type.

<Frame caption="Select Add knowledge to choose a document, website, Q&A pair, or attachment.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-knowledge-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=13fb54ebe5a0d887655629b635facaa0" alt="Knowledge list with Add knowledge highlighted." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-knowledge-annotated.svg" />
</Frame>

## Add a document

1. Select **Document**, then click **Next**.
2. Drag a file into the upload area or click **Upload** to choose a file.
3. After the file finishes uploading, click **Create**.

<Frame caption="Choose Upload or drag a supported document into the upload area.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-knowledge-document-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=0f54e9140b1223c392d2e92983dd8a2b" alt="Add documents dialog with the Upload button highlighted." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-knowledge-document-annotated.svg" />
</Frame>

The maximum file size is 15 MB. Supported formats are:

* TXT, MD, MARKDOWN
* PDF
* HTML, HTM
* XLSX, XLS, CSV
* DOC, DOCX

The AI Agent can recognize text in images embedded in PDF files. Images embedded in other document formats are not supported.

## Add online data

1. Select **Online data**, then click **Next**.
2. Under **Crawl Depth**, choose:
   * **Only this URL** to crawl only the URL you enter.
   * **Include subpages** to crawl the URL and its subpages.
3. Under **Update Frequency**, choose **Do Not Auto-Update**, **Update every 3 days**, **Update every 7 days**, or **Update every 30 days**.
4. Enter the website URL. To add more URLs in the same operation, click **Add more**.
5. Click **Create** to start crawling.

<Frame caption="Set the crawl depth and refresh frequency before adding your website URL.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-knowledge-website-url-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=18c963a35a03d16a7f72abc76abc7dc5" alt="Website knowledge settings showing crawl depth, update frequency, and an empty URL field." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-knowledge-website-url-annotated.svg" />
</Frame>

After an online knowledge source is created, its action menu also lets you preview the crawled page, run a manual update, or change its update settings.

## Add a Q\&A pair

1. Select **Q\&A**, then click **Next**.
2. Enter the expected user question in **Question**.
3. Enter the response the AI Agent should provide in **Answer**.
4. Click **Create**.

<Frame caption="Enter the expected question and the prepared answer, then select Create.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-knowledge-qa-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=85303c6dc6ec9c6a6290801f178ee269" alt="Create Q&A dialog with empty Question and Answer fields." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-knowledge-qa-annotated.svg" />
</Frame>

Each question and answer can contain up to 1,024 characters.

## Add an attachment

Use an attachment when you want the AI Agent to send a complete file to users, such as a product catalog, image, or video. Attachment content is not parsed, chunked, or used to answer questions.

1. Select **Attachment**, then click **Next**.
2. Click **Upload file** and choose a supported file.
3. Optionally enter a **Display name**. If you leave it blank, the original file name is used. The display name can contain up to 255 characters.
4. Enter a **Content description** that explains when the AI Agent should send the file. The description can contain up to 1,024 characters.
5. Click **Create**.

<Frame caption="Upload the original file, then complete its display name and content description.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-knowledge-attachment-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=71db5054d55a127958057cddc88a0eb9" alt="Add attachment dialog showing Upload file and file format limits." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-knowledge-attachment-annotated.svg" />
</Frame>

Attachment limits are:

| File type | Supported formats | Maximum size |
| - | - | - |
| Image | JPEG, JPG, PNG | 5 MB |
| Video | MP4 | 16 MB |
| Document | TXT, PDF, PPT, PPTX, DOC, DOCX, XLS, XLSX | 100 MB |

## Manage knowledge

The Knowledge list shows each item's name, description, type, last updated time, status, and available actions.

* Use **Search by name or url** to find a specific item.
* Use the **Type**, **Last Updated**, and **Status** filters to narrow the list.
* Turn the status switch on to make an item **Used**, or off to make it **Unused**.
* Open an item's action menu to preview, update, change settings, or delete it. Available actions depend on the knowledge type.
* Select one or more items with the checkboxes to delete them in bulk.

Use the **Preview** panel on the right side of the page to test how the AI Agent responds after your knowledge is ready.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.