3. Конфигурация сервера

🔵 Платформу настраивают два файла: config/server.yaml (ядро, провайдер, логирование, auth, виджет) и config/budgets.yaml (бюджетные группы и привязка шаблонов). Расписания — в config/cron.yaml, слежение за изменениями — в config/monitors.yaml, воркфлоу — в config/workflows/. Секреты — только в .env.

3.1 Источник конфига — локальная папка или git-репозиторий

Всё дерево конфига (server.yaml, agents/, web/, workflows/, budgets.yaml, cron.yaml, monitors.yaml) грузится из одного корня. По умолчанию это локальная ./config; вместо неё можно клонировать git-репозиторий, чтобы конфиг версионировался и ревьюировался отдельно от бинарника.

Приоритет: CLI-флаг → переменная окружения → локальный ./config.

AGENT_OS_CONFIG_REPO=https://github.com/org/agent-config \
AGENT_OS_CONFIG_REF=v1.2.0 \
./agent_web_bot

Репозиторий клонируется (shallow) в ~/.agent-os/configs/<repo>-<ref> и фиксируется на разрешённом коммите; SHA коммита пишется в лог при старте и виден на /health в поле config. Секреты в конфиг-репозитории не хранятся — только ссылки на имена переменных из .env.

3.2 config/server.yaml

provider — LLM

provider:
  base_url: "https://api.deepseek.com"   # любой OpenAI-совместимый endpoint
  model: "deepseek-v4-flash"
  api_key: ""                            # опционально; предпочтительно .env
  pricing:                               # оценка стоимости инференса
    prompt_per_million: 0.14
    cached_per_million: 0.014
    completion_per_million: 0.28

Порядок выбора ключа: provider.api_key → AGENT_OS_API_KEY → DEEPSEEK_API_KEY. Пусто везде → агенты отвечают симулированными ответами.

models — именованные модели

Дополнительные конфиги моделей: каждый становится отдельным провайдером со своим base_url / api_key / model / pricing. Шаблон агента выбирает нужную полем model: в своём agent.yaml. provider: выше — это дефолт (он же регистрируется как "default").

models:
  cheap:
    base_url: "https://api.deepseek.com"
    model: "deepseek-chat"
  strong:
    base_url: "https://api.openai.com/v1"
    model: "gpt-4o"
    api_key: ""

kernel — планировщик и сессии

kernel:
  scheduler: round_robin
  concurrency_limit: 3
  live_reload: true
  session_ttl_secs: 300
  session_cleanup_interval_secs: 60

logging — логи и хранилища

logging:
  filter: "agent_os=debug"
  jsonl_dir: "logs"
  duckdb_path: "logs/events.db"
  messages_db_path: "logs/messages.db"
  messages_retention_days: 30
  state_db_path: "logs/state.db"
  temp_dir: "logs/temp"
  access_db_path: "logs/access.db"
  cron_db_path: "logs/cron.db"
  user_db_path: "logs/users.db"
  monitor_db_path: "logs/monitors.db"
  workflow_db_path: "logs/workflows.db"
  bench_db_path: "logs/bench.db"

auth — админ-API и web-логин

auth:
  admin_token_env: ""              # имя env-переменной с токенами (опционально)
  admin_tokens:                    # карта имя → токен (или { token, templates })
    admin: "<token>"
    drom-op:
      token: "<token>"
      templates: [drom-agent]
  users:                           # web-логин: логин → пароль (или { password, templates })
    admin: "<password>"
    drom-viewer:
      password: "<password>"
      templates: [drom-agent]
  web_user_secret_env: ""          # env с HMAC-секретом для токенов конечных пользователей

• admin_tokens — карта имя → токен. Имя пишется в access-лог (для аудита), сам токен никогда не логируется. Значение — либо голый токен (полный доступ), либо объект { token, templates }, ограничивающий принципала перечисленными шаблонами.
• admin_token_env (опционально) — имя env-переменной, чьё значение может быть списком через запятую / ; / перевод строки, каждый элемент имя=токен либо голый токен (имя выводится из отпечатка). Такие токены — всегда полный доступ.
• users — карта логин → пароль для страницы /login; выдаёт session-cookie для админ-UI (/sessions, /budgets). Cookie HttpOnly, живёт 12 часов, имя пользователя пишется в access-лог. Значение — голый пароль или { password, templates }.
• Пустые карты + пустой env = auth выключен (админ-API открыт — только для dev).
• Auth настроен, но ни один токен/пользователь не разрешается → админ-API fails closed (401).

web_user_secret_env — имя env-переменной с HMAC-секретом для подписи токенов идентичности конечных пользователей (POST /v1/user-ticket). Если пусто, сервер сам генерирует и хранит секрет в data/web_user_secret — идентичность подписывается HMAC по умолчанию. Подробности — в 08-http-api.

Админ-эндпоинты принимают либо Authorization: Bearer <токен>, либо cookie agentos_session.

widget — встраиваемый виджет

widget:
  default_model: "drom-agent"   # агент по умолчанию

Единственная серверная настройка — default_model: агент, к которому виджет обращается, когда модель не задана явно. Полный разбор виджета (встраивание, порядок выбора модели, демо, визуальные блоки) — в §19.

proxy — ограничения HTTP-прокси

proxy:
  allow_hosts: []   # пусто = любой публичный хост

/proxy и /proxy/content всегда блокируют приватные, loopback, link-local и reserved-диапазоны (включая 169.254.169.254) на каждом редиректе. allow_hosts дополнительно ограничивает по хосту (точное совпадение или поддомен).

inbound — входящий webhook

inbound:
  token_env: ""   # env с bearer-токеном для POST /v1/inbound/:template (пусто = открыто, dev)

POST /v1/inbound/:template — внешние системы запускают один ход агента синхронно. См. 08-http-api.

3.3 config/budgets.yaml

budget_groups:
  - name: my-shared
    refill_per_sec: 50
    max_bucket: 50000
    max_total: 5000000        # null/отсутствует = без лимита
    per_user:                 # опционально
      refill_per_sec: 20
      max_bucket: 20000
      max_total: 500000
    per_session:              # опционально
      refill_per_sec: 30
      max_bucket: 10000
      max_total: 200000

agents:
  - template: my-agent        # перекрывает budget_group / budget из agent.yaml
    group: my-shared
    budget:                   # опционально
      refill_per_sec: 10
      max_bucket: 200
      max_total: 1000

• Группы создаются сразу при старте (не лениво) и видны на /budgets.
• agents: привязывает шаблон (по name) к группе и/или перекрывает его бюджет.
• Перекрытия из budgets.yaml выигрывают у значений из agent.yaml.
• Проверяются при каждом входе в тёрн сверху вниз: группа → per_user → per_session. Исчерпанный уровень показывается сообщением из budget_messages.* агента.

Поля бюджета

3.4 Запланированные задания (config/cron.yaml)

Cron запускает шаблон агента по расписанию. Задаются в двух местах, оба hot-reload'ятся:

• на агента — список cron: в config/agents/<agent>/agent.yaml (template по умолчанию = сам агент);
• глобально — config/cron.yaml, где каждое задание явно называет template:

jobs:
  - name: morning-digest
    template: rss
    schedule: "0 0 9 * * *"      # sec min hour dom month dow (UTC)
    prompt: "Резюмируй сегодняшние новости."
    notify: [{ type: log }]

Каждое задание задаёт ровно одно из schedule / interval_secs / oneshot_at и доставляет результат в список notify-sink'ов (log, webhook, telegram, messages_db, agent, email, workflow). История — в logs/cron.db, эндпоинт GET /v1/cron. Полный справочник — 11-cron-jobs.

3.5 Change-мониторы (config/monitors.yaml)

Монитор — это pull-триггер: следит за внешним источником и запускает ход агента только при появлении новых элементов (в отличие от cron, который стреляет по расписанию независимо). Источник изменений подключаемый (сейчас — rss).

monitors:
  - name: news-watch
    source:
      type: rss
      url: "https://lenta.ru/rss"
    template: rss-agent
    prompt: "Кратко резюмируй эти новые статьи:\n{{items}}"
    notify: [{ type: telegram, chat_id: 123456 }]
    poll_secs: 300

Монитор хранит курсор в logs/monitors.db: первый опрос только «догоняет» (сохраняет курсор, ничего не запускает), дальше запускается только на элементах новее курсора.

3.6 Переменные окружения

.env подхватывается автоматически при старте (dotenv). Он в .gitignore, шаблон — .env.example.

3.7 Live reload

При kernel.live_reload: true (по умолчанию) сервер следит за config/:

• config/agents/** — новые сессии получают новые инструкции; инструменты и хуки перерегистрируются и действуют со следующего вызова.
• config/web/** — markdown-сайт перерендеривается на лету.
• config/server.yaml — не применяется на лету; нужен рестарт.

3.8 Логирование HTTP-запросов

Каждый HTTP-запрос (метод, путь, статус, длительность, IP клиента, user-agent, X-User-Id, имя админ-токена) пишется в logs/access.jsonl и logs/access.db (оба отключаются пустой строкой в соответствующем поле logging). Значение токена не логируется — только его имя или пометка invalid.