---
title: "Настройки"
id: "346"
type: "page"
slug: "settings"
published_at: "2026-05-19T11:30:45+00:00"
modified_at: "2026-11-06T09:29:17+00:00"
url: "https://pastukhov.com/agents/agent/docs/settings/"
markdown_url: "https://pastukhov.com/agents/agent/docs/settings.md"
excerpt: "Настройки — это единый центр управления Pastukhov Agent: здесь решается, как выглядит интерфейс, как ведёт…"
---

# Настройки

[https://pastukhov.com/agents/agent/docs/settings/.md](https://pastukhov.com/agents/agent/docs/settings/.md)

Настройки — это единый центр управления Pastukhov Agent: здесь решается, как выглядит интерфейс, как ведёт себя чат и как агент взаимодействует с внешними сервисами. Центр настроек открывается иконкой-шестерёнкой в шапке приложения. Каждая карточка открывает свой под-диалог поверх него — само окно остаётся открытым позади, поэтому можно переключаться между настройками, не закрывая его. Изменения сохраняются автоматически: отдельная кнопка «Сохранить» не нужна.

## Карта разделов

Карточки сгруппированы в пять групп: **Основное**, **Автоматизация**, **Инструменты**, **Конфигурация** и **Помощь и аккаунт**. У каждой карточки есть название и краткое описание; клик открывает под-диалог.

### Основное (General)

- **Внешний вид** — язык, тема, размер шрифта чата, сведения о лицензии и упрощённый интерфейс;
- **Чат** — отображение сообщений, фильтрация и поведение отправки;
- **Метки чатов** — цветные метки для чатов: создание, изменение и удаление. Подробнее — на странице [Метки чатов](/agents/agent/docs/chat-labels) .
- **Звук** — звуки уведомлений и громкость; у каждого звука своя громкость и кнопка проверки, среди них — отдельный звук автоклика. Отдельный переключатель «Звуки списка чатов» (включён по умолчанию) отвечает за то, слышны ли звуки всех чатов, пока вы находитесь в списке чатов, а не в открытой беседе. Звук звучит один раз, даже если приложение открыто в нескольких вкладках или окон: в остальных окнах он не повторяется, а сильно опоздавший звук (вкладка была в спящем режиме) не играет вовсе;
- **Буфер обмена** — вставка изображений и файлов в чат.

### Автоматизация (Automation)

- **Основной Telegram-бот** — настройка админ-бота со всеми функциями управления;
- **Дополнительные Telegram-боты** — настройка ботов под конкретные задачи с собственными моделями и навыками;
- **Запланированные задачи** — запланированные скрипты и периодические задания;
- **Автоисправление** — показ переключателя автоисправления, исправление в новых чатах или текущем, коммит перед задачей и выбор модели автоисправления;
- **Автоклик** — видимость переключателя автоклика, автонажатие в часы пик, задержка автонажатия и автокоммит;
- **Хуки** — правила запрета и выполнения для вызовов инструментов;
- **MCP-серверы** — добавление и управление MCP-серверами.

### Инструменты (Tools)

- **Аналитика** — статистика использования, токены и расходы;
- **Трафик прокси** — просмотр чатов, проходящих через прокси;
- **SSL-сертификаты** — HTTPS-сертификаты для домена;
- **Распознавание речи** — голосовой ввод с разными движками распознавания. Подробнее — на странице [Голосовой ввод](/agents/agent/docs/speech) .
- **Журналы** — серверные журналы по дням (последние 7 дней, только чтение): выбор дня, последние строки, скачивание файла. Подробнее — на странице [Аналитика и контроль](/agents/agent/docs/validation/analytics-observability) .

### Конфигурация (Configuration)

- **MiniAgent** — три вкладки встроенного бэкенда агента: именованные профили, сервисы загрузки страниц («Fetch-сервисы») и сервисы поиска в интернете («Search-сервисы»). Подробнее — на странице [MiniAgent](/agents/agent/docs/mini-agent) ;
- **Повторить** — интервал и число попыток повторов неудачных запросов к поставщику ИИ. Подробнее — на странице [MiniAgent](/agents/agent/docs/mini-agent) ;
- **Ключи доступа** — именованные ключи для программ и устройств с полным доступом к приложению. Подробнее — на странице [Ключи доступа](/agents/agent/docs/access-keys) ;
- **Модели** — добавление и управление моделями. Подробнее — на странице [Модели](/agents/agent/docs/models) ;
- **Контейнер** — размеры смонтированных папок, загрузка процессора и памяти, время работы контейнера, запросы на перезапуск и пересоздание. Подробнее — в разделе [Контейнер и глобальные переменные](#wp-block-themeisle-blocks-advanced-heading-settings-container) ниже;
- **Навыки** — управление навыками агента. Подробнее — на странице [Навыки](/agents/agent/docs/skills) ;
- **Настройки проекта** — редактирование YAML-файлов конфигурации проекта.

### Помощь и аккаунт (Help & Account)

- **Справка** — открыть документацию;
- **Поддержка** — обратиться в поддержку;
- **Выйти** — выйти из приложения.

## Упрощённый режим

Упрощённый интерфейс включается в карточке «Внешний вид». В этом режиме окно настроек показывает только необходимое: группы **Инструменты** и **Конфигурация** скрываются целиком, из «Автоматизации» пропадают дополнительные Telegram-боты и запланированные задачи, из «Помощи и аккаунта» — справка и поддержка. Остаются внешний вид, чат, звук, буфер обмена, основной Telegram-бот, автоисправление, автоклик, хуки, MCP-серверы и выход из приложения.

## Как хранятся настройки

- Настройки хранятся на сервере парами «ключ-значение» и переживают перезапуск;
- Каждое изменение мгновенно транслируется всем подключённым клиентам через SignalR: в другой открытой вкладке или на другом устройстве настройка обновится сама;
- Размер шрифта чата запоминается на каждом устройстве отдельно, а не на сервере — на каждом устройстве у вас может быть свой;
- Язык интерфейса — «Русский» или «English» — выбирается в карточке «Внешний вид»: он применяется сразу, без перезагрузки страницы, выбор хранится на сервере и переживает перезапуск, и тут же подхватывается в других открытых вкладках. По умолчанию подставляется язык сборки; формат дат и чисел задаётся самой сборкой и от выбранного языка не зависит;
- Часть ключей редактируется вне окна настроек: выбранные модель и навык задаются в поле ввода чата и становятся значениями по умолчанию для новых чатов; настройки очереди промптов — в диалоге [Промпты](/agents/agent/docs/prompts) ;
- Принудительный английский язык ответов (карточка «Хуки») дополнительно синхронизируется в локальный файл настроек Claude проекта.

## Брендинг проекта

Каждый проект несёт небольшой файл `project.yml` с тремя полями: отображаемое название проекта, путь к иконке и ссылка на код. Название используется в шапке, заголовке страницы и установочном манифесте, иконка показывается рядом с ним. Файл создаётся автоматически при первом запуске, а при изменении перечитывается без перезапуска — имя и иконка применяются сразу. Редактируются поля в карточке «Настройки проекта».

## Обновление сервера

Клиент периодически сверяет версию сервера: когда она меняется (после развёртывания), все открытые вкладки перезагружаются автоматически — обновлять страницу вручную не нужно.

## Контейнер и глобальные переменные

Карточка **«Контейнер»** (группа «Конфигурация») отвечает на вопросы, которые обычно требуют доступа к серверу: сколько места занимают папки, не заканчивается ли память, не упирается ли работа в предел процессора. Диалог открывается поверх окна настроек, спрашивать по SSH ничего не нужно.

### Что показывает карточка «Контейнер»

- **Размеры папок** — данных, проекта, домашней папки и временной: сразу видно, что именно растёт и где стоит прибраться. Папка, которой нет в этом развёртывании, честно помечается как отсутствующая, а папка, которую не удалось измерить (обход не успел), — как недоступная;
- **Память и процессор** — текущее потребление и предел, против которого оно измеряется, плюс рабочий набор самого процесса. Если сервер работает не в контейнере, значения берутся из системы, а не выдумываются;
- **Время работы контейнера** и момент, когда снято измерение. Пока диалог открыт, процессор и память обновляются сами; закрыли диалог — опрос прекращается и сервер не тратит время на измерения.

Если развёртывание никем не управляется снаружи, диалог так и говорит: записанные здесь запросы забирать некому. Для обычной установки на своём сервере это нормально — карточка остаётся полезной как измеритель.

### Перезапуск и пересоздание

Внизу диалога две кнопки: **«Перезапустить контейнер»** и **«Пересоздать контейнер»**. Обе сначала просят подтверждение и предупреждают, что все запущенные чаты остановятся; пересоздание дополнительно объясняет, что контейнер будет удалён и создан заново из своего образа — образ скачается повторно, и это дольше перезапуска.

Сам агент ничего не перезапускает: он оставляет запрос в папке `~/global` рядом с контейнером, и его забирает управляющее приложение — обычно в течение 30 секунд. После подтверждения диалог пишет, что запрос записан и контейнер скоро остановится, прекращает обновление измерений и сообщает, что страница перезагрузится сама, когда контейнер вернётся. Если запрос записать не удалось, появится сообщение об ошибке — ложного «успеха» не будет.

### Глобальные переменные

**Глобальные переменные** — это настройки, которые живут не в агенте, а в его окружении: адреса, ключи и любые другие значения, общие для всех агентов и приложений фабрики этого контейнера. Удобно, когда один и тот же адрес или ключ нужен сразу нескольким продуктам и не хочется прописывать его в каждом.

Открыть редактор можно из трёх мест: кнопка **«Глобальные переменные»** в диалоге «Контейнер», пункт с тем же названием в выпадающем списке моделей в поле ввода чата (ниже пункта управления моделями) и кнопка в редакторе модели — слева от «Добавить переменную».

- Редактор — это список строк «имя — значение» с кнопкой **«Добавить переменную»** и удалением каждой строки;
- Строка с пустым значением **удаляет** переменную с таким именем; сохранение пустого списка удаляет все заданные раньше переменные. Строка без имени блокирует сохранение и подсвечивается;
- Кнопки всего две: **«Отмена»** — закрыть ничего не записав, и **«Сохранить и перезапустить»** — записать список и закрыть редактор;
- Редактор намеренно односторонний: он всегда открывается пустым и прежние значения не показывает. Так сделано потому, что после сохранения файл с переменными забирает управляющее приложение и удаляет его — показывать было бы нечего. Значения, которые уже действуют, смотрите там, где вы их задавали;
- После сохранения переменные применяются ко всем агентам и приложениям фабрики контейнера, а сами они пересоздаются — обычно в течение 30 секунд.

## Связанные страницы

- [Промпты](/agents/agent/docs/prompts) — очередь сохранённых запросов с автоотправкой;
- [Модели](/agents/agent/docs/models) — пиковые часы и индикатор в поле ввода;
- [MiniAgent](/agents/agent/docs/mini-agent) — профили встроенного агента;
- [Ключи доступа](/agents/agent/docs/access-keys) — ключи для программ и устройств вместо одного общего;
- [Голосовой ввод](/agents/agent/docs/speech) — движки распознавания речи;
- [Навыки](/agents/agent/docs/skills) — управление навыками;
- [Хуки](/agents/agent/docs/hooks) — правила безопасности и поведения.

**← Назад:** [Git](/agents/agent/docs/git)

**Далее:** [Навыки](/agents/agent/docs/skills)
 →