> 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/troubleshooting.md).

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

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

{% hint style="info" %}
Самый быстрый способ локализации — проверять один и тот же реальный вопрос: есть ли ответ в тексте, цел ли chunk, правильно ли сработал поиск, соответствует ли ответ источнику.
{% endhint %}

## Быстрая диагностика за 5 шагов

{% stepper %}
{% step %}

### 1. Проверьте статус материалов

Материалы должны быть в состоянии «Готово». Если долго находятся в обработке или показывают ошибку, сначала посмотрите сообщение об ошибке и убедитесь, что файл, обработчик и сервис модели доступны.
{% endstep %}

{% step %}

### 2. Проверьте распознанный текст

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

{% step %}

### 3. Проверьте чанки

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

<figure><img src="https://3765361039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2FSuW1LQlcdqCWxhLJEEQe%2Fclipboard.png?alt=media&amp;token=6ea5de2d-e4a1-40e2-b31c-d9ca31779eed" alt="知识库高级设置中的智能分段、分隔符、分段大小和重叠大小"><figcaption><p>Если текст распознан верно, но фрагменты неполные, скорректируйте разбиение и заново проиндексируйте старые материалы.</p></figcaption></figure>
{% endstep %}

{% step %}

### 4. Запустите тест поиска

Проверьте название источника, релевантность и содержимое фрагментов. Полное отсутствие правильных фрагментов и слишком низкое место правильных фрагментов — это два разных типа проблем.

<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 %}

{% step %}

### 5. Проверьте диалог или агента

Если поиск верный, но ответ ошибочен, убедитесь, что база знаний выбрана или привязана, попросите отвечать только на основе источников и разбейте вопрос на более мелкие фактические пункты.
{% endstep %}
{% endstepper %}

## Куда сообщать о проблеме

<figure><img src="https://3765361039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2FT67uGAggILYAlBn5tJa9%2Fclipboard.png?alt=media&amp;token=8b08883c-8dc6-4295-9d56-1c4226b8fcdd" alt="按不知道如何操作、稳定复现、希望增加能力和不希望整理材料选择反馈路径的关系图"><figcaption><p>Сначала выполните минимальную проверку; если проблему можно стабильно воспроизвести, приложите обезличенные шаги, ошибку и ожидаемый результат.</p></figcaption></figure>

{% hint style="danger" %}
Не публикуйте в скриншотах, логах и примерах API-ключи, содержимое внутренних файлов, e-mail или локальные чувствительные пути.
{% endhint %}

## Создание и импорт

<details>

<summary>Можно ли создать базу знаний без модели эмбеддингов?</summary>

Да. Если выбрать «Не использовать», будет по-прежнему применяться поиск по ключевым словам BM25. Модель эмбеддингов можно добавить позже, когда потребуется сопоставлять разные формулировки.

</details>

<details>

<summary>Какие источники и форматы файлов поддерживаются?</summary>

Источники включают файлы, заметки Cherry Studio, локальные каталоги и ссылки на веб-страницы. Форматы файлов: PDF, DOCX, DOC, PPTX, XLSX, XLS, Markdown, TXT, CSV, HTML и EPUB.

</details>

<details>

<summary>Сколько элементов можно добавить за раз?</summary>

За один интерактивный выбор можно добавить максимум 20 элементов. Больше материалов можно добавлять партиями или через вход из каталога.

</details>

<details>

<summary>Если материалы с одинаковым именем, выбрать «Оставить все» или «Заменить»?</summary>

При обновлении регламентов, руководств или снимков заметок обычно выбирают «Заменить». «Оставить все» выбирают только тогда, когда версии действительно должны сосуществовать, и добавляют в название дату или версию.

</details>

<details>

<summary>Что делать, если материалы долго остаются в обработке?</summary>

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

</details>

## Разбор и поиск

<details>

<summary>Почему в отсканированном PDF нет текста?</summary>

Сканированным документам нужен OCR. Откройте «Настройки» → «Обработка документов», выберите доступный OCR и затем переиндексируйте документ. Для сложной верстки можно попробовать специальный обработчик документов.

</details>

<details>

<summary>Почему после изменения настроек Chunk ничего не изменилось?</summary>

Новые настройки не применяются автоматически к старым материалам. Выполните «Переиндексацию» для соответствующих записей и снова проверьте тот же вопрос.

</details>

<details>

<summary>Что делать, если тест поиска вообще ничего не возвращает?</summary>

Последовательно проверьте статус материалов, есть ли ответ в тексте, находятся ли ключевые слова из оригинала, завершены ли эмбеддинги, не слишком ли высок порог rerank и не слишком ли мал Top K.

</details>

<details>

<summary>Что делать, если источник правильный, но фрагмент неполный?</summary>

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

</details>

<details>

<summary>Что делать, если правильный результат слишком далеко в списке?</summary>

Сначала удалите дубликаты и устаревшие материалы, затем подумайте о модели эмбеддингов. Если кандидаты в целом верные, но порядок нестабилен, можно усилить rerank и заново настроить порог.

</details>

<details>

<summary>Какое значение Top K стоит установить?</summary>

Можно начать с 6 и на фиксированном вопросе сравнить пропуски поиска, шум и время. Top K можно настраивать в диапазоне от 1 до 50; не считайте увеличение универсальным решением.

</details>

## Диалог и агент

<details>

<summary>Что делать, если вход в базу знаний в диалоге недоступен?</summary>

Выберите модель, поддерживающую вызов инструментов, и удалите вложение текущего сообщения. Также убедитесь, что хотя бы одна база знаний содержит материалы в состоянии «Готово».

</details>

<details>

<summary>Что делать, если в ответе не показываются источники?</summary>

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

</details>

<details>

<summary>Что делать, если поиск верный, а ответ все равно неточный?</summary>

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

</details>

<details>

<summary>Почему агент не видит базу знаний?</summary>

Откройте «Редактировать агента» → «База знаний», привяжите нужную базу к текущему агенту и включите «Поиск по базе знаний» в «Встроенных инструментах».

</details>

<details>

<summary>Изменяет ли управление базой знаний материалы?</summary>

Да. «Управление базой знаний» позволяет добавлять, удалять или обновлять документы. Не включайте его для задач только на чтение; перед записью проверьте цель, влияние и способ отката.

</details>

## Модели, данные и резервные копии

<details>

<summary>Почему при смене модели эмбеддингов требуется перестроение?</summary>

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

</details>

<details>

<summary>Как связаны rerank и порог сходства?</summary>

Rerank заново оценивает фрагменты-кандидаты, а порог отфильтровывает низкооцененные результаты после rerank. Если rerank не настроен, порог сходства не отображается в настройках базы знаний.

</details>

<details>

<summary>После загрузки локальной модели эмбеддингов система полностью работает офлайн?</summary>

Не обязательно. Чтобы процесс был полностью офлайн, разбор, OCR, rerank и чат тоже должны использовать только локальные возможности.

</details>

<details>

<summary>Обновятся ли автоматически исходные файлы или веб-страницы при изменении?</summary>

Нет. Для файлов, заметок и веб-страниц материалы создаются на основе содержимого на момент импорта. Повторно добавьте материал с тем же именем, выберите «Заменить» и затем выполните тест поиска.

</details>

<details>

<summary>Входит ли в упрощенную резервную копию файл базы знаний?</summary>

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

</details>

## Описание конфигурации: диагностическая база

| Параметр                | Рекомендуемая отправная точка                                   | В каких случаях настраивать                                              |
| ----------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------ |
| Top K                   | 6                                                               | Правильный фрагмент обрезается или слишком много шума                    |
| Порог сходства          | Начните с 0.0 после настройки rerank                            | Низкооцененный шум заметен, и у правильного фрагмента еще есть запас     |
| Chunk                   | Оставьте интеллектуальное разбиение по умолчанию                | Условия и вывод разделены, или фрагмент слишком длинный                  |
| Модель векторизации     | Добавляйте только если BM25 недостаточно                        | Разговорные формулировки и синонимы не находятся стабильно               |
| Модель переранжирования | Увеличивайте, когда кандидаты правильные, но порядок нестабилен | Не используется для исправления ошибок разбора или отсутствующего текста |

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

Кобаяси обнаружил, что на вопрос о «норме расходов на проживание» чат отвечает неверно. Сначала он проверил тот же вопрос в тесте поиска и увидел, что правильный источник вообще не появляется; затем открыл текст и обнаружил, что двухколоночный PDF перепутан по порядку. После смены обработчика и переиндексации поиск стал правильным, и ответ в чате тоже вернулся к норме.

В этом процессе изменялась только одна переменная — обработчик, поэтому удалось подтвердить первопричину, а не полагаться на удачу, одновременно увеличивая Top K, chunk и порог.

{% hint style="warning" %}
Если проблема все еще не решена, запишите версию приложения, операционную систему, обработчик, модели эмбеддингов и rerank, полную ошибку, обезличенный минимальный пример, результаты поиска и ожидаемый источник.
{% endhint %}

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

<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>Понимание эмбеддингов, rerank, порога и перестроения.</td><td><a href="/docs/russian/knowledge-base/emb-models-info.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/troubleshooting.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.