Работа с Bot
Быстрый старт помогает запустить Bot; эта страница — о том, как работать с ним хорошо: что делегировать, как формулировать, где должны жить правила и когда один Bot должен стать двумя. Дальше идёт справочник конфигурации: создание Bot и каждая вкладка его страницы деталей.
Что делегировать
Задача хорошо подходит для Bot, когда выполняются три условия:
- Ясный результат. Вы можете сказать, что должно существовать, когда работа закончена, — файл, сообщение, таблица.
- Достижимые источники. Задействованные файлы, сайты или диалоги Bot действительно может достать: они загружены в его рабочее пространство, подключены как канал или сервис либо общедоступны.
- Проверяемый итог. Вы с одного взгляда понимаете, верен ли результат, поэтому проверка остаётся дешёвой.
Даже когда все три условия выполнены, начинайте с режима «только чтение»: пусть Bot сначала читает и организует, просмотрите несколько результатов, затем выдавайте больше.
Сформулируйте запрос
Хороший запрос отвечает на пять вопросов: результат, источник, ограничения, формат, контрольная точка. Таблица — в Быстром старте; вот как разница выглядит на практике.
Расплывчато
Поглядывай за новостями про технологии и присылай мне всё интересное.
Нет источника (какие сайты или репозитории?), нет времени доставки, а «интересное» — суждение, которое Bot должен выносить за вас. Каждый дайджест превращается в подбрасывание монетки.
Вместо этого:
Конкретно
Каждый будний день в 8 утра делай сводку релизов и заметных issue за последние 24 часа по репозиториям, за которыми я слежу, и присылай их мне одним дайджестом. Для каждого пункта указывай источник; если что-то неточно, так и скажи, а не угадывай.
Расплывчато
Приведи эту таблицу в порядок.
«Порядок» не определён: какие строки считать мусорными, можно ли менять исходный файл и что должно вернуться? Bot приходится угадывать трижды, прежде чем начать.
Вместо этого:
Конкретно
Удали из CSV, который я только что загрузил, все строки с пустой колонкой email. Отдай мне очищенный файл и скажи, сколько строк ты удалил. Исходный файл не изменяй.
Общий приём в обеих переработках: назовите источники, ограничьте действия и сделайте результат проверяемым с одного взгляда.
Где живут правила
Два вида указаний — два места:
- Постоянные правила живут в инструкциях Bot на его странице деталей: роль, стандарты формата, постоянные ограничения. Они действуют в каждой будущей сессии.
- Разовые просьбы живут в сообщении: сегодняшний файл, исключение на этой неделе.
Когда исправление должно закрепиться, повысьте его: сформулируйте как долговременное правило и перенесите в инструкции — ровно так, как показывает шаг 7 Быстрого старта. Когда повторяется целый порядок действий, сохраните его как навык, чтобы одна фраза его запускала; предпочтения, которые Bot должен вспоминать сам, отправляйте в память.
Когда разделять Bot
Один Bot — одна задача. Bot с единственной чёткой задачей накапливает контекст, который продолжает ему помогать; Bot «на всё» размывает собственные инструкции и память. И Быстрый старт, и Обзор говорят то же самое, поэтому здесь только практический критерий: если у нового запроса другая аудитория, другие источники или ему нужны другие права, чем у текущей задачи Bot, — создайте второго Bot.
Каждый Bot получает собственные рабочее пространство, память, каналы и границу прав, и Bot не видят друг друга. Разделение к тому же делает права честными: Bot, который только читает заметки о релизах, никогда не нуждается в праве выполнять команды.
Подход к подтверждениям
Давайте уровень, которого требует задача, и не больше: доступ к рабочему пространству разделён на ступени от чата через чтение, запись, выполнение до управления; см. Контроль доступа.
На практике:
- Начинайте новые рутины в режиме «только чтение», а вызовы инструментов записи и выполнения держите за подтверждением.
- Просмотрите первые несколько запусков, прежде чем что-либо расширять.
- Действия, покидающие рабочее пространство, — сообщения другим людям, всё внешнее — держите за подтверждением даже после того, как рутина кажется безопасной.
Арифметика проста: подтвердить несколько запросов стоит куда дешевле, чем отменять ошибочную запись.
Создание Bot
- Перейдите на страницу Bots из боковой панели.
- Нажмите кнопку Create Bot.
- Заполните базовую информацию:
- Display Name: имя, которое пользователи будут видеть в чатах.
- Avatar: URL изображения профиля Bot.
- Timezone: необязательный часовой пояс конкретного Bot. Если оставить пустым, Bot наследует часовой пояс пользователя или системы.
- ACL Preset: стартовая политика доступа, например
allow_allилиprivate_only.
- Нажмите 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 самый важный шаг — настроить его рабочие параметры. Эти настройки разнесены по нескольким вкладкам, а не собраны в одну гигантскую форму.
- Перейдите на страницу Detail Page нужного Bot.
- Начните с вкладки General — привязки чата и рантайма.
- Вкладка Schedule — для повторяющихся автономных задач.
- Вкладка Compaction — для поведения сжатия контекста сессий.
- Вкладка Access — для уточнения правил ACL после начального ACL-пресета.
Если вы ещё не создали эти ресурсы, сначала настройте их:
Справочник вкладки 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
Сжатие здесь — это сжатие контекста сессии, а не обслуживание памяти.
| Поле | Описание |
|---|---|
| Compaction Enabled | Включить или выключить автоматическое сжатие контекста. |
| Compaction Threshold | Оценочный порог в токенах, запускающий сжатие. |
| Compaction Ratio | Насколько агрессивно сокращать контекст сессии. |
| Compaction Model | Необязательная выделенная модель для суммирования старого контекста сессии. |
Вкладка Compaction также показывает журналы сжатия: недавние успешные, ожидающие и неудавшиеся запуски.
О поведении во время работы см. Сжатие контекста.
Доступ и ACL
При создании Bot стартует с ACL Preset. Дальше используйте вкладку Access для тонкого управления.
Важны два слоя:
- ACL Preset даёт разумную стартовую политику для нового Bot.
- ACL Default Effect определяет результат по умолчанию, когда ни одно правило не совпало.
Используйте вкладку Access, чтобы после начальной настройки уточнять правила для диалогов, групп и тредов.
Продвинутые настройки, связанные с Discuss
Большинству пользователей достаточно поведения chat и discuss, описанного в Сессиях.
Если вы управляете настройками Bot через API или собственную автоматизацию, схема настроек также включает discuss_probe_model_id для специфичных конфигураций режима discuss. Считайте это продвинутой настройкой, а не обязательным полем при обычном создании Bot.
Файлы и терминал рабочего пространства
Файлы и терминалы рабочего пространства доступны из интерфейса чат-пространства, когда у Bot есть активный рантайм рабочего пространства. Оттуда можно:
- Просматривать и редактировать файлы в рабочем пространстве Bot.
- Открывать терминальные сессии внутри рантайма рабочего пространства.
- Пользоваться инструментами дисплея/браузера, когда у рабочего пространства Bot включена поддержка дисплея.
О работе с файлами см. Файлы. О браузере с графическим интерфейсом и рабочем столе см. Browser / Computer Use.
Удаление Bot
Чтобы безвозвратно удалить Bot и все связанные с ним данные (включая файлы рабочего пространства и память):
- Перейдите на вкладку General на странице деталей Bot.
- Прокрутите до Danger Zone внизу.
- Нажмите Delete Bot и подтвердите действие.
Внимание: это действие необратимо. Все постоянные данные этого Bot будут потеряны.