---
url: /ru/guides/working-with-bots.md
---
# Работа с Bot

[Быстрый старт](./quick-start.md) помогает запустить Bot; эта страница — о том, как работать с ним хорошо: что делегировать, как формулировать, где должны жить правила и когда один Bot должен стать двумя. Дальше идёт справочник конфигурации: создание Bot и каждая вкладка его страницы деталей.

## Что делегировать

Задача хорошо подходит для Bot, когда выполняются три условия:

* **Ясный результат.** Вы можете сказать, что должно существовать, когда работа закончена, — файл, сообщение, таблица.
* **Достижимые источники.** Задействованные файлы, сайты или диалоги Bot действительно может достать: они загружены в его рабочее пространство, подключены как канал или сервис либо общедоступны.
* **Проверяемый итог.** Вы с одного взгляда понимаете, верен ли результат, поэтому проверка остаётся дешёвой.

Даже когда все три условия выполнены, начинайте с режима «только чтение»: пусть Bot сначала читает и организует, просмотрите несколько результатов, затем выдавайте больше.

## Сформулируйте запрос

Хороший запрос отвечает на пять вопросов: результат, источник, ограничения, формат, контрольная точка. Таблица — в [Быстром старте](./quick-start.md#шаг-4-даите-ему-задачу); вот как разница выглядит на практике.

::: warning Расплывчато

> Поглядывай за новостями про технологии и присылай мне всё интересное.
> :::

Нет источника (какие сайты или репозитории?), нет времени доставки, а «интересное» — суждение, которое Bot должен выносить за вас. Каждый дайджест превращается в подбрасывание монетки.

**Вместо этого:**

::: tip Конкретно

> Каждый будний день в 8 утра делай сводку релизов и заметных issue за последние 24 часа по репозиториям, за которыми я слежу, и присылай их мне одним дайджестом. Для каждого пункта указывай источник; если что-то неточно, так и скажи, а не угадывай.
> :::

::: warning Расплывчато

> Приведи эту таблицу в порядок.
> :::

«Порядок» не определён: какие строки считать мусорными, можно ли менять исходный файл и что должно вернуться? Bot приходится угадывать трижды, прежде чем начать.

**Вместо этого:**

::: tip Конкретно

> Удали из CSV, который я только что загрузил, все строки с пустой колонкой email. Отдай мне очищенный файл и скажи, сколько строк ты удалил. Исходный файл не изменяй.
> :::

Общий приём в обеих переработках: назовите источники, ограничьте действия и сделайте результат проверяемым с одного взгляда.

## Где живут правила

Два вида указаний — два места:

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

Когда исправление должно закрепиться, повысьте его: сформулируйте как долговременное правило и перенесите в инструкции — ровно так, как показывает шаг 7 [Быстрого старта](./quick-start.md#шаг-7-проверьте-результат-и-закрепите-правила). Когда повторяется целый порядок действий, сохраните его как [навык](./skills.md), чтобы одна фраза его запускала; предпочтения, которые Bot должен вспоминать сам, отправляйте в [память](./memory.md).

## Когда разделять Bot

Один Bot — одна задача. Bot с единственной чёткой задачей накапливает контекст, который продолжает ему помогать; Bot «на всё» размывает собственные инструкции и память. И [Быстрый старт](./quick-start.md), и [Обзор](./overview.md) говорят то же самое, поэтому здесь только практический критерий: если у нового запроса другая аудитория, другие источники или ему нужны другие права, чем у текущей задачи Bot, — создайте второго Bot.

Каждый Bot получает собственные рабочее пространство, память, каналы и границу прав, и Bot не видят друг друга. Разделение к тому же делает права честными: Bot, который только читает заметки о релизах, никогда не нуждается в праве выполнять команды.

## Подход к подтверждениям

Давайте уровень, которого требует задача, и не больше: доступ к рабочему пространству разделён на ступени от чата через чтение, запись, выполнение до управления; см. [Контроль доступа](./access.md).

На практике:

1. Начинайте новые рутины в режиме «только чтение», а вызовы инструментов записи и выполнения держите за подтверждением.
2. Просмотрите первые несколько запусков, прежде чем что-либо расширять.
3. Действия, покидающие рабочее пространство, — сообщения другим людям, всё внешнее — держите за подтверждением даже после того, как рутина кажется безопасной.

Арифметика проста: подтвердить несколько запросов стоит куда дешевле, чем отменять ошибочную запись.

***

## Создание Bot

1. Перейдите на страницу **Bots** из боковой панели.
2. Нажмите кнопку **Create Bot**.
3. Заполните базовую информацию:
   * **Display Name**: имя, которое пользователи будут видеть в чатах.
   * **Avatar**: URL изображения профиля Bot.
   * **Timezone**: необязательный часовой пояс конкретного Bot. Если оставить пустым, Bot наследует часовой пояс пользователя или системы.
   * **ACL Preset**: стартовая политика доступа, например `allow_all` или `private_only`.
4. Нажмите **Create**.

***

## Страница Detail Page

После создания щелчок по карточке Bot ведёт на его страницу **Detail Page**, где весь его жизненный цикл управляется через специализированные вкладки.

### Обзор вкладок

| Вкладка | Описание |
|-----|-------------|
| **Overview** | Проверки состояния: рантайм рабочего пространства, база данных, каналы, память. |
| **General** | Основные настройки: модели чата/заголовков/изображений, привязки памяти/поиска/TTS, часовой пояс, язык, рассуждение и опасная зона. |
| **Desktop** | Рантайм дисплея рабочего пространства, доступность браузера с графическим интерфейсом (headed) и активные сессии дисплея. |
| **Workspace** | Жизненный цикл контейнерного рабочего пространства, снапшоты, экспорт и импорт данных. |
| **Network** | Сеть рабочего пространства и статус/действия overlay-провайдера. |
| **Memory** | Просмотр, поиск, создание, правка и сжатие воспоминаний. |
| **Platforms** | Конфигурации каналов: Telegram, Discord, Feishu, QQ, WeCom, WeChat, DingTalk, Web и другие. |
| **Access** | Правила ACL и поведение доступа по умолчанию. |
| **Tool Approval** | Настройки подтверждения человеком для инструментов, требующих согласия. |
| **Agents** | ACP-совместимые агенты для программирования, такие как Codex и Claude Code, которые можно включить для использования в чат-пространстве. |
| **Connectors** | Подключения сторонних сервисов (OAuth или API-ключ) через Connect-It: статус, включение/выключение, повторная авторизация, отключение. |
| **Hooks** | Правила автоматизации уровня Bot, хранящиеся в `/data/.memoh/hooks.json`. |
| **MCP** | Управление подключениями MCP (Stdio, Remote, OAuth). |
| **Compaction** | Настройки сжатия контекста сессий и журналы. |
| **Schedule** | Задачи по cron-расписанию и журналы выполнения. |
| **Skills** | Markdown-файлы навыков, задающие характер и возможности Bot. |

Files, Terminal и панели рабочего стола/браузера доступны также внутри чат-пространства — используйте сторону рабочего пространства в чате, когда хотите посмотреть файлы, выполнить команды оболочки или понаблюдать за браузером и рабочим столом Bot, не покидая диалог.

***

## Настройка основных параметров Bot

После создания Bot самый важный шаг — настроить его рабочие параметры. Эти настройки разнесены по нескольким вкладкам, а не собраны в одну гигантскую форму.

1. Перейдите на страницу **Detail Page** нужного Bot.
2. Начните с вкладки **General** — привязки чата и рантайма.
3. Вкладка **Schedule** — для повторяющихся автономных задач.
4. Вкладка **Compaction** — для поведения сжатия контекста сессий.
5. Вкладка **Access** — для уточнения правил ACL после начального ACL-пресета.

Если вы ещё не создали эти ресурсы, сначала настройте их:

* [Провайдеры и модели](../integrations/providers/llm.md)
* [Встроенный провайдер памяти](../integrations/providers/memory/builtin.md)
* [Провайдеры поиска](../integrations/providers/web-search.md)
* [Agents / ACP](./acp.md)

***

## Справочник вкладки General

Вкладка **General** содержит настройки, определяющие повседневное поведение в диалоге.

| Поле | Описание |
|-------|-------------|
| **Chat Model** | Основная LLM для генерации ответов в чате. |
| **Title Model** | Необязательная модель для генерации заголовков сессий. |
| **Image Generation Model** | Необязательная модель для функций генерации изображений. Выберите модель чата с поддержкой `image-output`. |
| **Memory Provider** | Бэкенд памяти, назначенный Bot. Встроенный провайдер может дополнительно определять собственные модели памяти и эмбеддингов. |
| **Search Provider** | Поисковая система для возможностей веб-поиска. |
| **TTS Model** | Необязательная речевая модель для синтеза речи. Речевые модели приходят из потока настройки TTS-провайдеров, а не из обычного потока провайдеров чата. |
| **Timezone** | Часовой пояс конкретного Bot. Если пусто, Memoh наследует часовой пояс пользователя, а если и он не задан — системный. |
| **Language** | Основной язык общения Bot. |
| **Reasoning Effort** | Доступно, когда выбранная модель чата объявляет совместимость `reasoning`. Варианты зависят от модели (например `low`, `medium`, `high`). |

Примечания:

* **Image Generation Model** намеренно отделена от обычной модели чата, чтобы модель с поддержкой изображений можно было выделить только под задачи визуальной генерации.
* **TTS Model** приходит со страницы настроек **Speech** и использует модели `speech` настроенного речевого провайдера.
* `context_window` выбранной модели чата влияет на отчёт о статусе сессии и [сжатие контекста](./compaction.md).

***

## Справочник вкладки Compaction

Сжатие здесь — это **сжатие контекста сессии**, а не обслуживание памяти.

| Поле | Описание |
|-------|-------------|
| **Compaction Enabled** | Включить или выключить автоматическое сжатие контекста. |
| **Compaction Threshold** | Оценочный порог в токенах, запускающий сжатие. |
| **Compaction Ratio** | Насколько агрессивно сокращать контекст сессии. |
| **Compaction Model** | Необязательная выделенная модель для суммирования старого контекста сессии. |

Вкладка **Compaction** также показывает журналы сжатия: недавние успешные, ожидающие и неудавшиеся запуски.

О поведении во время работы см. [Сжатие контекста](./compaction.md).

***

## Доступ и ACL

При создании Bot стартует с **ACL Preset**. Дальше используйте вкладку **Access** для тонкого управления.

Важны два слоя:

* **ACL Preset** даёт разумную стартовую политику для нового Bot.
* **ACL Default Effect** определяет результат по умолчанию, когда ни одно правило не совпало.

Используйте вкладку **Access**, чтобы после начальной настройки уточнять правила для диалогов, групп и тредов.

***

## Продвинутые настройки, связанные с Discuss

Большинству пользователей достаточно поведения `chat` и `discuss`, описанного в [Сессиях](./sessions.md).

Если вы управляете настройками Bot через API или собственную автоматизацию, схема настроек также включает `discuss_probe_model_id` для специфичных конфигураций режима discuss. Считайте это продвинутой настройкой, а не обязательным полем при обычном создании Bot.

***

## Файлы и терминал рабочего пространства

Файлы и терминалы рабочего пространства доступны из интерфейса чат-пространства, когда у Bot есть активный рантайм рабочего пространства. Оттуда можно:

* Просматривать и редактировать файлы в рабочем пространстве Bot.
* Открывать терминальные сессии внутри рантайма рабочего пространства.
* Пользоваться инструментами дисплея/браузера, когда у рабочего пространства Bot включена поддержка дисплея.

О работе с файлами см. [Файлы](./files.md). О браузере с графическим интерфейсом и рабочем столе см. [Browser / Computer Use](./browser-computer-use.md).

***

## Удаление Bot

Чтобы безвозвратно удалить Bot и все связанные с ним данные (включая файлы рабочего пространства и память):

1. Перейдите на вкладку **General** на странице деталей Bot.
2. Прокрутите до **Danger Zone** внизу.
3. Нажмите **Delete Bot** и подтвердите действие.

> **Внимание**: это действие необратимо. Все постоянные данные этого Bot будут потеряны.