Агент
Агенты позволяют ИИ не только вести диалог, но исамостоятельно выполнять задачи。
Аналогия:
ИИ в обычном диалоге похож на коллегу, который может только давать советы — вы спрашиваете, как это сделать, а он говорит вам шаги
Агент похож на коллегу, который умеет действовать — вы задаёте цель, а он самостоятельно читает файлы, ищет материалы, вызывает инструменты и шаг за шагом выполняет её
Примеры сценариев применения:
«Собрать
~/Downloadsвсе PDF в Excel-список»«Запросить главные новости сегодняшних ведущих технологических медиа и составить сводку из 5 пунктов»
«Проверить указанный файл Python, дать рекомендации по улучшению и сразу внести правки»
«Автоматически выполнять вышеуказанные задачи каждый день в 9:00 утра» (в сочетании с планировщик задач）
Рекомендуем сначала прочитать Введение в концепции Разберём связь между ассистентом / агентом / навыками / MCP / каналами.
Две подготовки перед началом
1. Провайдер, поддерживающий протокол Anthropic
Агенты используют формат диалога с «вызовом инструментов»; на данный момент наиболее зрелая реализация — модели серии Anthropic Claude. Поэтому нужен провайдер моделей, поддерживающий этот протокол; рекомендуемые варианты:
CherryIN(самый удобный): один аккаунт одновременно поддерживает и обычный диалог, и агента
Официальный Anthropic: напрямую использовать аккаунт Claude
Другие популярные AI-шлюзы (например, OpenRouter）
2. Включить API-сервер
Cherry Studio нужно запустить локальную внутреннюю службу для работы Agent. На практике достаточно в Настройки → API-сервер нажать кнопку запуска, подробнее см. API-сервер。
Подсказка по расходу токенов: режим Agent включает многократные диалоги и вызовы инструментов, поэтому расход токенов за одну задачу заметно выше, чем в обычном чате. Рекомендуется задать месячный лимит в панели провайдера, чтобы избежать перерасхода.
Шаг 1: настройте провайдера типа Anthropic
Открыть Настройки → Сервис моделейнайдите (или создайте) провайдера, поддерживающего Anthropic endpoint:
Заполните Ключ API
Подтвердите API-адрес должен указывать на правильный Anthropic endpoint (по умолчанию CherryIN
https://open.cherryin.cc）Нажмите Получить список моделей, добавьте как минимум одну модель для диалога (например,
claude-sonnet-4/agent/deepseek-v4-proи т. д.)
Пользователи, оформившие подписку на Claude Code, могут напрямую указать Anthropic key и endpoint в соответствующих полях, чтобы получить модель.
Шаг 2: включите API-сервер
Открыть Настройки → API-серверпроверьте порт и ключ, затем нажмите ▶ Запустить. Подробности см. API-сервер。
Шаг 3: перейдите на страницу агента
Нажмите сверху на вкладку агента. В Cherry Studio по умолчанию встроены Cherry Assistant и Cherry Claw два агента, их можно использовать сразу или создать свой под свои нужды.
Шаг 4: создайте нового агента
Нажмите в верхней части левой панели + Агент кнопку, появится Добавить Agent форма:
Описание полей:
Название
Отображаемое имя Agent в списке
Модель
Выберите модель диалога, добавленную на прошлом шаге у провайдера типа Anthropic
автономный режим
Отдельный переключатель. При включении активируется рабочее пространство soul.md с настраиваемой идентичностью, автоматически подключаются инструменты управления задачами и отключаются интерактивные инструменты, не подходящие для работы без присмотра.канал и планировщик задач Требуется включить этот пункт и установить режим прав в полностью автоматический режим
Режим прав
Управляет тем, нужно ли вручную подтверждать вызов инструментов агентом; см. таблицу ниже. По умолчанию обычный режим
Рабочий каталог
Локальный каталог, который Agent может читать и записывать. Если оставить пустым, будет автоматически создан каталог по умолчанию
После заполнения нажмите Добавить — создание завершено.
Шаг 5: настройте промпт, инструменты и навыки агента
Нажмите справа от карточки агента меню ⋮ → Редактироватьчтобы открыть полный экран редактирования:
Категории вкладок слева соответствуют разным настройкам:
Базовые настройки: аватар, имя, модель, рабочий каталог, автономный режим, включение heartbeat, интервал heartbeat, описание
Настройки промпта: редактирование системного промпта, определяющего роль и стиль общения Agent
Режим прав: переключение между 4 политиками прав (см. таблицу ниже)
Инструменты: отметьте встроенные инструменты, которыми может пользоваться Agent, и подключите внешние инструменты из MCP-серверов внешние инструменты
Навыки: подключение предварительно установленных Навыки
Дополнительные настройки: два параметра — максимальное число ходов диалога и переменные окружения
4 варианта режима прав
обычный режим(по умолчанию)
может свободно читать файлы; перед редактированием файлов или выполнением команд будет запрошено ручное подтверждение
Повседневный диалоговый агент
Режим планирования
может только читать файлы и строить план, но не может редактировать или выполнять команды
пусть Agent предложит вам «план», а вы будете выполнять его сами
Режим авто-редактирования
может свободно читать и писать файлы; перед выполнением команд всё равно будет запрошено подтверждение
пусть Agent возьмёт на себя редактирование кода / документов, но вы сохраните контроль над командами
Полностью автоматический режим
все инструменты доступны без ручного подтверждения
Для каналов и расписанных задач необходимо использовать этот режим и одновременно включить автономный режим; полностью автоматический сценарий самостоятельного принятия решений
Полностью автоматический режимзаставит Agent пропускать все ручные подтверждения, включая запись файлов, выполнение команд, вызов внешних API и т. д.Включайте только в контролируемой средеи ограничьте Рабочий каталог рамками, которые вы готовы разрешить Agent изменять.
Автономный режим vs режим прав：
автономный режим определяет, может ли Agent войтив форму «без присмотра, длительная задача» (загрузка soul.md, подключение инструментов управления задачами)
Режим прав определяет, может ли Agent какобрабатывать подтверждения вызова инструментов
Оба независимы. Чтобы Agent автоматически запускал задачи по расписанию и отправлял их в группу Feishu, нужно:включить автономный режим + выбрать полностью автоматический режим。
Шаг 6: общение с агентом
Вернитесь на страницу агента и нажмите на карточку агента, чтобы войти в сеанс:
В нижнем поле ввода введите задачу, например: «Помоги мне преобразовать
~/Downloads/report.mdв план PPT»Agent сам определит, какие инструменты вызывать и нужен ли многоходовый вывод
Процесс вызова инструментов и принятия решений отображается постепенно в виде сворачиваемых карточек
Отображение результата
Частые вопросы
На странице агента появляется подсказка «Пожалуйста, включите API-сервер, чтобы использовать функции агента»
Вернитесь Настройки → API-сервери нажмите зелёную кнопку ▶ Запустить. Подробнее см. API-сервер。
В выпадающем списке при создании Agent нет модели
Убедитесь, что у выбранного провайдера добавлена как минимум одна модель для диалога
Убедитесь, что тип этого провайдера — Anthropic или CherryIN(провайдеры только для OpenAI не будут отображаться в выборе моделей Agent)
Вывод Agent внезапно остановился
Возможно, достигнут лимит вызовов инструментов или лимит длины одного сеанса. Увеличьте в настройках Agent максимальное число ходов и лимит токенов одного вывода.
Далее
Подключите Agent к IM-платформе (Feishu / Telegram / QQ / WeChat / Discord / Slack) → канал
Позвольте Agent автоматически выполнять задачи по расписанию → планировщик задач
Расширьте возможности инструментов → Руководство по использованию MCP
💡 Получить помощь и отправить отзыв
Если вы в процессе настройки или использования столкнётесь с любыми вопросами, багами или предложениями по улучшению функций, пожалуйста, обратитесь к Обратная связь и предложения официальным каналам, указанным там.
Последнее обновление
Это было полезно?