---
title: "Настройки в файлах"
id: "2047"
type: "page"
slug: "config"
published_at: "2026-09-28T03:48:43+00:00"
modified_at: "2026-09-28T03:56:14+00:00"
url: "https://pastukhov.com/agents/news/docs/config"
markdown_url: "https://pastukhov.com/agents/news/docs/config.md"
excerpt: "Настройки «Новостного агента» — не спрятанный где-то внутренний файл, а понятная папка с текстовыми файлами…"
---

# Настройки в файлах

[https://pastukhov.com/agents/news/docs/config.md](https://pastukhov.com/agents/news/docs/config.md)

Настройки «Новостного агента» — не спрятанный где-то внутренний файл, а понятная папка с текстовыми файлами рядом с проектом. Это самая практичная часть продукта: папку можно положить в систему контроля версий, скопировать на другой сервер целиком и посмотреть глазами, что настроено.

## Где лежат настройки

Все настройки живут в одной папке проекта, по умолчанию — `/project/apps/news`. Каждое изменение — это правка одного небольшого файла. Переезд на другой сервер — это копирование папки: ничего не нужно восстанавливать из резервной копии базы.

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

## Восемь разделов

- **Настройки** — общие: язык, часовой пояс, почтовый сервер, ограничения ИИ, адрес для ссылок.
- **Источники** — откуда собираем: сайты, ленты, каналы, поисковые запросы.
- **Мониторы** — за чем именно следим и при каком изменении бьём тревогу.
- **Правила** — что делать с какими событиями.
- **Оповещения** — кого и куда будить, с какими ограничениями от шума.
- **Каналы** — адреса доставки: почта, Telegram, Slack и остальные.
- **Дайджесты** — расписания подборок: что и когда собирать в одну сводку.
- **Публикация** — цели публикации и их стиль: куда и как публиковать.

В некоторых разделах файлов может быть много — по одному на источник или правило. Это нормально: один файл — одна сущность, так проще править и обсуждать.

## Подсказки прямо в папках

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

Отдельная документация настройщику не нужна: справочник живёт рядом с настройками и обновляется вместе с ними.

## Изменения на лету

Правка подхватывается за секунды — перезапуск не нужен. Изменили расписание или порог, и продукт уже работает по-новому.

Если файл написан с ошибкой, продукт не падает: продолжает работать по последней удачной версии и показывает, что именно не так. Новостное наблюдение не встанет из-за лишней кавычки.

## Проверка при записи

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

Проверка идёт по тем же правилам для всех: и для источника, и для правила, и для оповещения. Опечатка не превращается в молчаливо неработающее наблюдение.

## Копии и журнал

Каждая правка через агента сохраняется: остаётся прежняя версия файла и запись о том, что изменилось. Поэтому можно вернуться на шаг назад — например, если после новой настройки посыпались лишние оповещения.

Копии хранятся в папке данных, а не в папке настроек: они содержат настоящие секреты и поэтому в файловом менеджере не показываются.

## Секреты

- **При чтении секреты маскируются** — токены, пароли и адреса с ключами заменяются на «***». Ни в интерфейсе, ни в ответе агента настоящих секретов не видно.
- **При записи секрет можно не повторять** — если отправить обратно «***», продукт оставит прежнее значение.
- **Копии настроек содержат секреты как есть** — поэтому они лежат в папке данных и недоступны через файловый менеджер.

## Два способа правки

- **Через агента** — с проверкой, копией и журналом. Обычный путь; ничего дополнительно делать не нужно.
- **Прямо на диске** — быстрее, если вам так удобнее, но без проверки, без копии и без записи в журнал. Правка подхватится на лету, однако отвечать за опечатку придётся самому.

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

Дальше → [Управление агентом по API](/agents/news/docs/api)

[← Оглавление документации](/agents/news/docs)