> 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" %}
Самый быстрый способ локализации — проверять один и тот же реальный вопрос по всей цепочке: есть ли ответ в тексте, полон ли чанк, корректен ли ретрив, соответствует ли ответ источнику.
{% endhint %}

## 5 быстрых шагов для локализации

{% stepper %}
{% step %}

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

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

{% step %}

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

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

{% step %}

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

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

<figure><img src="/files/c408d247a81e89d2eee11b4031c4239addf81367" alt="知识库高级设置中的智能分段、分隔符、分段大小和重叠大小"><figcaption><p>Если текст правильный, но фрагменты неполные, снова настройте нарезку и переиндексируйте старые материалы.</p></figcaption></figure>
{% endstep %}

{% step %}

### 4. Запустите тест ретривa

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

<figure><img src="/files/1e072bb8082483e7bfbf7dab3b4aa1e770755b45" alt="召回测试中显示来源名称、相关度和命中片段的结果列表"><figcaption><p>Сначала докажите, что слой поиска вернул правильное доказательство, а уже потом настраивайте подсказку для диалога.</p></figcaption></figure>
{% endstep %}

{% step %}

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

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

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

<figure><img src="/files/0bda4d4bdda9baebd8fe0fa5136f68cf1232ef28" 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>Что делать, если тест ретривa вообще ничего не находит?</summary>

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

</details>

<details>

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

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

</details>

<details>

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

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

</details>

<details>

<summary>Какое значение Top K выбрать?</summary>

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

</details>

## Диалог и Agent

<details>

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

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

</details>

<details>

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

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

</details>

<details>

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

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

</details>

<details>

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

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

</details>

<details>

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

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

</details>

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

<details>

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

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

</details>

<details>

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

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

</details>

<details>

<summary>Если локальная модель эмбеддингов скачана, это уже полностью офлайн?</summary>

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

</details>

<details>

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

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

</details>

<details>

<summary>Включает ли облегчённая резервная копия файлы базы знаний?</summary>

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

</details>

## Описание настроек: базовая диагностика

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

## Кейс пользователя

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

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

{% hint style="warning" %}
Если проблема всё ещё не решается, запишите версию приложения, операционную систему, процессор, модели эмбеддинга и рерангинга, полную ошибку, обезличенный минимальный пример, результаты ретривa и ожидаемый источник.
{% 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="/pages/53bb043e136eac8710d3cc6e17df25221eec9694">/pages/53bb043e136eac8710d3cc6e17df25221eec9694</a></td></tr><tr><td><strong>Настройки модели и поиска</strong></td><td>Понимание эмбеддингов, рерангинга, порогов и перестроения.</td><td><a href="/pages/4cd2dac273bd61362710743b0cb64beddcd1307b">/pages/4cd2dac273bd61362710743b0cb64beddcd1307b</a></td></tr><tr><td><strong>Данные, конфиденциальность и обслуживание</strong></td><td>Проверка границ между резервным копированием и облачными сервисами.</td><td><a href="/pages/c8a6f1b5836ae79ec3b4c719c9c7f566343b544e">/pages/c8a6f1b5836ae79ec3b4c719c9c7f566343b544e</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 dynamically by asking a question.

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

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.