> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/russian/knowledge-base/sources.md).

# Добавление и упорядочивание материалов

База знаний поддерживает файлы, заметки Cherry Studio, локальные каталоги и один URL веб-страницы. После импорта также нужно проверить статус обработки, основной текст и чанки, а при обновлении материалов — переиндексировать.

{% hint style="info" %}
Критерий завершения — не «файл уже появился в списке», а то, что материал можно прочитать, чанки полные и реальный вопрос находит правильный источник.
{% endhint %}

## Выберите правильную точку входа

<figure><img src="https://3765361039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2FR2au2DTUF3rsKPa4GtmN%2Fclipboard.png?alt=media&amp;token=fa5fe0e5-075b-4fe6-93f0-a7f4584b1777" alt="知识库中的文件、笔记、目录和链接四种资料入口"><figcaption><p>Выбирайте точку входа в зависимости от источника: для небольшого числа файлов — 【Файлы】, для набора файлов одной категории — 【Каталог】, для содержимого Cherry Studio — 【Заметки】, для общедоступных страниц — 【Ссылка】.</p></figcaption></figure>

| Путь    | Для каких материалов подходит                  | Связь после импорта                                       | Основные замечания                                                                             |
| ------- | ---------------------------------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Файл    | PDF, Office, Markdown, текст и т. п.           | Сохранить управляемую копию                               | За один раз можно выбрать не более 20 элементов                                                |
| Заметки | Содержимое, уже организованное в Cherry Studio | Снимок содержимого на момент импорта                      | Последующие изменения исходной заметки не синхронизируются автоматически                       |
| Каталог | Пакет локальных файлов на одну тему            | Создать записи базы знаний на основе содержимого каталога | Не импортируйте целиком нерелевантные каталоги                                                 |
| Ссылка  | Одна общедоступная веб-страница                | Сохранить снимок страницы на момент сканирования          | Страницы входа, страницы, рендеримые скриптами, или ограниченные страницы могут быть неполными |

{% hint style="warning" %}
Поддерживаются файлы PDF, DOCX, DOC, PPTX, XLSX, XLS, MD, TXT, CSV, HTML и EPUB. Для сканированных PDF или изображений также нужно проверить OCR.
{% endhint %}

## Добавление и приемка материалов

{% stepper %}
{% step %}

### 1. Выберите источник материалов

Откройте базу знаний, нажмите кнопку добавления материалов и выберите 【Файлы】, 【Заметки】, 【Каталог】 или 【Ссылка】.
{% endstep %}

{% step %}

### 2. Подтвердите выбранное содержимое

Файлы и заметки можно выбирать пакетно; за одну интерактивную операцию можно добавить не более 20 элементов. Если материалов больше, добавляйте их партиями или используйте вход через каталог.
{% endstep %}

{% step %}

### 3. Разрешите конфликт одинаковых имен

Если новые материалы имеют то же имя, что и существующие записи, выберите 【Сохранить все】 или 【Заменить】. При обновлении регламентов, руководств и снимков заметок обычно выбирают 【Заменить】.

{% hint style="warning" %}
Выбор 【Сохранить все】 позволит старому и новому содержимому одновременно участвовать в поиске. Делайте так только если действительно нужно параллельно искать разные версии, и указывайте в названии дату или версию.
{% endhint %}
{% endstep %}

{% step %}

### 4. Дождитесь завершения обработки

Материалы проходят этапы копирования, чтения, разбиения и индексации. Если модель встраивания не настроена, вектор не будет создан, но ключевой индекс все равно будет создан.

<figure><img src="https://3765361039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2FoYCk8ddQNgaZxNQ65As2%2Fclipboard.png?alt=media&amp;token=6a24e9c5-3456-492b-bf99-fc7cd426cf30" alt="包含多条已处理资料的员工差旅制度知识库"><figcaption><p>После того как материал станет доступен, выборочно проверьте основной текст и чанки.</p></figcaption></figure>
{% endstep %}

{% step %}

### 5. Выборочно проверьте основной текст и чанки

Откройте материал, чтобы посмотреть основной текст, или проверьте чанки через меню строки материала. Особое внимание уделите порядку заголовков, таблицам, тексту OCR и тому, не были ли ошибочно разделены ключевые предложения.
{% endstep %}

{% step %}

### 6. Завершите тест поиска

Проверьте правильный источник и фрагмент с помощью вопроса с однозначным ответом. После обновления материала также повторно протестируйте ту же группу вопросов.

<figure><img src="https://3765361039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fr2mSvzxjXSvwuT0gGIf6%2Fclipboard.png?alt=media&amp;token=87900ecb-c890-4894-9891-905a4caad74c" alt="召回测试中的来源、相关度、片段内容和排序"><figcaption><p>Окончательная приемка должна учитывать источник, полноту фрагмента и ранжирование, а не только факт возврата результата.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Статус материалов и способы обработки

| Явление                                        | Возможная причина                                                              | Способ решения                                                        |
| ---------------------------------------------- | ------------------------------------------------------------------------------ | --------------------------------------------------------------------- |
| Долгое время в обработке                       | Файл слишком большой, парсер или модель недоступны                             | Проверьте исходный файл, обработку документа и модель встраивания     |
| Отображается ошибка                            | Сбой копирования, чтения, разбиения или индексации                             | Откройте сообщение об ошибке и устраните проблему на этапе сбоя       |
| Отсутствует основной текст или он искажен      | Неподходящий обработчик файлов, для сканированного содержимого не выполнен OCR | Измените способ обработки документа или настройте OCR                 |
| В чанке отсутствует ключевое предложение       | Неподходящие границы разбиения на фрагменты                                    | После настройки разбиения выполните 【Переиндексацию】                  |
| Старые и новые версии срабатывают одновременно | Для материалов с одинаковым именем выбрано 【Сохранить все】                     | Удалите старую запись или повторно импортируйте и выберите 【Заменить】 |

## Переиндексация и удаление

После изменения настроек разбиения, парсера или встраивания старые записи не будут автоматически использовать новые настройки. Для одной записи используйте 【Переиндексировать】, или выберите несколько материалов и переиндексируйте их.

{% hint style="danger" %}
Удаление записи удаляет управляемую копию и индекс из текущей базы знаний. Оно не удаляет исходный файл или исходную заметку, но перед удалением все равно нужно убедиться, что в базе знаний нет единственной копии.
{% endhint %}

## Описание настройки

| Параметр настройки            | Стандартное значение продукта | Рекомендуемая отправная точка                                | Назначение                                                                        | Сценарий применения                         | На что обратить внимание                                                                |
| ----------------------------- | ----------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------- | ------------------------------------------- | --------------------------------------------------------------------------------------- |
| Количество за одно добавление | Максимум 20 элементов         | Сначала добавьте небольшое число репрезентативных материалов | Контролируйте объем импорта за один раз                                           | Первичное создание базы или отладка         | Перед массовым импортом сначала проверьте парсинг и поиск                               |
| Обработка одинаковых имен     | Выбирается при конфликте      | Для обновляемых материалов предпочтительно 【Заменить】        | Определяет, будут ли старые и новые записи сосуществовать                         | Обновление регламентов, руководств, заметок | 【Сохранить все】 может привести к тому, что старое содержимое будет участвовать в поиске |
| Переиндексация                | Выполнить вручную             | Выполнить после изменения настроек                           | Позволяет старым материалам использовать новое парсирование, разбиение или модель | Настроить или исправить материалы           | После завершения обязательно заново проверьте поиск                                     |

## Сценарий пользователя

Кобаяси каждый месяц обновляет правила командировок. Он импортирует новый файл с тем же именем и выбирает 【Заменить】, а после завершения обработки материалов выборочно проверяет основной текст и чанки, затем с помощью фиксированных вопросов тестирует правила проживания, транспорта и согласования.

Критерий завершения: старые правила больше не появляются в результатах поиска, а условия и суммы новых правил стабильно находятся.

## Часто задаваемые вопросы

<details>

<summary>Если изменить исходную заметку, база знаний обновится автоматически?</summary>

Нет. При импорте заметки сохраняется снимок ее содержимого на тот момент. После изменений нужно добавить ее заново и выбрать 【Заменить】, либо выполнить 【Переиндексацию】 соответствующих материалов.

</details>

<details>

<summary>Почему с веб-страницы загружается только часть содержимого?</summary>

Страницы, требующие входа, зависящие от рендеринга скриптами или имеющие ограничения доступа, могут не сканироваться полностью. Можно вместо этого сохранить основной текст в файл или заметку и затем импортировать.

</details>

<details>

<summary>Удаление записи базы знаний удаляет исходный файл?</summary>

Нет, исходный файл или исходная заметка не удаляются, но из базы знаний удаляются управляемая копия и индекс.

</details>

## Читать далее

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Парсинг документов и OCR</strong></td><td>Обработка отсутствующего основного текста, искажений и сканированного контента.</td><td><a href="/docs/russian/knowledge-base/document-preprocessing.md">Разбор документов и OCR</a></td></tr><tr><td><strong>Проверка материалов и извлечения</strong></td><td>Проверяйте качество поиска с помощью фиксированных вопросов.</td><td><a href="/docs/russian/knowledge-base/recall-test.md">Проверка материалов и выдачи</a></td></tr><tr><td><strong>Данные, конфиденциальность и сопровождение</strong></td><td>Узнайте о резервном копировании, удалении и границах сервиса.</td><td><a href="/docs/russian/knowledge-base/data.md">Данные, конфиденциальность и обслуживание</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cherryai.com.cn/docs/russian/knowledge-base/sources.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.