> 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.