> 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/advanced-basic/agent-channels.md). # Канал Когда вы настроили в Cherry Studio агента (например, «робота для аналитических отчётов», «ассистента службы поддержки»), и если хотите, чтобы он**оставался в IM-группе**для обслуживания нескольких пользователей можно использовать функцию «каналы». **Канал**Подключить [Агент](/docs/russian/cherry-studio/preview/agent.md) **к IM-платформе**и предоставлять услуги внешним пользователям как бот. Поддерживаемые на данный момент платформы: * Feishu / Lark (китайская и международная версии) * Telegram * QQ (официальный API бота) * WeChat (через iLink Bot API) * Discord * Slack Примеры сценариев применения: * **Внутренний корпоративный бот знаний**: участник группы Feishu @-упоминает бота и задаёт вопрос, он из привязанного [База знаний](/docs/russian/knowledge-base/knowledge-base.md) находит ответ * **Личный помощник**: бот в личном чате Telegram помогает управлять расписанием, искать информацию, выполнять перевод * **Дежурство службы поддержки**: бот Discord встречает пользователей по заданным сценариям > Рекомендуем сначала прочитать [Введение в концепции](/docs/russian/advanced-basic/concepts-101.md) Понять связь между агентом, каналами и запланированными задачами. ## Не хотите настраивать сами? Пусть AI настроит за вас Функция каналов включает несколько шагов: «создать бота на сторонней платформе → получить учётные данные → ввести их в Cherry Studio», и для нетехнических пользователей это довольно сложно.**Если вы не знакомы с этими действиями, самый простой способ — передать задачу напрямую агенту с автономными правами (например, встроенному Cherry Claw)**. Достаточно описать свою цель в окне диалога Cherry Claw, например: > Пожалуйста, помоги мне настроить канал: каждый день в 10 утра своди AI-новости из изданий Huxiu, 36Kr и Jiqizhixin в 5 ключевых пунктов и отправляй их в мой Feishu. Cherry Claw автоматически определит, что нужно сделать, запросит у вас необходимые учётные данные (например, App ID Feishu), а затем поможет вам завершить создание канала и [плановые задачи](/docs/russian/advanced-basic/scheduled-tasks.md) настройку. {% hint style="warning" %} **Основные предварительные условия**: * Встроенный **Cherry Claw** и созданный вами агент по умолчанию находятся в состоянии **«автономный режим выключен + обычный режим»**. * **Перед использованием канала (или запланированной задачи) необходимо вручную открыть панель редактирования этого агента и включить «автономный режим»**. * После включения «автономного режима» нижележащее разрешение на вызов инструментов будет полностью автоматически взято на себя, а прежняя настройка «режима прав» будет скрыта, больше не нужно задавать её вручную. См. [Агент](/docs/russian/cherry-studio/preview/agent.md). {% endhint %} Если вы хотите узнать подробности каждого шага или нужна настройка под себя, продолжайте по ручному процессу ниже. ## Процесс ручной настройки ### Предварительные требования 1. Создан [Агент](/docs/russian/cherry-studio/preview/agent.md) 2. Включён [API-сервер](/docs/russian/advanced-basic/api-server.md) 3. **Получить учётные данные бота для целевой IM-платформы**(см. ниже «Подготовка учётных данных по платформам»; названия у платформ разные, по сути это выданные официально платформой token / key для проверки идентичности бота) ### Где находятся каналы Откройте `Настройки → Каналы`, можно увидеть список всех поддерживаемых платформ:

Меню каналов: у каждой платформы есть строка с кратким описанием; если не привязано, справа отображается пустое состояние

### Создать канал (на примере Feishu) 1. В левом списке нажмите **Feishu** 2. В правой части пустого состояния нажмите **+ Добавить**, появится форма добавления:

Поля канала Feishu

Значение каждого поля: | Поле | Описание | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------ | | **Название** | Отображаемое имя канала, чтобы легче различать его при наличии нескольких каналов | | **Привязать Agent** | Выберите уже созданного Cherry Agent. Если не привязывать, ответы будет давать универсальная модель | | **App ID / секрет приложения** | Открытая платформа Feishu → Собственное приложение → Учётные данные и базовая информация | | **Ключ шифрования / токен проверки** | Открытая платформа Feishu → Подписка на события, необязательно | | **Домен** | `Feishu (Китай)` / `Lark (международная версия)`, выберите один из двух | | **Разрешённый ID чата** | Оставьте пустым, чтобы не ограничивать; если заполнить, отвечать будет только в указанной группе/личном чате | | **Режим прав канала** | `Наследовать настройки агента` / пользовательский. Рекомендуется оставить наследование | После заполнения нажмите **Сохранить**. После включения канала он автоматически начнёт подписываться на события сообщений Feishu. ### Подготовка учётных данных по платформам {% tabs %} {% tab title="Feishu / Lark" %} **Есть два способа подключения, рекомендуется способ со сканированием QR-кода**: * **Регистрация через сканирование QR-кода (рекомендуется)**: в деталях канала Feishu оставьте пустым **App ID / секрет приложения**, после включения канала автоматически появится QR-код. Отсканируйте его в мобильном Feishu, и приложение бота будет создано автоматически,**без ручной настройки в открытой платформе**. * **Ручное подключение (для продвинутых)**: * В [открытой платформе](https://open.feishu.cn) создайте **собственное приложение** * Скопируйте **App ID** и **App Secret** введите в форму * В приложении Feishu в разделе **Подписка на события** включите постоянное соединение (WebSocket) * В **Управление правами** включите как минимум: получение сообщений из личных чатов, получение сообщений из групповых чатов, отправка сообщений {% endtab %} {% tab title="Telegram" %} * и [@BotFather](https://t.me/BotFather) в диалоге,`/newbot` создайте бота * Скопируйте **Bot Token** * Достаточно ввести Bot Token в форму * (необязательно) Если хотите ограничить ответы только некоторыми диалогами, сначала добавьте бота в группу или личный чат, затем используйте [@get\_id\_bot](https://t.me/get_id_bot) получите Chat ID и введите его в «Разрешённый ID чата» {% endtab %} {% tab title="QQ" %} * На открытой платформе QQ подайте заявку на бота → создайте приложение → скопируйте **App ID** и **Client Secret** * введите в форму * (необязательно) Формат разрешённого ID чата:`c2c:openid`(личный чат),`group:groupid`(группа),`channel:channelid`(канал) {% endtab %} {% tab title="WeChat" %} * **Способ подключения канала WeChat — вход через сканирование QR-кода**, предварительная регистрация не требуется: * В деталях канала нажмите **Добавить аккаунт WeChat** * После включения канала появится QR-код * Отсканируйте его в мобильном WeChat, чтобы войти * (необязательно) Формат разрешённого ID пользователя:`wxid_xxxxx`, несколько значений разделяйте запятыми {% endtab %} {% tab title="Discord" %} * В [Discord Developer Portal](https://discord.com/developers/applications) Создать новое Application * Сгенерируйте на вкладке Bot **Bot Token** и введите в форму * Пригласите бота на свой сервер * (необязательно) Если хотите ограничить область канала: после добавления бота в целевой канал отправьте ему `/whoami` и вы получите корректный ID канала {% endtab %} {% tab title="Slack" %} * В [Slack API](https://api.slack.com/apps) Создать App * Включите **Socket Mode**, затем сгенерируйте соответственно **App-Level Token**(`xapp-...`) и **Bot Token**(`xoxb-...`) * Оба токена введите в форму * (необязательно) Ограничение области канала: отправьте боту `/whoami` получить ID канала Slack {% endtab %} {% endtabs %} ### Может ли один Agent подключаться к нескольким каналам? Да. Вы можете подключить одного и того же агента «ассистент по отчётам» одновременно к внутренней группе Feishu (для отчётов коллегам) и к своему личному чату Telegram (для личных уведомлений), и они не будут мешать друг другу. У каждого канала отдельно ведутся сеансы и права. ### Связь с запланированными задачами * Канал может **получать** сообщения пользователя, вызывающие ответ Agent * [плановые задачи](/docs/russian/advanced-basic/scheduled-tasks.md) может **активно** вызывать Agent и через канал отправлять результат на IM-платформу * Комбинация обоих вариантов позволяет реализовать полноценный формат «бота ежедневных отчётов» ### Частые вопросы #### После добавления бот не реагирует * Проверьте [API-сервер](/docs/russian/advanced-basic/api-server.md) находится в **состоянии работы** статусе * Убедитесь, что у привязанного Agent достаточно баланса у провайдера модели * Проверьте, не ошиблись ли вы в «Разрешённом ID чата» (пустое поле означает без ограничений) #### Бот Feishu добавлен в группу, но не получает @-сообщения * На открытой платформе Feishu → Управление правами убедитесь, что включено «Получать все сообщения в группах» * В группе щёлкните правой кнопкой по боту → Настройки и включите «Бота можно @-упоминать в этой группе» #### Канал WeChat отключается * Подключение бота WeChat относительно нестабильно, рекомендуется в первую очередь использовать Feishu / Telegram * При длительном отсутствии использования WeChat может принудительно отключить его; достаточно снова войти в iLink {% hint style="warning" %} У разных платформ разные требования к соответствию для собственных ботов. Перед включением во внутренней корпоративной группе убедитесь, что вы получили разрешение своей организации / платформы. {% 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/advanced-basic/agent-channels.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.