> 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/cherry-studio/preview/chat.md). # Диалог-ассистент Интерфейс диалога — самая часто используемая страница Cherry Studio, но его структура включает **два уровня**：помощник → диалог. Понимание этой структуры помогает эффективнее использовать различные функции диалога. {% hint style="info" %} Если вы всё ещё путаете понятия помощника, агента, навыка и т. п., сначала посмотрите ниже раздел [Библиотека помощников](#助手库) и страницу [агент](/docs/russian/cherry-studio/preview/agent.md) . {% endhint %} ## Связь между помощником и диалогом Простая аналогия: * **помощник = роль**(например, «помощник по продуктовой документации», «code reviewer») * **диалог = беседа с этой ролью**(например, в понедельник обсуждаем «план рефакторинга», во вторник — «отчёт об ошибке») То есть:**в рамках одного помощника можно создать несколько диалогов**, все диалоги используют общую персону и параметры этого помощника (prompt, модель, температура и т. д.), и не нужно каждый раз заново задавать роль и стиль AI. ### Помощник Помощник задаёт AI фиксированную роль — состоит из предустановки системного prompt + параметров модели. * **Системный помощник по умолчанию**: универсальный помощник без специальных prompt, можно использовать сразу * **Более специализированные помощники**: ниже [Библиотека помощников](#助手库) просмотрите готовые пресеты или создайте свой ### Диалог В рамках каждого помощника можно создать несколько диалогов (то есть несколько независимых бесед). Диалоги независимы друг от друга, но используют настройки своего помощника. Примеры сценариев: * В рамках одного «кодового помощника» отдельно открыть два диалога — «Рефакторинг проекта A» и «Ошибка в проекте B» — и вести их независимо * В рамках одного «переводческого помощника» открыть несколько диалогов и обрабатывать разные статьи

Под каждым помощником можно раскрыть несколько диалогов (на рисунке под помощником «Маркетинг» раскрыты два диалога)

## Библиотека помощников Откуда берутся помощники в списке? Помимо системного помощника по умолчанию, вы можете из **Библиотека помощников** Библиотеки помощников добавить или создать самостоятельно. Библиотека помощников — это **рынок пресетов помощников**, где есть множество шаблонов «роль + prompt + параметры»; после добавления они появятся в списке помощников на странице диалога. {% hint style="warning" %} **Не путайте с агентом**: библиотека помощников выдаёт упомянутый выше [Ассистент для диалогов](#助手)(один пресет роли);[агент](/docs/russian/cherry-studio/preview/agent.md)(вход \[Стартовая панель] → \[Работа]) — это другая система, которая может самостоятельно вызывать инструменты, читать и записывать файлы и выполнять задачи по шагам. Это разные вещи, и точки настройки тоже разные: помощник управляется на странице диалога, а агент — в \[Работе]. {% endhint %} ### Перейти в библиотеку помощников 1. Вверху списка помощников слева на странице диалога нажмите **способ отображения** иконку (в виде воронки) и в всплывающем меню выберите \[Управление помощниками]. 2. На открывшейся странице «Управление помощниками» в правом верхнем углу нажмите кнопку \[Библиотека помощников], чтобы перейти в рынок пресетов помощников.

Библиотека помощников — просматривайте карточки помощников по категориям использования (с бейджами количества); сверху есть поле поиска

### Поиск помощников в библиотеке помощников * **Фильтр по категориям**: по `Все` / `Избранное` и множеству категорий использования (профессия, бизнес, инструменты, язык, офис, общее, письмо, программирование, эмоции, образование, творчество, академическое, дизайн, искусство, развлечения, жизнь и т. д.); цифра рядом с названием категории — это количество помощников в ней * **Поиск**: верхнее поле поиска позволяет искать по ключевым словам во всех категориях * **Предпросмотр**: нажав на карточку помощника, можно увидеть его системный prompt, рекомендуемую модель и предустановки параметров ### Добавить в мои помощники * Нажмите **Добавить** кнопку на карточке помощника, чтобы добавить этот пресет в список ваших помощников * После этого этого помощника можно будет увидеть в списке помощников на странице диалога ### Создать собственного помощника В правом верхнем углу страницы «Управление помощниками» нажмите \[Создать помощника], откроется тот же диалог, что и [Редактировать помощника](#bian-ji-zhu-shou) можно заполнять по вкладкам: * **Основное**: аватар, имя, описание, модель по умолчанию для этого помощника, группа * **Модель**: параметры модели, такие как температура, Top-P, максимальное число токенов и т. д. (подробнее ниже в разделе [Настройки помощника](#zhu-shou-she-zhi)) * **Prompt**: определяет роль и поведение этого помощника; кнопка с молнией в правом верхнем углу поля ввода — это \[AI-оптимизация prompt], с помощью [глобальной модели помощника по умолчанию](/docs/russian/pre-basic/settings/default-models.md) переписать текущий контент более структурированно * **База знаний**: связать уже созданные [База знаний](/docs/russian/knowledge-base/knowledge-base.md) * **MCP**: включить для этого помощника MCP-инструменты

Диалоговое окно создания / редактирования помощника: слева пять вкладок — Основное / Модель / Prompt / База знаний / MCP

{% hint style="info" %} **Выбор модели**: можно **Основное** во вкладке «Модель» задать помощнику модель по умолчанию, а можно в любое время временно переключить её через выпадающее меню модели вверху страницы диалога. Если модель по умолчанию для помощника не задана, будет использоваться [глобальная модель диалога по умолчанию](/docs/russian/pre-basic/settings/default-models.md#mo-ren-zhu-shou-mo-xing). {% endhint %} ### Импорт и управление В правом верхнем углу страницы «Управление помощниками» доступны три кнопки действий: * **Создать помощника**: открыть [диалог редактирования помощника](#bian-ji-zhu-shou) создать помощника с нуля * **Библиотека помощников**: перейти на упомянутый выше рынок пресетов помощников * **Импортировать помощника**: открыть диалог «Импорт из внешнего источника» и импортировать помощника, которым поделился кто-то другой Сама страница «Управление помощниками» предназначена для централизованного управления уже добавленными помощниками; поддерживает пакетное удаление и пакетный экспорт. Диалог \[Импорт из внешнего источника] предлагает три способа однократного импорта; после завершения импорта помощник появится в вашем списке помощников: * **Загрузка файла**: перетащите или выберите JSON-файл * **Буфер обмена**: просто вставьте JSON-текст помощника * **Импорт по URL**: укажите ссылку на JSON (из соображений безопасности сейчас поддерживаются только источники GitHub Gist, raw\.githubusercontent.com и т. п.)

Диалог импорта из внешнего источника — загрузка файла / буфер обмена / импорт по URL

### Когда использовать библиотеку помощников, а когда — агента? | Сценарий | Рекомендуется | | -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Быстрый диалог с персонализированной «ролью» (письмо, перевод, технические вопросы и т. д.) | **Библиотека помощников** | | Позволить AI самостоятельно вызывать инструменты, читать и писать файлы, выполнять задачи по шагам | [**агент**](/docs/russian/cherry-studio/preview/agent.md) | | Плановое выполнение, кроссплатформенная отправка сообщений | **Агент +** [**планировщик задач**](/docs/russian/advanced-basic/automation/scheduled-heartbeat.md) **+** [**каналы**](/docs/russian/advanced-basic/automation/channels.md) | ## кнопки внутри диалогового окна

На панели инструментов поля ввода по умолчанию размещены только 4 часто используемых инструмента; остальные функции находятся в панели быстрых действий [ + ]

Панель инструментов под полем ввода **По умолчанию отображаются только 4 часто используемых инструмента**, остальные функции спрятаны в конце **панели быстрых действий \[ + ]** . Чтобы изменить, какие инструменты показываются по умолчанию, нажмите \[ + ] → \[Настроить панель инструментов]. ### Панель инструментов по умолчанию | Название | Роль | | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Новый диалог** | Создать новый диалог в рамках текущего помощника | | **Поиск в интернете** | Возвращает результаты веб-поиска как контекст для модели; сначала нужно настроить это в режиме онлайн. Для некоторых моделей можно вместо этого использовать встроенный в модель поиск | | **База знаний** | добавленный [База знаний](/docs/russian/knowledge-base/knowledge-base.md) в качестве контекста | | **+ (панель быстрых действий ввода)** | Открывает ниже набор дополнительных инструментов и действий | ### Панель быстрых действий ввода (+) Нажмите **+**, или если прямо ввести `/`, тоже откроет эту панель. Панель поддерживает ↑↓ выбор,Tab / Enter подтверждение,ESC закрытие. | Название | Роль | | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Загрузить вложение** | Загрузить изображение или документ; изображения требуют поддержки визуальных возможностей модели, документы будут распознаны как контекст | | **Сгенерировать изображение** | Попросить текущую модель диалога сгенерировать изображение; сначала нужно настроить модель для рисования в \[Настройки] → \[Модель по умолчанию]. Для специализированной генерации изображений перейдите в [Рисование](/docs/russian/cherry-studio/preview/drawing.md) | | **Управление prompt** | Вставлять и управлять предустановленными prompt; подробнее см. [Панель инструментов ввода и инструменты повышения эффективности](/docs/russian/advanced-basic/workbench/composer-efficiency.md) | | **MCP** | Просмотр и включение MCP-серверов, доступных для текущего диалога | | **Сослаться на заметку** | из [Заметки](/docs/russian/cherry-studio/preview/notes.md) выбрать одну как прикрепляемую ссылку | | **Очистить контекст** | **Сохранить сообщение**, но заставить модель «забыть» предыдущий диалог (обрезать контекст) | | **Настраиваемая панель инструментов** | Выбрать, какие инструменты показывать на панели инструментов по умолчанию | Добавленные в поле ввода изображения отображаются как значок вложения. При наведении можно быстро просмотреть; нажав на вложение или, после фокуса с клавиатуры, нажав Enter / Space, можно открыть полный просмотр изображения. {% hint style="info" %} **«Очистить контекст» не удаляет сообщения**: сообщения остаются в диалоге, просто модель с этого момента заново знакомится с вами и больше не помнит предыдущий контент. {% endhint %} ### Справа от поля ввода * **Развернуть / свернуть**(в правом верхнем углу поля ввода): увеличить поле ввода для удобства набора длинного текста * **Обдумывание**(выпадающий список внизу справа, отображается как «По умолчанию»): регулировка силы рассуждения модели, доступна только если выбранная модель поддерживает рассуждение; для неподдерживаемых моделей будет показано «Текущая модель не поддерживает настройку силы рассуждения» * **Отправить**: отправить сообщение (по умолчанию Enter, можно изменить в [Горячие клавиши](/docs/russian/pre-basic/settings/key-shortcut.md) ) ### Через клавиатуру В подсказке поля ввода уже указаны два быстрых способа ввода: * **`/`**: открыть панель быстрых действий ввода и выбрать инструмент или действие (то же, что нажать **+** ) * **`@`**: сослаться на уже существующую тему и перенести её содержимое в текущий диалог {% hint style="info" %} После включения **Показывать примерное число токенов** в \[Настройки] → \[Внешний вид] → \[Настройки ввода] в поле ввода также будет показываться оценочное потребление токенов для справки (у разных моделей разная токенизация, фактический биллинг определяется провайдером модели). {% endhint %} ## Настройки диалога Отображение сообщений **Связанные с вводом** и **предпочтения теперь централизованы в** и действуют глобально для всех диалогов всех помощников; `Настройки → Внешний вид` Параметры модели**настраиваются отдельно для каждого помощника.** Настройки отображения сообщений и ввода ### Все следующие предпочтения настраиваются в , полное описание см. в разделе Внешний вид: `Настройки → Внешний вид` : стиль сообщения (пузырь / компактный), использование шрифта с засечками, размер шрифта сообщения, автоматическое сворачивание содержания размышлений, показ структуры сообщений, номера строк в коде / сворачивание блоков кода / перенос строк в блоках кода, стиль кода, рендеринг математических формул и т. д. * **Связанные с вводом**: горячая клавиша отправки, показ оценочного числа токенов, рендеринг Markdown во входящих сообщениях, подтверждение перед удалением сообщения и т. д. * **предпочтения теперь централизованы в**: температура, Top-P, максимальное число токенов, потоковый вывод, управление контекстом, пользовательские параметры и т. д. ### настраиваются отдельно для каждого помощника. Параметры модели настраиваются отдельно для каждого помощника **, находятся в**во вкладке «Модель» диалогового окна; подробнее ниже [Редактировать помощника](#bian-ji-zhu-shou) см. [Настройки помощника](#zhu-shou-she-zhi). ## Настройки помощника в списке помощников **щелкните правой кнопкой мыши** по помощнику, для которого нужно настроить параметры, и в выпадающем меню выберите \[Редактировать помощника], после чего откроется диалог редактирования помощника. ### Редактировать помощника {% hint style="info" %} Настройки помощника применяются ко всем диалогам под этим помощником. {% endhint %} Слева в диалоговом окне редактирования есть пять вкладок: * **Основное**: аватар, имя, описание, модель по умолчанию для этого помощника, группа * **Модель**: параметры модели, такие как температура, Top-P, максимальное число токенов, потоковый вывод, управление контекстом, пользовательские параметры * **Prompt**: то есть prompt; можно ориентироваться на [агент](/docs/russian/cherry-studio/preview/agent.md) способы написания prompt на странице и редактировать содержимое * **База знаний**: связать уже созданные [База знаний](/docs/russian/knowledge-base/knowledge-base.md) * **MCP**: включить MCP-серверы для этого помощника

Диалог редактирования помощника (вкладка Основное)

#### Модель по умолчанию (вкладка Основное) Во вкладке «Основное» можно закрепить для этого помощника модель по умолчанию; если не задавать, он будет следовать за [глобальная модель диалога по умолчанию](/docs/russian/pre-basic/settings/default-models.md#mo-ren-zhu-shou-mo-xing). {% hint style="info" %} Приоритет модели по умолчанию у помощника выше, чем у глобальной модели диалога по умолчанию. Если модель по умолчанию для помощника не задана, модель по умолчанию помощника = глобальная модель диалога по умолчанию. Вы также можете в любой момент временно сменить модель через выпадающий список моделей вверху страницы диалога. {% endhint %} #### Параметры модели (вкладка Модель) Все следующие параметры настраиваются во вкладке «Модель». #### **`Температура (Temperature)`** : Параметр температуры управляет степенью случайности и креативности генерируемого моделью текста (значение по умолчанию 0.7). На практике это выглядит так: * Низкая температура (0–0.3): * Вывод более определённый и сфокусированный * Подходит для генерации кода, анализа данных и других задач, где важна точность * Тяготеет к выбору наиболее вероятных слов * Средняя температура (0.4–0.7): * Балансирует креативность и связность * Подходит для повседневных диалогов и общего письма * Рекомендуется для диалогов чат-бота (около 0.5) * Высокая температура (0.8–1.0): * Даёт более креативный и разнообразный вывод * Подходит для творческого письма, мозгового штурма и т. п. * Но может снизить связность текста #### **`Top P (ядерная выборка)`**: Значение по умолчанию — 1; чем меньше значение, тем более однообразен и тем легче понять сгенерированный AI контент; чем больше, тем шире словарный диапазон ответов AI и тем он разнообразнее. Ядерная выборка влияет на вывод, управляя порогом вероятности выбора слов: * Малые значения (0.1–0.3): * Рассматриваются только слова с наивысшей вероятностью * Вывод более консервативный и управляемый * Подходит для комментариев к коду, технической документации и т. п. * Средние значения (0.4–0.6): * Баланс между разнообразием слов и точностью * Подходит для обычных диалогов и письменных задач * Большие значения (0.7–1.0): * Учитывается более широкий набор вариантов слов * Получается более богатый и разнообразный контент * Подходит для творческого письма и других сценариев, где нужно разнообразие выражений {% hint style="info" %} * Эти два параметра можно использовать независимо или в сочетании * Выбирайте подходящее значение параметров в зависимости от типа задачи * Рекомендуется экспериментально найти комбинацию параметров, лучше всего подходящую для конкретного сценария применения * Приведённое выше — только для справки и понимания концепций; указанные диапазоны параметров могут не подходить для всех моделей, конкретные рекомендации см. в документации соответствующей модели. {% endhint %} #### **`Управление контекстом`** Управляет тем, как обрабатывается исторический контекст, отправляемый модели вместе с запросом. Если включено, для этого помощника используются настраиваемые параметры управления контекстом (например, автоматическое сжатие длинной истории, обрезка по порогу); если выключено, используются глобальные настройки. Чем длиннее контекст, тем больше информации помнит модель, но тем больше токенов она потребляет. #### **`Максимальное число вызовов инструментов`** Ограничивает число последовательных вызовов инструментов в одном ответе помощника. Для нового помощника по умолчанию используется 100 раундов; можно задать от 1 до 1000; у существующих помощников сохраняется прежнее значение, в старых конфигурациях часто встречается 20 раундов. Если появляется подсказка вроде «достигнут верхний предел раундов вызова инструментов», можно увеличить этот параметр или разбить задачу на более мелкие части и повторить. Чем больше число раундов, тем дольше может работать цепочка инструментов и тем больше Token может расходоваться; в обычном диалоге специально повышать его не нужно. #### **`Включить ограничение длины сообщения (MaxToken)`** Максимум за один ответ [Token](https://docs.cherry-ai.com/question-contact/knowledge#shen-me-shi-tokens) число; в больших языковых моделях max token (максимальное число токенов) — это ключевой параметр, который напрямую влияет на качество и длину генерируемого ответа. > Например, в CherryStudio при тестировании связи модели после ввода key достаточно лишь узнать, корректно ли модель вернула сообщение, без конкретного содержания; в таком случае можно установить MaxToken = 1. У большинства моделей верхний предел MaxToken — 32k Tokens, но бывают и 64k, и даже больше; конкретику нужно смотреть на странице описания соответствующей модели. Сколько именно задавать — зависит от ваших нужд; конечно, можно ориентироваться на следующие рекомендации. {% hint style="success" %} Рекомендации: * Обычный чат: 500–800 * Генерация короткого текста: 800–2000 * Генерация кода: 2000–3600 * Генерация длинного текста: 4000 и выше (требуется поддержка самой модели) {% endhint %} {% hint style="warning" %} Обычно ответ, генерируемый моделью, будет ограничен диапазоном MaxToken; однако возможны и усечение (например, при написании длинного кода), и неполная формулировка. В особых случаях также нужно гибко корректировать параметры по ситуации. {% endhint %} #### **`Потоковый вывод (Stream)`** Потоковый вывод — это способ обработки данных, при котором данные передаются и обрабатываются как непрерывный поток, а не отправляются все сразу. Это позволяет обрабатывать и выводить данные сразу после их генерации, значительно повышая оперативность и эффективность. В CherryStudio и подобных клиентах это, проще говоря, эффект печатной машинки. После выключения (не поток): модель выдаёт весь текст целиком после завершения генерации (представьте ощущение получения сообщения в WeChat); При включении: вывод по символам; можно понимать это так, что большая модель отправляет вам каждый символ сразу после его генерации, пока всё не будет отправлено. {% hint style="info" %} Если некоторые специальные модели не поддерживают потоковый вывод, этот переключатель нужно выключить, например **с самого начала** только не потоковые, вроде o1-mini. {% endhint %} #### **`Пользовательские параметры`** Добавлять в тело запроса (body) дополнительные параметры, например `presence_penalty` и т. п.; обычно большинству людей это не требуется. > Упомянутые выше параметры top-p, max tokens, stream и т. д. — это как раз такие параметры. Способ заполнения: имя параметра — тип параметра (текст, число и т. п.) — значение; справочник:[Нажмите, чтобы перейти](https://openai.apifox.cn/doc-3222739) {% hint style="info" %} У каждого провайдера модели есть свои более или менее уникальные параметры; способ их использования нужно искать в документации провайдера {% endhint %} {% hint style="info" %} * Пользовательские параметры имеют более высокий приоритет, чем встроенные. То есть если пользовательский параметр совпадает со встроенным, пользовательский заменит встроенный. > Например: в пользовательских параметрах установлено `model` для `gpt-4o` после этого в диалоге, независимо от того, какой моделью вы выберете, будет использоваться `gpt-4o` модель. * Использование имя параметра: undefined может исключать параметр. {% endhint %} *** ### Получить помощь и отправить отзыв Если у вас в процессе настройки или использования возникнут какие-либо вопросы, баги или предложения по улучшению функций, пожалуйста, обратитесь к [Отзывы и предложения](/docs/russian/question-contact/suggestions.md) официальным каналам, указанным там. --- # 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/cherry-studio/preview/chat.md?ask=&goal= ``` `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.