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

# Примеры применения базы знаний

Надёжность базы знаний зависит не от количества материалов, а от того, чётко ли определены границы, можно ли поддерживать источники и может ли реальная проблема стабильно извлекать правильные доказательства.

{% hint style="info" %}
Приведённые ниже параметры — лишь отправная точка. Сначала прогоните импорт, извлечение и использование на 3–10 репрезентативных материалах, затем расширяйте набор по фиксированному набору вопросов.
{% endhint %}

## Сначала спроектируйте по одной и той же методике

{% stepper %}
{% step %}

### 1. Чётко опишите конечную задачу

Определите, какой вывод должен сделать пользователь или какой результат предоставить, например: проверить регламент, устранить неисправность или подготовить исследовательский отчёт.
{% endstep %}

{% step %}

### 2. Определите границы материалов

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

{% step %}

### 3. Выберите источники и способ обновления

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

{% step %}

### 4. Подготовьте вопросы для приёмки

Подготовьте 3–10 реальных вопросов, охватывающих точные факты, условные правила, разговорные формулировки и легко путаемые версии.
{% endstep %}

{% step %}

### 5. Настройте схему поиска

Сначала оставьте простую конфигурацию. Добавляйте эмбеддинги, когда BM25 недостаточно для синонимичных формулировок; добавляйте rerank, когда правильный кандидат уже найден, но порядок нестабилен.
{% endstep %}

{% step %}

### 6. Подключите диалог или Agent

Для одного вопроса-ответа используйте обычный диалог; когда нужны многошаговое исследование, сравнение и выдача файла, подключайте Agent. Перед запуском сверяйте источники построчно.
{% endstep %}
{% endstepper %}

## Сценарий пользователя 1: вопросы по правилам для сотрудников

### Цель

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

### Организация материалов

* База знаний: 【Правила командировок для сотрудников】
* Элемент: 【Процесс согласования командировки】
* Элемент: 【Справочник по нормам проживания】
* Элемент: 【Частые вопросы по командировкам】

<figure><img src="/files/1cf4d0a00254df70879003cbc51ada96ac36c215" alt="由多条制度资料组成并全部就绪的员工差旅制度知识库"><figcaption><p>Пункты регламента и FAQ ведите отдельно; при обновлении одного из них не нужно перерабатывать все материалы.</p></figcaption></figure>

### Рекомендуемая конфигурация

| Параметр            | Стартовая точка                      | Когда корректировать                                                                      |
| ------------------- | ------------------------------------ | ----------------------------------------------------------------------------------------- |
| Поиск               | Сначала используйте BM25             | Если формулировки сотрудников сильно отличаются от текста регламента, добавьте эмбеддинги |
| Rerank              | Сначала не использовать              | Включайте, когда правильный кандидат уже появляется, но порядок нестабилен                |
| Версия материала    | Оставляйте только текущую версию     | Если нужен параллельный исторический аудит, указывайте год в названии                     |
| Требования к ответу | Разделяйте вывод, условия и источник | Если материал этого не поясняет, явно отмечайте это                                       |

### Вопросы для приёмки

1. Какова максимальная сумма возмещения за гостиницу в командировке?
2. Можно ли возместить аренду автомобиля за границей?
3. Кто утверждает, если ожидаемая общая сумма расходов превышает 5000 юаней?
4. Что будет, если забронировать отель без предварительного согласования?

### Подсказка для диалога

> Отвечай только на основе «Правил командировок для сотрудников». Сначала дай вывод, затем перечисли применимые условия и источник; если материал этого не объясняет, пиши «в регламенте не указано», не дополняй по здравому смыслу.

{% hint style="success" %}
При успешной приёмке одно и то же правило срабатывает и на формулировки из оригинального текста, и на разговорные формулировки, а суммы, роли и условия в ответе могут быть напрямую подтверждены цитатами.
{% endhint %}

## Сценарий пользователя 2: помощник по послепродажной поддержке продукта

### Цель

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

### Границы материалов

| База знаний или группа материалов | Содержимое                                       | Принцип ведения                                          |
| --------------------------------- | ------------------------------------------------ | -------------------------------------------------------- |
| Официальное руководство           | Спецификации, границы гарантии, стандартные шаги | Сохраняйте модель и версию документа                     |
| Коды неисправностей               | Одна неисправность — один раздел                 | Помечайте применимую прошивку и модель устройства        |
| Проверенные кейсы                 | Кейсы с подтверждённой причиной и решением       | Непроверенные записи чатов нельзя импортировать напрямую |

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

### Настройки поиска и Agent

* Для PDF сначала выборочно проверьте оглавление, таблицы и двухколоночный текст.
* Коды ошибок требуют точной терминологии, поэтому сохраняйте BM25.
* Если описание клиента более разговорное, добавьте модель эмбеддингов.
* Подключите к Agent послепродажной поддержки официальное руководство и проверенные кейсы, включив только 【поиск по базе знаний】.

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

### Критерии приёмки

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

## Сценарий пользователя 3: исследовательские материалы и отчёт

### Цель

Извлекайте проверяемые доказательства из статей, заметок интервью и веб-снимков, а затем пусть Agent формирует сравнительный отчёт с источниками.

### Организация материалов

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

<figure><img src="/files/bd53667e724880a06b8461ee77108ebd1bed714b" alt="从提出真实问题、检查召回、定位问题到只调整一项并重新索引复测的知识库质量闭环图"><figcaption><p>Сначала проверьте покрытие источников фиксированными вопросами, а затем передайте исследовательскую базу Agent для междокументного обобщения.</p></figcaption></figure>

### Подсказка для Agent

> Найди доказательства в подключённой исследовательской базе знаний на тему «почему пользователи отказываются от первоначальной настройки». Сначала перечисли исходные точки зрения и ограничения по источникам, затем обобщи консенсус, расхождения и гипотезы, требующие проверки. В итоге сформируй отчёт в Markdown; не выдавай умозаключения за прямые слова респондентов.

### От доказательств к результату

<figure><img src="/files/53bd9c920fe4c439f4fb3ef1a04fdf0f538d5b15" alt="资料来源经过知识库召回和 Agent 整理后形成文字文件或多语言图片的内容工作流图"><figcaption><p>Сначала сохраняйте доказательства и ограничения, а затем просите Agent оформить их в отчёт; не позволяйте готовому результату скрывать первоисточники.</p></figcaption></figure>

### Критерии приёмки

* Консенсус должен поддерживаться как минимум двумя независимыми источниками.
* Расхождения сохраняйте с их собственными условиями, не объединяйте искусственно.
* Цитаты, выводы и рекомендации должны быть явно помечены.
* Веб-снимки и версии статей должны быть прослеживаемыми.

## Описание конфигурации: повторно используемая таблица проектирования

| Параметр            | На какой вопрос нужно ответить                                                                       |
| ------------------- | ---------------------------------------------------------------------------------------------------- |
| Цель                | Какое решение должен принять пользователь в итоге или какой результат предоставить?                  |
| Границы             | Какие материалы следует искать вместе, а какие обязательно разделять?                                |
| Источник            | Как обновлять документы, заметки, каталоги и веб-страницы?                                           |
| Разбор              | В каких типах документов чаще всего возникают проблемы OCR, таблиц или порядка?                      |
| Поиск               | Достаточно ли BM25? Когда нужны эмбеддинги и rerank?                                                 |
| Вопросы для приёмки | Какие 3–10 вопросов лучше всего отражают реальное использование?                                     |
| Обработка сбоев     | Что делать при отсутствии результатов, конфликтующих версиях и отсутствии подтверждающих материалов? |
| Поддержка           | Кто отвечает за замену материалов, повторную индексацию и резервное копирование?                     |

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

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

<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>Основы базы знаний</strong></td><td>Сначала запустите создание, импорт, извлечение и использование.</td><td><a href="/pages/29a16d6a5aa8feb12d1321bf48a4560387c80c0b">/pages/29a16d6a5aa8feb12d1321bf48a4560387c80c0b</a></td></tr><tr><td><strong>Использовать вместе с Agent</strong></td><td>Настройте многошаговое исследование и права на материалы.</td><td><a href="/pages/448dfb0eca91e829157e0bdead63cb395e2988da">/pages/448dfb0eca91e829157e0bdead63cb395e2988da</a></td></tr><tr><td><strong>Часто задаваемые вопросы</strong></td><td>По симптомам определяйте, связана ли проблема с материалами, извлечением или ответом.</td><td><a href="/pages/b237f6d0b0f37b6f7a1279316e936dbfb7d1f143">/pages/b237f6d0b0f37b6f7a1279316e936dbfb7d1f143</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/cases.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.