Справочник настроек

Здесь перечислены все настройки, которые оператор может изменить на сервере AiHummer. Страница собирается из каталога самого продукта, поэтому совпадает с вашим сервером. Значение задаётся в веб-интерфейсе или командой `aihummer settings set KEY VALUE` ([Командная строка](/v1.4/reference/cli/)). В колонке значения по умолчанию — то, что использует сервер, пока своё значение не задано. > [!NOTE] > Значения секретов здесь не печатаются, а служебные ключи вендора не перечислены вовсе — продукт скрывает их из всех списков. Прочерк означает пустое значение или пояснение, которое показывается только в веб-интерфейсе. ## API | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_PERSONAL_API_KEYS` | Персональные API-ключи для OpenAI-совместимого API | `bool` | `1` | после перезапуска | «off» отключает аутентификацию по персональным ключам на OpenAI-совместимом эндпоинте. Любое другое значение = включено. Применяется при старте/после рестарта. | ## Agent | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AGENT_ANNOUNCE_SLOW_TOOLS` | Агент: предупреждать о долгих действиях | `bool` | `1` | сразу | Перед долгим действием (картинка, глубокий поиск, видео, поручение субагенту) агент коротко пишет, что делает, чтобы ожидание не было молчаливым. Выключите, если такие сообщения мешают. | | `AIHUMMER_AGENT_COMPACT_AT_PCT` | Агент: сжимать историю при заполнении, % её места | `int 50…99` | `85` | сразу | Когда история разговора займёт столько процентов отведённого ей места в окне модели, старые реплики сворачиваются в сводку — фоном, после ответа, ход не ждёт. Ниже — сжатие чаще, но модель дословно помнит меньше; выше — реже, но ходы тяжелее. 50–99; у агента можно задать своё значение. | | `AIHUMMER_AGENT_COMPACT_TO_PCT` | Агент: оставлять после сжатия, % места истории | `int 10…90` | `50` | сразу | Сколько процентов места истории остаётся дословным после сжатия; всё, что старше, уходит в сводку. Должно быть ниже порога сжатия: запас между ними — сколько ходов пройдёт до следующего сжатия. 10–90; у агента можно задать своё значение. | | `AIHUMMER_AGENT_HISTORY_TURNS` | Агент: ходов диалога дословно | `int 1…1000` | `30` | сразу | Сколько последних ходов разговора модель видит дословно (до 10 больше, пока не пора сжимать). Более ранние реплики сворачиваются в сводку фоном, сама переписка не удаляется. Окно модели учитывается само. 1–1000; у агента можно задать своё значение. | | `AIHUMMER_AGENT_MAX_ITERATIONS` | Агент: максимум шагов инструментов за ход | `int 1…256` | `25` | сразу | Сколько раз за один ход агент может вызвать инструменты, прежде чем ответить. На пределе ход не падает: агент отвечает, что успел и что осталось, и его можно попросить продолжить. Повтор одного и того же вызова с тем же результатом три раза подряд останавливает ход раньше. 1–256; у агента можно задать своё значение. | | `AIHUMMER_AGENT_MEMORY_FLUSH` | Агент: заметка в память перед сжатием | `bool` | `1` | сразу | Перед тем как свернуть старые реплики в сводку, агент записывает в память короткую заметку о целях, решениях и незакрытых делах. Выключите, чтобы не тратить на это вызов модели. | | `AIHUMMER_AGENT_MEMORY_FLUSH_PROMPT` | Агент: что записывать в заметку перед сжатием | `text` | — | сразу | Своё задание для заметки перед сжатием: что сохранить из реплик, которые уходят в сводку (например, «записывай только покупки, сроки и договорённости»). Пусто — встроенное: цели, решения, незакрытые дела. Защита не отключается: текст разговора остаётся данными, а не указаниями, пароли и ключи не записываются. До 4000 символов; у агента можно задать своё. | | `AIHUMMER_AGENT_NEW_REMINDERS_MEMORY` | Новые агенты: напоминания и запись в память | `bool` | `1` | сразу | Новый агент, созданный вручную (мастер первого запуска, «Создать агента», API), с первого хода сам ставит, меняет и отменяет СВОИ напоминания и расписания и сам записывает факты в свою память — как шаблон личного помощника. Каждому агенту это выключается в карточке («Возможности»). Шаблоны библиотеки задают своё, копия агента несёт права оригинала, агенты, созданные другим агентом, начинают без этих прав; существующие агенты не меняются. Действует для следующего созданного агента. | | `AIHUMMER_AGENT_PROMPT_PART_MAX_CHARS` | Агент: предел символов на часть промпта | `int 1000…1000000` | `20000` | сразу | Сколько символов модель получает от ОДНОЙ части личности агента: раздела профиля, части промпта или основного промпта. Длиннее — сохраняются начало (3/4) и конец (1/4) с пометкой, сколько обрезано; это видно в карточке разговора и в составе промпта агента. Имя, обращение и ограничения персоны не обрезаются никогда. 1000–1000000; у агента можно задать своё значение. | | `AIHUMMER_AGENT_PROMPT_TOTAL_MAX_CHARS` | Агент: общий предел символов личности | `int 1000…2000000` | `60000` | сразу | Общий потолок личности агента: все части вместе. Если он превышен, место уступают самые длинные части, короткие остаются целыми. 1000–2000000; у агента можно задать своё значение. | | `AIHUMMER_AGENT_SELF_INTRO` | Агент: представляться | `enum: first_contact \\\| each_dialog \\\| never` | `first_contact` | сразу | «Один раз, при первом знакомстве» — агент коротко представляется в самом первом разговоре с человеком, если тот не просит сразу к делу; со знакомым человеком заново не представляется и отвечает на приветствие естественно. «Не представляться» — агент никогда не называет себя сам. «В начале каждого нового разговора» — агент коротко представляется в каждом новом разговоре и после долгой паузы, без сводки прошлых дел. У агента может быть свой выбор в карточке («Контекст и поведение»). | | `AIHUMMER_AGENT_SESSION_IDLE_RESET_MINUTES` | Агент: начинать разговор заново после тишины (минуты) | `int 0…525600` | `360` | сразу | Для режимов «после тишины» и «каждый день и после тишины»: если человек пишет после тишины дольше этого, агент начинает разговор заново. Действует для агентов, у которых в карточке не задано своё значение. 0 — не по тишине. 0–525600; 360 = 6 часов, 1440 = сутки. | | `AIHUMMER_AGENT_SESSION_INDEX_MAX_ENTRIES` | Агент: держать в списке не больше стольких сессий | `int 0…100000` | `0` | сразу | Сколько разговоров самое большее держит список сессий агента; первыми уходят самые тихие, ничего не удаляется. 0 — без предела. 0–100000. Действует для агентов, у которых в карточке не задано своё. | | `AIHUMMER_AGENT_SESSION_INDEX_PRUNE_DAYS` | Агент: убирать из списка сессий после стольких дней тишины | `int 0…3650` | `0` | сразу | Разговор, в котором человек молчит дольше этого, уходит из списка сессий агента; ничего не удаляется, с новым сообщением разговор возвращается. 0 — не убирать. 0–3650. Действует для агентов, у которых в карточке не задано своё. | | `AIHUMMER_AGENT_SESSION_RESET_AT_HOUR` | Агент: час ежедневного начала заново | `int 0…23` | `4` | сразу | Для режимов «ежедневно» и «ежедневно и после тишины»: разговор, начатый раньше этого часа, со следующей реплики человека начинается заново. Час — по часовому поясу сервера (настройка «Часовой пояс» в «Системе и настройках»). 0–23; 4 — ночью, когда почти никто не пишет. | | `AIHUMMER_AGENT_SESSION_RESET_GROUP_IDLE_MINUTES` | Агент: начинать общий чат заново после тишины (минуты) | `int 0…525600` | `0` | сразу | Для общих чатов в режимах «после тишины» и «каждый день и после тишины»: сколько минут тишины, после которых общий чат начинается заново. 0 — как для личных чатов. 0–525600. | | `AIHUMMER_AGENT_SESSION_RESET_GROUP_MODE` | Агент: когда общий чат начинается заново | `enum: inherit \\\| daily \\\| idle \\\| both \\\| none` | `inherit` | сразу | Отдельное правило для общих чатов (группы Telegram, беседы VK, чаты MAX и другие): как для личных, каждый день в час сброса, после тишины, что наступит раньше, или никогда. Час сброса — общий. Действует для агентов, у которых в карточке не задано своё правило. | | `AIHUMMER_AGENT_SESSION_RESET_MODE` | Агент: когда разговор начинается заново | `enum: idle \\\| daily \\\| both \\\| none` | `idle` | сразу | Когда агент начинает разговор заново: каждый день в час сброса (по часовому поясу инстанса), после тишины, что наступит раньше, или никогда. Начиная заново, агент пишет заметку о прошлом разговоре в свою память, а первый ход получает прежнюю сводку и последние реплики; сами реплики остаются в архиве и в поиске. Действует для агентов, у которых в карточке нет своего правила; для общих чатов там можно задать отдельное. | | `AIHUMMER_AGENT_SESSION_SCOPE` | Агент: куда складываются личные разговоры | `enum: chat \\\| per-channel-peer \\\| per-peer` | `chat` | сразу | Куда складываются личные разговоры агента: свой разговор на каждый чат канала; свой на каждого человека в каждом канале; или один разговор с человеком во всех каналах (Telegram, приложение и другие личные чаты одного человека сводятся в один). Общие чаты всегда остаются своими. Действует со следующего сообщения для агентов, у которых в карточке не выбрано своё. | | `AIHUMMER_AGENT_SILENT_REPLY` | Агент: может промолчать | `enum: groups \\\| all \\\| off` | `groups` | сразу | В общих чатах агент может промолчать, если сообщение обращено не к нему или ему нечего добавить; в личной переписке он отвечает всегда. Можно разрешить молчание и в личной переписке или выключить его. Промолчавший ход ничего не отправляет, в карточке разговора он помечен «агент промолчал», а модель не видит его в истории. Действует со следующего хода. | | `AIHUMMER_AGENT_SKILLS_PROMPT_MAX_CHARS` | Агент: предел символов списка навыков в промпте | `int 1000…200000` | `18000` | сразу | В каждом ходе модель видит не тексты навыков, а их список: идентификатор, название и когда применять; инструкцию навыка агент загружает сам, когда задача подходит. Если список длиннее, сначала убираются описания, затем хвост списка — остальные навыки агент найдёт по запросу. 1000–200000. | | `AIHUMMER_AGENT_STALE_GAP_HOURS` | Агент: перерыв, после которого прошлый разговор — история (часы) | `int 0…8760` | `12` | сразу | Если человек пишет после перерыва дольше этого, агент получает пометку: всё, что обсуждалось раньше, — история, её не пересказывают и прежние задачи не продолжают без просьбы. Каждое сообщение и так несёт время и сколько прошло с прошлого. 0 — не помечать. 0–8760. | | `AIHUMMER_AGENT_TOOL_HISTORY_TURNS` | Агент: ходы, в которых помнятся результаты инструментов | `int 0…100` | `5` | сразу | У скольких последних ходов модель видит вызовы инструментов и их результаты целиком (результат — до 16 КБ). У более старых ходов остаются вызов и начало результата. Так агент помнит, что нашёл и что сделал, а не зовёт инструменты заново. 0 — не переносить результаты в следующие ходы. 0–100; у агента можно задать своё значение. | | `AIHUMMER_APPROVAL_TOOLS` | Инструменты, требующие подтверждения | `multiselect` | — | сразу | Список инструментов через запятую, вызов которых требует ручного подтверждения оператором перед выполнением. Пусто = подтверждение не требуется. Действует сразу, перезапуск не нужен. | | `AIHUMMER_SUBAGENT_MAX_DEPTH` | Максимальная глубина суб-агентов | `int 0…10` | `2` | сразу | Максимальная глубина вложенности суб-агентов (агент, запускающий агента). По умолчанию 2 — защита от бесконечной рекурсии. | | `AIHUMMER_SUBAGENT_TIMEOUT_SEC` | Таймаут суб-агента (секунды) | `int 0…86400` | `180` | сразу | Максимальное время одного запуска суб-агента, секунды. | | `AIHUMMER_TOOL_SEARCH` | Ленивая загрузка инструментов | `bool` | `false` | сразу | Рабочее ядро инструментов показывается модели сразу, а остаток большого каталога прячется за инструментом поиска, который называет каждый скрытый инструмент. Окупается только на больших каталогах (десятки инструментов плагинов, MCP или OpenAPI): ниже порога размера все инструменты показываются сразу, потому что лишний заход модели на поиск дороже самих схем. Действует со следующего хода. | | `AIHUMMER_TOOL_SEARCH_CORE` | Ленивая загрузка: всегда включённые инструменты | `multiselect` | `web_search,web_fetch,memory_search,memory_get,memory_store,search_history,search_knowledge,code_exec,process,filesystem_read,message,schedule_list,schedule_create,schedule_delete,generate_pairing_code` | сразу | Инструменты, которые в ленивом режиме всегда видны модели сразу. По умолчанию — рабочее ядро: поиск в интернете, чтение страниц, память, история переписки, база знаний, код, файлы, сообщения, расписания и привязка приложения. Поиск по памяти и базе знаний (memory_search, memory_get, search_knowledge) виден всегда, что бы ни было в этом списке. Пустой список возвращает это ядро. | | `AIHUMMER_TOOL_SEARCH_MIN_POOL_TOKENS` | Ленивая загрузка: минимальный объём скрытых инструментов (токены) | `int 0…1000000` | `4000` | сразу | Прятать инструменты, только если схемы вне ядра весят не меньше стольких токенов (около 4 символов каждый). Ниже порога все инструменты показываются сразу: лишний заход модели на поиск инструмента дороже, чем показать схемы. | | `AIHUMMER_TOOL_SEARCH_THRESHOLD` | Ленивая загрузка: минимум инструментов для отсрочки | `int 0…1000` | `12` | сразу | Откладывать загрузку, только если после фильтра профиля агента остаётся больше этого числа инструментов. | ## Agent · Reasoning | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AGENT_BEST_OF_N` | Лучший из N: число вариантов | `int 0…8` | `0` | сразу | Агент готовит столько вариантов ответа и оставляет лучший. 0 или 1 — выключено, от 2 — включено. Каждый вариант стоит как отдельный ответ. | | `AIHUMMER_AGENT_DEBATE_JUDGE_PROMPT` | Дебаты: промпт судьи (переопределение) | `text` | — | сразу | Переопределяет промпт судьи дебатов (пусто = встроенный). | | `AIHUMMER_AGENT_DEBATE_N` | Дебаты: число вариантов ответа | `int 0…8` | `0` | сразу | Агент готовит столько вариантов ответа, сверяет их между собой и выдаёт лучший. 0 или 1 — выключено, от 2 — включено. Каждый вариант стоит как отдельный ответ. | | `AIHUMMER_AGENT_DEBATE_PROMPT` | Дебаты: промпт кандидата (переопределение) | `text` | — | сразу | Переопределяет промпт кандидата в дебатах (пусто = встроенный). | | `AIHUMMER_AGENT_DEBATE_ROUNDS` | Дебаты: раунды | `int 1…10` | `1` | сразу | Число раундов дебатов панели кандидатов. | | `AIHUMMER_AGENT_JUDGE_PROMPT` | Промпт судьи best-of-N (переопределение) | `text` | — | сразу | Переопределяет промпт судьи best-of-N (пусто = встроенный). | | `AIHUMMER_AGENT_PLAN_PROMPT` | Промпт планировщика (переопределение) | `text` | — | сразу | Переопределяет промпт планировщика (пусто = встроенный). | | `AIHUMMER_AGENT_PLAN_STEPS` | Планировщик-исполнитель: макс. шагов плана (0=выкл.) | `int 0…32` | `0` | сразу | ⟩0 запускает отдельный проход планировщик→исполнитель→синтез (полезно для сложных многошаговых задач). 0 = выключено. Обычно 4–8. | | `AIHUMMER_AGENT_PLAN_STEP_ITERS` | Планировщик: итераций инструментов на шаг (0=по умолчанию) | `int 0…64` | `0` | сразу | Ограничивает число итераций вызова инструментов на шаг плана. 0 = встроенное значение по умолчанию (4). | | `AIHUMMER_AGENT_REFLECT` | Проход само-критики | `bool` | `0` | сразу | Добавляет проход рефлексии/само-критики перед финальным ответом. | | `AIHUMMER_AGENT_REFLECT_PROMPT` | Промпт рефлексии (переопределение) | `text` | — | сразу | Переопределяет промпт само-критики (пусто = встроенный). | | `AIHUMMER_AGENT_SELF_HEAL` | Само-восстановление: повторы при ошибках инструментов (0=выкл.) | `int 0…10` | `0` | сразу | ⟩0 повторяет неудавшиеся вызовы инструментов с корректирующей подсказкой, вплоть до этого предела. | ## Agent · System prompt | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_LOCALE` | Локаль по умолчанию | `enum: ru-RU \\\| en-US \\\| az-AZ \\\| hy-AM \\\| be-BY \\\| kk-KZ \\\| ky-KG \\\| tg-TJ \\\| tk-TM \\\| uz-UZ \\\| ka-GE \\\| ro-RO \\\| es-ES \\\| zh-CN \\\| fr-FR \\\| de-DE \\\| hi-IN \\\| pl-PL \\\| lt-LT \\\| lv-LV \\\| et-EE \\\| fi-FI \\\| sv-SE \\\| no-NO \\\| da-DK \\\| tr-TR \\\| mn-MN` | `ru-RU` | сразу | Язык/локаль ответа по умолчанию, напр. ru-RU. Инструкции персоны/оператора имеют приоритет. | | `AIHUMMER_TIMEZONE` | Часовой пояс | `text` | `UTC` | сразу | Часовой пояс IANA для текущей даты у агента и для расписаний без своего пояса, напр. Europe/Moscow. По умолчанию UTC. | ## Channels | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_CHANNEL_FAILURE_NOTICE` | Сообщать собеседнику об отказе ответа | `enum: always \\\| once \\\| off` | `always` | сразу | Что получает собеседник в канале (Telegram и другие), когда агент не смог ответить: «Каждый раз» — короткое сообщение на его языке; «Не чаще раза в 4 часа» — одно сообщение на разговор за 4 часа; «Не сообщать» — ничего. В сообщении нет кодов ошибок и названий поставщиков; подробности вы видите в «Сессиях» и уведомлениях. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BLOCKED` | Текст об отказе: инстанс приостановлен | `text` | — | сразу | Оставьте пустым — уйдёт встроенное сообщение на языке собеседника. Ваш текст уходит как написан, на том языке, на котором вы его написали; {ref} подставляет код ответа, по которому ход находится в «Сессиях». Применяется сразу. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BUDGET` | Текст об отказе: исчерпан бюджет | `text` | — | сразу | Оставьте пустым — уйдёт встроенное сообщение на языке собеседника. Ваш текст уходит как написан, на том языке, на котором вы его написали; {ref} подставляет код ответа, по которому ход находится в «Сессиях». Применяется сразу. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BUSY` | Текст об отказе: шлюз перегружен | `text` | — | сразу | Оставьте пустым — уйдёт встроенное сообщение на языке собеседника. Ваш текст уходит как написан, на том языке, на котором вы его написали; {ref} подставляет код ответа, по которому ход находится в «Сессиях». Применяется сразу. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_CONFIG` | Текст об отказе: подключение модели требует владельца | `text` | — | сразу | Оставьте пустым — уйдёт встроенное сообщение на языке собеседника. Ваш текст уходит как написан, на том языке, на котором вы его написали; {ref} подставляет код ответа, по которому ход находится в «Сессиях». Применяется сразу. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_FAILED` | Текст об отказе: иной сбой | `text` | — | сразу | Оставьте пустым — уйдёт встроенное сообщение на языке собеседника. Ваш текст уходит как написан, на том языке, на котором вы его написали; {ref} подставляет код ответа, по которому ход находится в «Сессиях». Применяется сразу. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_QUOTA` | Текст об отказе: исчерпан лимит модели | `text` | — | сразу | Оставьте пустым — уйдёт встроенное сообщение на языке собеседника. Ваш текст уходит как написан, на том языке, на котором вы его написали; {ref} подставляет код ответа, по которому ход находится в «Сессиях». Применяется сразу. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_STEP_LIMIT` | Текст об отказе: задача не уместилась в один ответ | `text` | — | сразу | Оставьте пустым — уйдёт встроенное сообщение на языке собеседника. Ваш текст уходит как написан, на том языке, на котором вы его написали; {ref} подставляет код ответа, по которому ход находится в «Сессиях». Применяется сразу. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_TOO_LONG` | Текст об отказе: разговор не помещается в модель | `text` | — | сразу | Оставьте пустым — уйдёт встроенное сообщение на языке собеседника. Ваш текст уходит как написан, на том языке, на котором вы его написали; {ref} подставляет код ответа, по которому ход находится в «Сессиях». Применяется сразу. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_UNAVAILABLE` | Текст об отказе: модель временно недоступна | `text` | — | сразу | Оставьте пустым — уйдёт встроенное сообщение на языке собеседника. Ваш текст уходит как написан, на том языке, на котором вы его написали; {ref} подставляет код ответа, по которому ход находится в «Сессиях». Применяется сразу. | | `AIHUMMER_CONFIDENTIAL_PERSONA` | Конфиденциальная веб-персона | `bool` | `0` | сразу | Когда включено, веб-чат-агент не раскрывает и не сохраняет данные своей персоны/личности и отвечает строго по задаче — для анонимных или приватных веб-развёртываний. Действует сразу, перезапуск не нужен. | | `AIHUMMER_INBOUND_COALESCE_MS` | Окно склейки сообщений (мс) | `int` | `500` | сразу | Несколько сообщений, которые человек отправляет в один чат подряд (короткие сообщения, альбом фото, быстрое исправление), получают ОДИН ответ, если пауза между ними короче этого окна. На сообщения, пришедшие, пока готовится ответ, бот отвечает сразу после него, а не параллельно. По умолчанию 500 мс; 0 — без ожидания между отдельными сообщениями; альбом фото всё равно собирается (паузы до 3 с, не дольше 20 с), чтобы получить один ответ. Склейка работает в Telegram; Slack, WhatsApp, VK, почта и другие коннекторы, которые ждут ответа на каждое сообщение (и интеграции через /v1/inbound/generic), получают ответ на каждое — по-прежнему по одному и по порядку. Применяется сразу. | | `AIHUMMER_INBOUND_EDIT_MODE` | Когда человек правит сообщение, на которое уже ответили | `enum: correct \\\| history` | `correct` | сразу | correct — бот отвечает ещё раз, зная, что это исправление («было / стало»); history — правка только исправляет историю разговора, нового ответа нет (удобно для опечаток). Правка сообщения, на которое бот ещё не ответил, всегда просто подменяет его текст. Работает там, где канал сообщает о правках (Telegram). Применяется сразу. | | `AIHUMMER_INBOUND_QUEUE_MODE` | Сообщения, написанные, пока агент работает | `enum: steer \\\| collect \\\| followup` | `steer` | сразу | Что происходит с сообщением, которое тот же человек пишет, пока агент ещё готовит ответ (ищет, запускает инструменты): steer (по умолчанию) — агент видит его перед следующим шагом и учитывает в том же ответе; collect — на него отвечает следующий ответ. followup — на каждое такое сообщение — свой ответ, по очереди. Фото, файлы, ответы на сообщение и пересылки всегда ждут следующего ответа. Применяется сразу. | | `AIHUMMER_INBOUND_REQUIRE_BINDING` | Отвечать только зарегистрированным пользователям | `bool` | `true` | сразу | true = бот игнорирует любого отправителя в канале, который НЕ является заведённым пользователем AiHummer (пользователь с привязкой роли) — случайные участники чата и гостевые вызовы не получают ответа. false (по умолчанию) = отвечать всем. | ## Integrations | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_A2A_PUBLISH` | Публиковать агента через Agent2Agent (A2A) | `bool` | `0` | после перезапуска | Опубликовать агента как A2A-сервер (Agent Card + POST /a2a/message). Применяется при старте/после рестарта. | | `AIHUMMER_MCP_EXPORT_TOOLS` | Инструменты, открытые внешним ассистентам | `multiselect` | — | после перезапуска | Явный список имён инструментов, разрешённых внешним MCP-клиентам, через запятую. Пусто = не публиковать ни одного инструмента. Опасные host-level классы дополнительно запрещены встроенной политикой, даже если перечислены. Применяется при старте/после рестарта. | | `AIHUMMER_MCP_PUBLISH` | Публиковать инструменты через MCP | `bool` | `0` | после перезапуска | Разрешает внешним ассистентам (например, Claude Desktop) пользоваться инструментами ваших агентов. Какие именно инструменты открыть, выбирается в соседней настройке: пока список пуст, не открывается ни один. | | `AIHUMMER_MODULE_CPU_QUOTA` | Предел процессора плагина (на каждый) | `text` | `75%` | сразу | Какую долю процессора может занять каждый плагин (systemd CPUQuota): 75% — три четверти одного ядра, 150% — полтора ядра. Новое значение плагин получает при следующей установке, обновлении или сохранении его настроек; работающие плагины до этого живут с прежним пределом. | | `AIHUMMER_MODULE_MEMORY_MAX` | Предел памяти плагина (на каждый) | `text` | `512M` | сразу | Сколько памяти может занять каждый плагин (systemd MemoryMax): размер вроде 512M, 1G или 2048M (не меньше 64M) либо infinity — без предела. Плагин, превысивший предел, система остановит. Новое значение плагин получает при следующей установке, обновлении или сохранении его настроек; работающие плагины до этого живут с прежним пределом. | ## Knowledge connectors | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_KB_SYNC_INTERVAL` | Как часто обновлять базу знаний из источников | `text` | — | сразу | Как часто сервер сам забирает изменения из подключённых источников базы знаний. Например: 30m — каждые 30 минут, 6h — каждые 6 часов. Пусто или 0 — только вручную. Повторная загрузка не создаёт дублей. Выгрузку Slack загружают вручную. | ## LLM | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AUX_FALLBACK_MODELS` | Служебные задачи: запасные модели | `list` | — | сразу | Модели через запятую — по порядку пробуются, если служебная модель отказала (квота, сбой). Последней всегда пробуется основная модель, чтобы сводка не потерялась. Каждое переключение пишется в журнал. Действует сразу. | | `AIHUMMER_AUX_MODEL` | Модель для служебных задач (сводки, заметки, заголовки) | `text` | — | сразу | Модель фоновых служебных задач: сжатие старой истории в сводку, заметка в память перед сжатием, заголовки бесед, извлечение фактов, перефразировка поисковых запросов и перевод. Пусто = автоматически: более дешёвая модель того же поставщика (Claude → claude-haiku-4-5, Codex → gpt-…-luna/mini из каталога учётной записи); если такой нет — основная модель. «main» — всегда основная модель. Действует сразу. | | `AIHUMMER_CASCADE_MIN_CHARS` | Каскад: минимум символов для эскалации | `int` | `0` | сразу | Порог длины запроса (символы), с которого включается сильная модель каскада. 0 = по умолчанию. | | `AIHUMMER_CASCADE_STRONG_MODEL` | Каскад: более сильная запасная модель | `text` | — | сразу | Модель, на которую каскадно переключаемся для длинных/сложных запросов (пусто = выключено). | | `AIHUMMER_CLAUDE_AUTH_URL` | Подписка Claude: адрес страницы входа | `text` | — | сразу | Страница, на которой вы разрешаете подключить подписку Claude. Пусто — стандартный адрес; менять нужно, только если об этом попросила поддержка. | | `AIHUMMER_CLAUDE_CLIENT_ID` | Подписка Claude: идентификатор клиента OAuth | `text` | — | сразу | Идентификатор приложения для входа по подписке Claude. Пусто — стандартный; менять нужно, только если об этом попросила поддержка. | | `AIHUMMER_CLAUDE_EFFORT` | Claude: глубина размышлений | `enum: low \\\| medium \\\| high \\\| xhigh \\\| max` | `medium` | сразу | Насколько глубоко модели Claude размышляют перед ответом, если у агента глубина не задана. Выше — точнее на сложных задачах, но дольше и дороже; ниже — быстрее и экономнее. Модель, которая не знает выбранного уровня, получает ближайший меньший; Haiku 4.5 и старые модели размышлений не поддерживают. Глубина, заданная у агента, главнее. Действует со следующего хода. | | `AIHUMMER_CLAUDE_MAX_TOKENS` | Claude: наибольшая длина ответа (токенов) | `int` | `16000` | сразу | Сколько токенов может занять один ответ Claude — и по подписке, и по ключу. Размышления модели входят в этот же предел: слишком малое значение обрывает ответ на полуслове или даёт пустой ответ. Если у агента задана своя длина ответа, действует она. | | `AIHUMMER_CLAUDE_REDIRECT_URI` | Подписка Claude: URI перенаправления | `text` | — | сразу | Адрес возврата, зарегистрированный у поставщика. Должен совпадать с тем, что настроен на его стороне, иначе обмен кода отвергается. | | `AIHUMMER_CLAUDE_TOKEN_URL` | Подписка Claude: адрес получения доступа | `text` | — | сразу | Адрес, по которому сервер получает и продлевает доступ к подписке Claude. Пусто — стандартный адрес; менять нужно, только если об этом попросила поддержка. | | `AIHUMMER_CODEX_BASE_URL` | Базовый URL Codex | `text` | — | частично после перезапуска | База Codex (ChatGPT-subscription) транспорта. Применяется при старте/после рестарта. | | `AIHUMMER_CODEX_MAX_OUTPUT_TOKENS` | Макс. выходных токенов (0 = без ограничения) | `int` | `0` | сразу | Ограничение max_output_tokens для чат-хода. 0 = без ограничения. У reasoning-моделей токены рассуждений тоже считаются в этот бюджет, поэтому слишком малое значение даёт пустой ответ «incomplete: max_output_tokens». Применяется на лету (без рестарта). | | `AIHUMMER_CODEX_MODEL` | Идентификатор модели (транспорт Codex / gpt-5.5) | `text` | `gpt-5.5` | частично после перезапуска | Идентификатор модели основного транспорта Codex/ChatGPT (напр. gpt-5.5, gpt-5.5-codex). Применяется при старте/после рестарта. | | `AIHUMMER_CODEX_REASONING_EFFORT` | Глубина рассуждений | `enum: none \\\| low \\\| medium \\\| high \\\| xhigh` | `medium` | сразу | Насколько глубоко модель ChatGPT (Codex) думает перед ответом, если у агента это не задано. По умолчанию — «Средние». Выше — точнее, но дольше и дороже. | | `AIHUMMER_LLM_CALL_TIMEOUT_S` | Таймаут одного вызова (секунды) | `int` | `120` | сразу | Сколько секунд ждать ответа модели на один запрос. Если модель молчит дольше, запрос обрывается и ответ переходит к следующей модели из списка. Для Claude считается пауза в потоке ответа, а не весь ответ: длинный, но идущий ответ не обрывается. 0 — без ограничения. | | `AIHUMMER_LLM_FALLBACK_MODELS` | Запасные модели (для всех агентов) | `text` | `auto` | сразу | Кто отвечает, когда основная модель и остальные поставщики отказали (исчерпан лимит, сбой, слишком частые запросы). auto — последним рубежом у каждого поставщика его более дешёвая модель (Claude: claude-haiku-4-5, Codex: gpt-…-luna/mini из каталога учётной записи); список через запятую — свой порядок, каждая модель идёт к поставщикам своего вендора; off — без запасных. Собственная запасная модель агента главнее. Применяется сразу. | | `AIHUMMER_LLM_GATEWAY_URL` | URL LLM-шлюза | `text` | — | частично после перезапуска | Базовый URL OpenAI-совместимого эндпоинта модели, к которому обращается агент (ваш локальный сервер llama.cpp/vLLM/Ollama или размещённый шлюз). Пусто — использовать эндпоинт провайдера по умолчанию. | | `AIHUMMER_LLM_MODEL` | Модель LLM | `text` | — | частично после перезапуска | Имя/идентификатор модели, отправляемый провайдеру на каждом ходе (модель, которую отдаёт ваш эндпоинт). Должно совпадать с моделью, которую реально предоставляет эндпоинт. | | `AIHUMMER_LLM_PAUSE_AUTH_MIN` | Пауза после отказа учётных данных, мин | `int` | `10` | сразу | Сколько минут не спрашивать поставщика, отвергшего учётные данные. Повтор удваивает паузу, но не дольше шестикратной. Успешная проверка соединения и кнопка «Снять паузу» возвращают поставщика сразу. Действует со следующего отказа. | | `AIHUMMER_LLM_PAUSE_MODEL_MIN` | Пауза модели, которую поставщик не обслуживает, мин | `int` | `60` | сразу | Сколько минут не предлагать поставщику модель, которую он ответил, что не обслуживает; другие его модели спрашиваются как обычно. Действует со следующего отказа. | | `AIHUMMER_LLM_PAUSE_QUOTA_MIN` | Пауза после исчерпания лимита, мин | `int` | `300` | сразу | Сколько минут не спрашивать модель (или весь аккаунт, если исчерпан лимит учётной записи — Codex, ключ OpenAI, оплата), когда лимит исчерпан, а срок сброса поставщик не назвал. Повтор удваивает паузу, но не дольше суток. Названный поставщиком срок главнее. Действует со следующего отказа. | | `AIHUMMER_LLM_PAUSE_SHORT_S` | Пауза поставщика после сбоя, с | `int` | `30` | сразу | Сколько секунд не спрашивать поставщика после сбоя, обрыва связи или «слишком часто». Второй отказ подряд — вдвое дольше, третий и дальше — вдесятеро. Если поставщик сам назвал срок, ждём его. Действует со следующего отказа. | | `AIHUMMER_LLM_PROVIDER` | Провайдер LLM | `text` | — | частично после перезапуска | Какой бэкенд модели использовать (OpenAI-совместимый эндпоинт или транспорт Codex/подписка ChatGPT). Определяет, как отправляются и авторизуются запросы. | | `AIHUMMER_LLM_RETRIES` | Повторы LLM при временной ошибке | `int` | `3` | сразу | Число повторов запроса к LLM при временной ошибке. | | `AIHUMMER_LLM_TEMPERATURE` | Температура | `text` | — | сразу | Насколько разнообразно отвечает модель (0–2), если у агента это не задано: меньше — точнее и предсказуемее, больше — живее. Пусто — модель решает сама. Модели с размышлениями (ChatGPT/Codex, Claude поколения 5) этот параметр не принимают — для них оставьте поле пустым. | | `AIHUMMER_LLM_TOP_P` | Top-p (nucleus-сэмплирование) | `text` | — | сразу | Ещё один способ сделать ответы разнообразнее (0–1), если у агента это не задано. Пусто — модель решает сама. Обычно задают что-то одно: либо температуру, либо этот параметр; модели с размышлениями его не принимают. | | `AIHUMMER_MODEL_GUARD_INTERVAL_MIN` | Сверка моделей агентов: период, мин | `int` | `60` | сразу | Как часто перепроверять, что модель каждого агента обслуживает включённый поставщик. Модель агента не меняется никогда: пока её никто не обслуживает, ходы отвечает первая модель из порядка ответа, которая не на паузе, и одно уведомление называет агентов — и ещё одно, когда их модель вернётся. На старте шлюза сверка идёт всегда, а 0 отключает только повторение. Новый период действует в течение минуты. | | `AIHUMMER_OPENAI_API` | Стиль API OpenAI (chat \| responses) | `enum: \\\| chat \\\| responses` | — | частично после перезапуска | chat = /chat/completions, responses = /responses. Пусто = авто/по умолчанию. Применяется при старте/после рестарта. | | `AIHUMMER_OPENAI_API_KEY` | API-ключ нативного OpenAI (по умолчанию для установки) | `text` | — | частично после перезапуска | Ключ вашего OpenAI-аккаунта для нативного OpenAI-цикла (если используете OpenAI как провайдера по умолчанию). Не путать с BYOK рабочего пространства на странице «Модели». Применяется при старте/после рестарта. | | `AIHUMMER_OPENAI_BASE_URL` | Базовый URL нативного OpenAI | `text` | — | после перезапуска | База OpenAI-совместимого API (напр. https://api.openai.com/v1). Применяется при старте/после рестарта. | | `AIHUMMER_OPENAI_MODEL` | Модель нативного OpenAI | `text` | — | после перезапуска | Модель для нативного OpenAI-цикла (если задан AIHUMMER_OPENAI_API_KEY). Применяется при старте/после рестарта. | | `AIHUMMER_ROUTER_COMPLEX_MODEL` | Роутер: модель для сложных запросов | `text` | — | сразу | Модель для сложных запросов агента, у которого своей модели нет (пусто = уровень выключен). Действует со следующего хода. | | `AIHUMMER_ROUTER_SIMPLE_MODEL` | Роутер: модель для простых запросов | `text` | — | сразу | Модель для простых запросов агента, у которого своей модели нет (пусто = уровень выключен). Действует со следующего хода. | | `AIHUMMER_ROUTER_STANDARD_MODEL` | Роутер: модель для обычных запросов | `text` | — | сразу | Модель для обычных запросов агента, у которого своей модели нет (пусто = уровень выключен). Действует со следующего хода. | | `AIHUMMER_SUBSCRIPTION_QUOTA_REFRESH_MIN` | Квоты подписок: период опроса, мин | `int` | `15` | сразу | Как часто панель спрашивает у ChatGPT (Codex) окна квот подписки: не чаще раза за период, не чаще раза в 5 минут и только пока квоты открыты; между опросами показывается сохранённая копия. Claude не спрашиваем никогда: его лимиты — наша оценка. Действует со следующего открытия квот. | ## Media | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_DEEPGRAM_API_KEY` | API-ключ Deepgram | `text` | — | сразу | Ключ сервиса Deepgram — нужен, если голосовые сообщения распознаёт Deepgram. Если пусто, берётся общий ключ распознавания речи из соседней настройки. Действует сразу. | | `AIHUMMER_DEEPGRAM_DETECT_LANGUAGE` | Определение языка Deepgram | `bool` | `0` | сразу | Определять язык вместо передачи фиксированного языка. Применяется сразу. | | `AIHUMMER_DEEPGRAM_MODEL` | Модель Deepgram | `text` | `nova-2` | сразу | Модель Deepgram (напр. nova-2, nova-3, base). Зависит от доступа проекта по ключу. Применяется сразу. | | `AIHUMMER_DEEPGRAM_PUNCTUATE` | Пунктуация Deepgram | `bool` | `1` | сразу | Добавлять пунктуацию и прописные буквы. Применяется сразу. | | `AIHUMMER_DEEPGRAM_SMART_FORMAT` | Форматирование Deepgram | `bool` | `1` | сразу | Форматировать распознанные числа и даты. Применяется сразу. | | `AIHUMMER_DEEPGRAM_URL` | Базовый URL Deepgram | `text` | — | сразу | База Deepgram API. Пусто = https://api.deepgram.com. Применяется сразу. | | `AIHUMMER_IMAGE_BASE_URL` | Базовый URL API изображений (запасной OpenAI) | `text` | — | сразу | База /images API при работе через OpenAI-ключ (пусто = https://api.openai.com/v1). | | `AIHUMMER_IMAGE_MODEL` | Модель генерации изображений | `text` | — | сразу | Модель для image_generate (по умолчанию gpt-image-2). | | `AIHUMMER_MEDIA_MAX_UPLOAD_MB` | Макс. размер загрузки медиа (МБ) | `int` | `256` | сразу | Самый большой файл (фото, голосовое, видео), который можно загрузить за один раз, в мегабайтах. Защищает диск сервера от переполнения. По умолчанию 256. Действует сразу. | | `AIHUMMER_SIDECAR_STT` | Распознавание речи на этом сервере (faster-whisper) | `bool` | `0` | сразу | Локальное распознавание речи (faster-whisper). В основной бандл не входит: включение скачивает подписанное дополнение, которое публикуется в каждом выпуске (~620 МиБ для поддерживаемых версий Python), ставит службу и автоматически настраивает её адрес. На облачном тарифе распознавание настраивает поставщик. | | `AIHUMMER_SIDECAR_TTS` | Озвучка ответов (edge-tts) | `bool` | `0` | сразу | Синтез речи (edge-tts, голоса Microsoft Edge). В комплект поставки НЕ входит: включение скачивает подписанное дополнение (~26 МиБ) и ставит службу на хост. Сам синтез ходит в интернет за голосами — «офлайн» здесь относится к установке пакета, а не к работе. | | `AIHUMMER_STT_API_KEY` | API-ключ STT (необязательно) | `text` | — | сразу | Ключ доступа к службе распознавания речи, если она его требует. Для службы на этом сервере его задаёт установщик — менять не нужно. Действует сразу. | | `AIHUMMER_STT_ENGINE` | Движок распознавания речи (STT) | `enum: auto \\\| faster-whisper \\\| deepgram \\\| codex \\\| off` | `auto` | сразу | Чем расшифровывать голосовые. Авто (по умолчанию): Deepgram, если задан его ключ, иначе локальная служба, если она установлена (подписанное дополнение, переключатель выше), иначе ничем — и бот честно скажет собеседнику, что пока не может слушать. faster-whisper: локальная служба или совместимый внешний /v1/audio/transcriptions. deepgram: облачный Deepgram со своим ключом. codex: подключённая подписка ChatGPT («Модели» → «Подключить ChatGPT»), расходует её квоту. off: не расшифровывать. Применяется сразу. | | `AIHUMMER_STT_LANGUAGE` | Язык распознавания речи (STT) | `text` | — | сразу | Язык распознавания (BCP-47, напр. ru/en). Используется движком deepgram (модель nova-2). Пусто = автоопределение/дефолт движка. Применяется сразу. | | `AIHUMMER_STT_MODEL` | Модель STT | `text` | `Systran/faster-whisper-small` | сразу | Модель faster-whisper (напр. small/medium/large-v3 или Systran/faster-whisper-⟨size⟩). Применяется сразу. | | `AIHUMMER_TTS_API_KEY` | API-ключ TTS (edge-tts) | `text` | — | частично после перезапуска | Ключ доступа к службе озвучки. Задаётся автоматически при установке — менять не нужно. | | `AIHUMMER_TTS_ENABLED` | Синтез речи включён | `bool` | `1` | частично после перезапуска | Разрешает агенту отвечать голосом. Для этого нужна служба озвучки — её ставят в разделе «Дополнительные службы» выше. | | `AIHUMMER_TTS_MODEL` | Модель TTS | `text` | — | частично после перезапуска | Имя модели для edge-tts сервиса. Применяется при старте/после рестарта. | | `AIHUMMER_TTS_VOICE` | Голос TTS | `enum: de-DE-FlorianMultilingualNeural \\\| de-DE-SeraphinaMultilingualNeural \\\| en-US-AndrewMultilingualNeural \\\| en-US-AvaMultilingualNeural \\\| en-US-BrianMultilingualNeural \\\| en-US-EmmaMultilingualNeural \\\| fr-FR-RemyMultilingualNeural \\\| fr-FR-VivienneMultilingualNeural \\\| ru-RU-SvetlanaNeural \\\| ru-RU-DmitryNeural \\\| en-US-JennyNeural \\\| en-US-GuyNeural \\\| en-GB-SoniaNeural \\\| de-DE-KatjaNeural \\\| fr-FR-DeniseNeural \\\| es-ES-ElviraNeural \\\| tr-TR-EmelNeural \\\| pl-PL-ZofiaNeural \\\| zh-CN-XiaoxiaoNeural` | `de-DE-FlorianMultilingualNeural` | частично после перезапуска | Голос edge-tts по умолчанию (мультиязычный, в т.ч. русский). Применяется при старте/после рестарта. | | `AIHUMMER_VIDEO_API_KEY` | API-ключ анализа видео | `text` | — | сразу | Ключ доступа к службе разбора видео, если она его требует. Пусто — служба используется без ключа. | ## Media · Voice | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_TTS_AUTO_REPLY` | Автоматические голосовые ответы | `enum: off \\\| always \\\| inbound \\\| tagged` | `inbound` | сразу | Выключено, всегда, в ответ на аудио или по явной отметке. Можно переопределить для диалога. | | `AIHUMMER_TTS_MAX_CHARS` | Ограничение текста озвучивания | `int` | `0` | сразу | 0 — полный текст; 100–10000 — предел озвучивания. Полный ответ сохраняется в истории. | | `AIHUMMER_TTS_SUMMARIZE` | Сокращение длинных голосовых ответов | `bool` | `1` | сразу | Сокращать длинные ответы для озвучивания. При ошибке читать начало в пределах лимита. | | `AIHUMMER_VOICE_AEC` | Подавление эха (AEC) | `bool` | `1` | сразу | Убирает эхо: собственный голос агента из динамика не попадает обратно в микрофон и не перебивает разговор. Выключайте, только если голос в гарнитуре звучит искажённо. | | `AIHUMMER_VOICE_AGC` | Автоматическая регулировка усиления | `bool` | `1` | сразу | Требовать автоматическую регулировку усиления микрофона (WebRTC autoGainControl) в голосовом режиме. | | `AIHUMMER_VOICE_BARGEIN_FRAMES` | Перебить агента: сколько нужно говорить | `int` | `5` | сразу | Сколько нужно говорить (в кадрах по 20 мс), чтобы агент замолчал и начал слушать. По умолчанию 5 — примерно 0,1 секунды. | | `AIHUMMER_VOICE_DUPLEX` | Живой полнодуплексный голос | `bool` | `0` | сразу | Включает живой полнодуплексный режим (стриминг + VAD + barge-in). Применяется сразу. | | `AIHUMMER_VOICE_NOISE_SUPPRESSION` | Шумоподавление | `bool` | `1` | сразу | Требовать подавление шума при захвате микрофона (WebRTC noiseSuppression) в голосовом режиме. | | `AIHUMMER_VOICE_VAD_THRESHOLD` | Чувствительность к голосу (0–1) | `text` | `0.02` | сразу | С какой громкости звук считается речью. Меньше — чувствительнее: агент услышит тихую речь, но и посторонний шум. По умолчанию 0.02. | ## Memory | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_EMBEDDER_DIM` | Размерность модели поиска по смыслу | `int` | `768` | после перезапуска | Размерность вектора — должна совпадать с моделью (multilingual-e5-base=768, bge-m3=1024). | | `AIHUMMER_EMBEDDER_KEEPALIVE` | Keep-alive эмбеддера | `text` | `5m` | после перезапуска | Сколько модель поиска по смыслу остаётся загруженной после последнего запроса (только в режиме «По смыслу»). По умолчанию 5m — 5 минут: потом модель выгружается и освобождает память и процессор. Держать всегда (-1) не рекомендуется: зависшая модель может сутками занимать ядро процессора. Формат: 30s, 5m, 1h. | | `AIHUMMER_EMBEDDER_MODEL` | Модель поиска по смыслу | `text` | `yxchia/multilingual-e5-base` | после перезапуска | Модель, которая помогает искать в памяти по смыслу. По умолчанию multilingual-e5-base — понимает русский, лёгкая и быстро работает на обычном процессоре. Для лучшего качества на видеокарте подойдёт bge-m3, но тогда в соседней настройке размерности укажите 1024: число должно совпадать с моделью. | | `AIHUMMER_EMBEDDER_PASSAGE_PREFIX` | Префикс документа эмбеддера | `text` | — | после перезапуска | Переопределить префикс сохраняемого документа (модели e5 автоматически используют «passage: »). Оставьте пустым для автоопределения по имени модели. | | `AIHUMMER_EMBEDDER_QUERY_PREFIX` | Префикс запроса эмбеддера | `text` | — | после перезапуска | Переопределить префикс поискового запроса (модели e5 автоматически используют «query: »). Оставьте пустым для автоопределения по имени модели. | | `AIHUMMER_EMBEDDER_THREADS` | Потоки процессора эмбеддера | `int 0…256` | `0` | после перезапуска | Сколько потоков процессора модель поиска по смыслу берёт на один запрос. 0 — само: половина потоков сервера, но не меньше 2. Без предела пересчёт векторов базы знаний на слабом сервере часами занимал весь процессор и мешал ответам агентов. Больше — пересчёт быстрее, но нагрузка сильнее. | | `AIHUMMER_MEMORY_AGENT_WRITES` | Факты, которые агент сохраняет сам | `enum: strangers \\\| immediate \\\| review` | `strangers` | сразу | Что происходит с тем, что агент запоминает сам — например, по просьбе «запомни». «Сразу в память; от посторонних — на проверку» (по умолчанию) — сразу в память, если это сказал владелец или доверенный круг агента; от остальных — на проверку. «Сразу в память» — агент сразу найдёт это при поиске. «На проверку» — сначала в очередь «Память → на проверку», в ответы попадает только после вашего одобрения. В карточке агента (Память → Настройки) можно задать свой режим. | | `AIHUMMER_MEMORY_AUTOREPAIR` | Автопочинка памяти | `bool` | `1` | сразу | После самопроверки чинить память: сливать дубли, закрывать противоречия, у которых есть явный победитель (подтверждение человеком, более поздняя дата события, более весомый источник), перепроверять по исходникам «проверенные» факты, которых не подтверждал человек (неподтверждённые уходят на проверку, ничего не удаляется). Спорное — только в очередь. Каждое исправление — в журнал с кнопкой отмены; если после прохода память находит хуже, проход откатывается сам и приходит уведомление. Действует сразу, перезапуск не нужен. | | `AIHUMMER_MEMORY_CAPTURE` | Режим захвата памяти | `enum: auto \\\| review \\\| off` | `review` | сразу | Что делать с фактами, которые агент сам замечает в переписке после каждого ответа. «На проверку» — в очередь «Память → на проверку»: в ответы они попадают только после вашего одобрения. «Сразу в память» — без проверки: быстрее, но больше лишнего. «Не сохранять» — не извлекать факты из переписки. То, что агент запоминает по просьбе, настраивается отдельно. | | `AIHUMMER_MEMORY_CONTEXT_TIMEOUT` | Таймаут подгрузки памяти | `text` | `3s` | сразу | Сколько агент ждёт, пока найдутся подходящие воспоминания, прежде чем начать ответ. Если поиск не успел, агент отвечает без них, а не зависает. Например: 2s — 2 секунды, 1500ms — 1,5 секунды. 0 — ждать сколько нужно. | | `AIHUMMER_MEMORY_DIARY_BOOT` | Дневник агента в начале сессии | `bool` | `1` | сразу | На каждом ходе сессии на любом канале держать перед агентом его дневник за сегодня и вчера — заметки прошлых сессий, ночную сводку и записи самого агента. Показываются только записи о текущем собеседнике и общие (ваши, загруженные): один клиент не видит записей о другом. Не больше ~6000 знаков; остальное агент дочитывает сам (memory_get). Действует сразу, перезапуск не нужен. | | `AIHUMMER_MEMORY_DIARY_HOUR` | Час ночной сводки | `int` | `3` | сразу | После какого часа (0–23, по часовому поясу инстанса) писать сводку за прошедший день. По умолчанию 3 — ночью, когда разговоры дня закончились. Действует сразу, перезапуск не нужен. | | `AIHUMMER_MEMORY_DIARY_NIGHTLY` | Ночная сводка дня в дневник агента | `bool` | `1` | сразу | Раз в сутки записывать в дневник агента итог прошедшего дня — отдельно по каждому собеседнику (все его каналы вместе): что просили и что сделано, договорённости, дела с датами. Один вызов служебной модели на агента и собеседника, не больше 3 за проход раз в 10 минут; пропущенные дни (например, пока шлюз был выключен) догоняются до недели назад. Разговоры с «не запоминай» не берутся. При выключенном захвате памяти не пишется. Итог последнего прохода виден в карточке агента → Память → Дневник. Действует сразу, перезапуск не нужен. | | `AIHUMMER_MEMORY_DREAM_INTERVAL` | Интервал прохода «сна» | `string` | `1h` | сразу | Как часто само-обслуживающий проход dream сканирует проверенные утверждения на противоречия во всех областях (Go-duration, напр. 30m/1h/6h). 0 = выключить. Действует сразу, перезапуск не нужен. | | `AIHUMMER_MEMORY_EXTRACT` | Извлечение фактов через LLM | `bool` | `1` | сразу | Извлекать нормализованные факты субъект/предикат/объект через LLM (по умолчанию ВКЛ) вместо хранения сырых фрагментов предложений — необходимо для работы механизмов графа/противоречий/dream. Добавляет один вызов LLM на каждое захваченное сообщение; выключите, чтобы сэкономить вызов. Действует сразу, перезапуск не нужен. | | `AIHUMMER_MEMORY_MEANING_TIMEOUT` | Срок поиска по смыслу | `text` | `4s` | сразу | Сколько поиск в памяти и в базе знаний ждёт поиск по смыслу. Если модель смысла занята (например, досчитывает векторы после импорта) и не ответила за это время, агент сразу получает найденное по словам с пометкой, а не ждёт десятки секунд. Например: 4s — 4 секунды, 1500ms — 1,5 секунды. 0 — ждать сколько нужно. Действует сразу, перезапуск не нужен. | | `AIHUMMER_MEMORY_QUALITY_CHECK` | Ежедневная самопроверка памяти | `bool` | `1` | сразу | Раз в сутки память сама задаёт себе контрольные вопросы по своим подтверждённым фактам (до 60 фактов, те же вопросы каждый день) и вопросы без ответа, прогоняет их через поиск памяти и автоподмешивание и считает полноту, точность, MRR и ложные подмешивания. Итог и график по дням — Память → Качество памяти. Вопросы к новым фактам один раз составляет служебная модель (та же, что разбирает переписку на факты; без неё — шаблоном); итоги остаются на инстансе. Действует сразу, перезапуск не нужен. | | `AIHUMMER_MEMORY_RECALL` | Автоподмешивание памяти | `enum: strong \\\| always \\\| off` | `strong` | сразу | Добавлять ли найденное в памяти к ответу автоматически. «Только точные совпадения» — факт должен совпасть с сообщением хотя бы по двум важным словам; на приветствия и «ок» память не подтягивается. «Всё похожее» — всё, что хоть как-то совпало, и связанные записи: больше лишнего. «Не подмешивать» — агент ищет в памяти сам, когда посчитает нужным. | | `AIHUMMER_MEMORY_RECALL_MAX` | Фактов памяти на один ответ | `int` | `5` | сразу | Сколько фактов памяти самое большее подмешивать в один ответ (по умолчанию 5). Пересказы одного и того же факта считаются одним. Действует сразу, перезапуск не нужен. | | `AIHUMMER_MEMORY_RECALL_MIN_SCORE` | Минимальное совпадение для автоподмешивания, % | `int` | `10` | сразу | Какую долю смысловых слов сообщения (с учётом их редкости) факт должен покрыть, чтобы подмешаться автоматически, в процентах. По умолчанию 10 — подобрано на реальной переписке. Больше — реже и точнее, меньше — чаще и шумнее. 0 — без порога: хватает двух совпавших значимых слов. На явный поиск memory_search не влияет. Действует сразу, перезапуск не нужен. | | `AIHUMMER_MEMORY_RECALL_MIN_SIMILARITY` | Минимальное сходство по смыслу для автоподмешивания, % | `int` | `86` | сразу | Только для поиска памяти по смыслу (эмбеддер): насколько близким по смыслу к сообщению должен быть факт, чтобы подмешаться автоматически, в процентах сходства. По умолчанию 86 — подобрано для модели multilingual-e5-base на реальной памяти: ниже порога посторонние факты подмешиваются почти к каждому сообщению. Для других моделей (например, bge-m3) сходство считается иначе — подберите значение по «Спросить память» в карточке агента. 0 — без порога. На явный поиск memory_search не влияет. Действует сразу, перезапуск не нужен. | | `AIHUMMER_MEMORY_RETRIEVAL` | Режим извлечения памяти | `enum: fulltext \\\| embedding` | `fulltext` | после перезапуска | Как агент ищет нужное в памяти. «По словам» — обычный поиск по тексту: работает сразу и не нагружает сервер. «По смыслу» — находит близкое по значению, даже сказанное другими словами, но нужна модель поиска по смыслу (раздел «Дополнительные службы») и заметная нагрузка на процессор. | | `AIHUMMER_QDRANT_API_KEY` | API-ключ Qdrant | `text` | — | после перезапуска | API-ключ Qdrant, если векторное хранилище требует авторизации. Нужен только при заданном адресе Qdrant. Применяется при старте/после рестарта. | | `AIHUMMER_QDRANT_URL` | URL Qdrant (постоянное векторное хранилище) | `text` | — | после перезапуска | Адрес хранилища Qdrant для поиска по смыслу. Пусто — данные для поиска держатся в памяти и пропадают при перезапуске сервера; для постоянной работы задайте адрес. | | `AIHUMMER_RAG_QUERY_EXPANSION` | Переформулировать запросы к базе знаний моделью | `bool` | `0` | сразу | Перед поиском по базе знаний просить служебную модель придумать 3 переформулировки запроса и искать по всем. Иногда находит больше, но это лишний вызов модели на КАЖДЫЙ поиск (расход квоты и задержка); если модель отказала, ищется только исходная формулировка, а отказ виден в журнале и в ответе поиска. По умолчанию выключено: слова и так находятся полнотекстовым поиском. Действует сразу, перезапуск не нужен. | | `AIHUMMER_RERANKER_URL` | URL сайдкара переранжирования RAG | `text` | — | после перезапуска | HTTP-URL сайдкара кросс-энкодера для переранжирования гибридного поиска. Пусто = переранжирование выключено. Применяется при старте/после рестарта. | ## Moderation | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_MODERATION` | Модерация входящих | `bool` | `1` | сразу | «off» отключает встроенный guard против jailbreak/prompt-injection. Любое другое значение = включено. Действует сразу, перезапуск не нужен. | | `AIHUMMER_MODERATION_REFUSAL` | Сообщение отказа модерации | `text` | — | сразу | Текст отказа, который возвращается при блокировке модератором (пусто = встроенный). Действует сразу, перезапуск не нужен. | ## Network | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_OUTBOUND_PROXY_CUSTOM_URL` | Исходящий прокси: свой адрес | `text` | — | сразу | URL прокси HTTPS; HTTP допускается только на loopback, без пути, запроса и фрагмента. Сначала сохраните адрес, затем выберите custom. Адрес скрыт в API и хранится в настройках приложения. | | `AIHUMMER_OUTBOUND_PROXY_MODE` | Исходящий прокси для зарубежных провайдеров моделей | `enum: auto \\\| off \\\| custom` | `auto` | сразу | Как сервер ходит к зарубежным поставщикам моделей. «Как у поставщика» — так, как задано в кабинете поставщика; «Напрямую, без прокси» — без посредников; «Через свой прокси» — через адрес, который вы сохранили ниже. Работает ли это, зависит от правил конкретного поставщика. | | `AIHUMMER_RUSSIAN_TRUSTED_EXTRA_HOSTS` | Хосты сверх .ru для корней Минцифры | `list` | — | после перезапуска | Список хостов через запятую, которым разрешено проверяться корнями НУЦ Минцифры СВЕРХ российских доменов (.ru/.su/.рф — уже включены). Нужен, если ваш узел с сертификатом Минцифры живёт на другом домене. Совпадение по имени или по границе поддомена: example.com покрывает api.example.com. Пусто = только российские домены. Применяется при старте/после рестарта. | ## Performance | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_CHANNEL_TURN_QUEUE_WAIT_SEC` | Ожидание в очереди: сообщение из канала (секунды) | `int 10…1200` | `600` | сразу | Сколько сообщение из канала (Telegram и другие) ждёт свободного места, когда все места ходов заняты. Не дождалось — человеку приходит сообщение, что сервер занят и можно написать ещё раз. Ожидание входит в 30-минутный предел хода. 10–1200. Действует сразу. | | `AIHUMMER_MAX_ACTIVE_TURNS` | Ходов агентов одновременно (весь сервер) | `int 1…512` | `32` | сразу | Сколько ходов агентов (ответы в каналах и веб-чате, расписания) сервер выполняет одновременно. Остальные ждут в очереди столько, сколько задано в настройках «Ожидание в очереди» ниже, и человек видит «сервер занят, в очереди». Больше — меньше ожидания, но больше памяти, соединений с базой и одновременных запросов к модели. Половина этого числа — предел одновременных служебных вызовов модели (извлечение памяти, сводки). 1–512. Действует сразу. | | `AIHUMMER_SYNC_INBOUND_QUEUE_WAIT_SEC` | Ожидание в очереди: синхронный вызов интеграции (секунды) | `int 1…120` | `10` | сразу | Сколько вызов интеграции, ждущей ответа в том же запросе, ждёт свободного места, когда все места ходов заняты. Не дождался — интеграция получает «сервер занят» с советом повторить через то же число секунд; повтор с тем же номером сообщения не записывает его второй раз. 1–120. Действует сразу. | | `AIHUMMER_WEB_TURN_QUEUE_WAIT_SEC` | Ожидание в очереди: сообщение веб-чата (секунды) | `int 10…1200` | `180` | сразу | Сколько сообщение веб-чата ждёт свободного места, когда все места ходов заняты. Всё это время в чате видно «сервер занят, в очереди»; не дождалось — отказ с кнопкой «Повторить», он остаётся в истории и после перезагрузки страницы. 10–1200. Действует сразу. | ## Public access | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_PUBLIC_URL` | Публичный адрес сервера | `text` | — | частично после перезапуска | Адрес, по которому панель и приложения открываются из интернета, например https://ai.example.ru. Направьте его через свой прокси (nginx, Caddy) на порт сервера — по умолчанию 8780. | | `AIHUMMER_WIDGET_ALLOWED_ORIGINS` | Веб-виджет: разрешённые источники сайтов | `list` | — | сразу | Список браузерных источников (origin) через запятую, которым разрешено встраивать виджет веб-чата, например https://example.com,https://www.example.com. Схема и порт должны совпадать точно. Пусто = ни один внешний сайт не может использовать виджет. Запись `*` намеренно игнорируется, иначе любая страница в интернете могла бы расходовать бюджет этого инстанса. | | `POCKET_AGENT_GATEWAY_BASE_URL` | Публичный URL шлюза pocket-agent | `text` | — | сразу | Проксируйте → на порт шлюза pocket-agent (POCKET_AGENT_PORT, по умолчанию 8080). Удалённый агент подключается сюда по одноразовому тикету. | | `TELEGRAM_PUBLIC_URL` | Публичный URL вебхука Telegram | `text` | — | сразу | Только для режима webhook — проксируйте → на порт telegram-connector (по умолчанию 8091). Оставьте пустым для режима polling (публичный URL не нужен). | ## SSO (LDAP/AD) | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_LDAP_BASE_DN` | Базовый DN поиска пользователей | `text` | — | после перезапуска | Корень поиска, напр. OU=Users,DC=corp,DC=example. | | `AIHUMMER_LDAP_BIND_DN` | Служебный DN для привязки | `text` | — | после перезапуска | Учётная запись для начального поискового bind, напр. CN=svc-aihummer,OU=Service,DC=corp,DC=example. Пусто = анонимный поиск. | | `AIHUMMER_LDAP_DEFAULT_ROLE` | LDAP: Роль по умолчанию (нет совпадения групп) | `text` | — | после перезапуска | Роль, выдаваемая, когда ни одна группа не совпадает с маппингом. Пусто = без роли. | | `AIHUMMER_LDAP_ENABLED` | Включить вход через LDAP/AD | `bool` | `0` | после перезапуска | Когда включено, входы администраторов откатываются на каталог. Пароль привязки хранится в Secrets (scope ldap, name bind_password). | | `AIHUMMER_LDAP_GROUP_ATTR` | Атрибут группы (по умолчанию memberOf) | `text` | — | после перезапуска | Атрибут записи пользователя, перечисляющий DN групп. Пусто отключает маппинг группа→роль. | | `AIHUMMER_LDAP_ROLE_MAPPINGS` | LDAP: Сопоставление групп → ролей (JSON) | `text` | — | после перезапуска | JSON-объект DN группы (или простого CN) → роль, напр. {"CN=Admins,OU=Groups,DC=corp,DC=example":"admin","Operators":"operator"}. | | `AIHUMMER_LDAP_SKIP_TLS_VERIFY` | Пропускать проверку TLS (только для лаборатории, 1/0) | `bool` | `0` | после перезапуска | Отключает проверку сертификата каталога. Никогда не включайте в продакшене. | | `AIHUMMER_LDAP_URL` | URL каталога | `text` | — | после перезапуска | напр. ldaps://ad.corp.example:636 (TLS) или ldap://dc1.corp.example:389. | | `AIHUMMER_LDAP_USER_ATTR` | Атрибут логина (по умолчанию sAMAccountName) | `text` | — | после перезапуска | Атрибут LDAP/Active Directory, сопоставляемый с вводимым логином (по умолчанию sAMAccountName; uid для OpenLDAP, userPrincipalName для входа по UPN). | | `AIHUMMER_LDAP_USER_FILTER` | Фильтр поиска пользователей | `text` | — | после перезапуска | Должен содержать %s для логина. AD: (sAMAccountName=%s); OpenLDAP: (uid=%s). | ## SSO (OIDC) | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_OIDC_AUDIENCE` | Audience у OIDC | `text` | — | после перезапуска | Ожидаемый claim `aud` — задайте audience ЭТОГО ресурса, чтобы отклонять токены, выпущенные для другой стороны. Claim `aud` теперь ОБЯЗАТЕЛЕН в каждом токене по умолчанию (токен без aud отклоняется); когда это задано, aud также должен его содержать. Настоятельно рекомендуется в продакшене. | | `AIHUMMER_OIDC_ISSUER` | URL издателя OIDC | `text` | — | после перезапуска | Издатель IdP (напр. https://login.example.com). Включает аутентификацию по OIDC JWT, когда задан. | | `AIHUMMER_OIDC_JWKS_URL` | URL JWKS у OIDC | `text` | — | после перезапуска | Эндпоинт JSON Web Key Set для проверки подписей токенов. | | `AIHUMMER_OIDC_TENANT_CLAIM` | Claim рабочего пространства в OIDC | `text` | — | после перезапуска | Claim JWT, несущий идентификатор рабочего пространства (напр. tenant_id / org). | ## SSO (SAML) | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_SAML_DEFAULT_ROLE` | SAML: Роль по умолчанию (нет совпадения групп) | `text` | — | после перезапуска | Роль, выдаваемая, когда ни одно утверждённое значение не маппится. Пусто = без роли. | | `AIHUMMER_SAML_ENABLED` | Включить SSO SAML 2.0 | `bool` | `0` | после перезапуска | Открывает /saml/metadata, /saml/acs, /saml/login. Приватный ключ SP хранится в Secrets (scope saml, name sp_key). | | `AIHUMMER_SAML_ENTITY_ID` | Entity ID у SP | `text` | — | после перезапуска | Entity ID сервис-провайдера (по умолчанию ⟨root⟩/saml/metadata, если пусто). | | `AIHUMMER_SAML_IDP_METADATA` | XML-метаданные IdP | `text` | — | после перезапуска | Вставьте документ SAML-метаданных вашего IdP (Okta/Azure AD/ADFS). | | `AIHUMMER_SAML_ROLE_ATTRIBUTE` | Атрибут роли/группы (по умолчанию groups) | `text` | — | после перезапуска | Атрибут assertion, несущий значения групп/ролей. | | `AIHUMMER_SAML_ROLE_MAPPINGS` | SAML: Сопоставление групп → ролей (JSON) | `text` | — | после перезапуска | JSON-объект утверждённого значения → роль, напр. {"AdminGroup":"admin","Ops":"operator"}. | | `AIHUMMER_SAML_ROOT_URL` | Корневой URL SP | `text` | — | после перезапуска | Внешне доступный базовый URL этого шлюза, напр. https://app.example.com. ACS = ⟨root⟩/saml/acs. | | `AIHUMMER_SAML_SP_CERT` | Сертификат SP (PEM) | `text` | — | после перезапуска | Публичный сертификат подписи SP (PEM). Соответствующий приватный ключ помещается в Secrets (scope saml, name sp_key). | ## Schedules | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_SCHEDULE_AGENT_MAX_ACTIVE` | Агент: предел активных расписаний | `int` | `20` | сразу | Сколько активных расписаний может быть у одного агента, когда он сам создаёт или включает расписание (своими инструментами расписаний). Расписания из панели входят в счёт, но панели не отказывают. На пределе агент получает отказ с просьбой сначала приостановить или удалить одно. Действует сразу. | | `AIHUMMER_SCHEDULE_AGENT_MAX_FIRES_PER_DAY` | Агент: запусков расписаний в сутки | `int` | `288` | сразу | Сколько раз в сутки (по UTC) могут сработать все расписания одного агента вместе, включая расписания из панели и ручные запуски. Запуски сверх предела пропускаются и видны в журнале запусков. Действует сразу. | | `AIHUMMER_SCHEDULE_AGENT_MIN_INTERVAL_MINUTES` | Агент: минимальный интервал расписания, минуты | `int` | `5` | сразу | Кратчайший промежуток между двумя запусками повторяющегося расписания, которое агент создаёт или меняет сам. Более частое расписание отклоняется. Расписания из панели этим не ограничены. Действует сразу. | | `AIHUMMER_SCHEDULE_COMMANDS` | Команды на сервере в расписаниях | `bool` | `0` | сразу | Позволяет расписанию запускать программу на этом сервере — сборщик, отчёт, проверку резервной копии. По умолчанию выключено. Выполняются только команды из «Разрешённых команд», в точности как записаны; оболочки нет. Вывод уходит агенту или прямо в чат, каждый запуск виден в журнале запусков задания. Действует сразу. | | `AIHUMMER_SCHEDULE_COMMANDS_ALLOWLIST` | Разрешённые команды | `argvlist` | — | сразу | Точные команды, которые может запускать расписание: программа (имя, например df, или полный путь) и её аргументы. Расписание запускает только команду, совпадающую с записью полностью, вместе с аргументами. Удалённая команда останавливает задания, которые её используют, и их запуски называют причину. Действует сразу. | | `AIHUMMER_SCHEDULE_COMMANDS_MAX_OUTPUT_KB` | Предел вывода команды расписания, КБ | `int 1…1024` | `64` | сразу | Сколько вывода команды (1–1024 КБ) сохраняется в журнале запусков и передаётся агенту или в чат; остальное отрезается, и журнал запусков об этом говорит. Действует сразу. | | `AIHUMMER_SCHEDULE_COMMANDS_SANDBOX` | Запускать команды расписаний в песочнице ОС | `bool` | `1` | сразу | Включено: команда идёт в песочнице ОС, как запуск кода, — секреты установки и ключи SSH скрыты, писать можно только в свою временную папку. Без песочницы (bubblewrap) на сервере команда не запускается, и журнал запусков говорит почему. Выключено: команда идёт с правами шлюза. Действует сразу. | | `AIHUMMER_SCHEDULE_FAILURE_ADMIN` | Сообщать администратору о сбоях заданий | `bool` | `1` | сразу | Если задание по расписанию не выполнилось или не смогло начаться, в колокольчике панели появляется уведомление с именем задания, причиной и тем, где это исправить, и то же уходит владельцам в их личные чаты каналов (не чаще раза в 6 часов на задание). Это в дополнение к сообщению получателю задания. Выключено — администратор узнаёт о сбоях только из журнала запусков. Действует сразу. | | `AIHUMMER_SCHEDULE_FAILURE_NOTIFY` | Сообщать получателю о сбое задания | `bool` | `1` | сразу | Если задание по расписанию не выполнилось, тому же получателю уходит короткое сообщение (после первого сбоя, не чаще раза в 6 часов). Выключено — сбои видны только в журнале запусков. У отдельного задания это можно выключить в его форме. Действует сразу. | ## Security | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AIRGAPPED` | Изолированный режим (без интернета) | `bool` | `0` | сразу | Запрещает агентам ходить в интернет: веб-поиск, открытие страниц и запросы идут только к внутренним адресам и к адресам из списков разрешённых. Включайте для закрытых контуров без выхода наружу. | | `AIHUMMER_AUDIT_RETENTION_DAYS` | Сколько дней хранить журнал действий | `int` | `0` | после перезапуска | Записи журнала действий и истории изменений настроек старше этого срока удаляются раз в сутки. 0 или пусто — хранить всегда. | | `AIHUMMER_CORS_ORIGINS` | Разрешённые Origin для CORS | `list` | — | после перезапуска | Список разрешённых Origin через запятую. Пусто = CORS не разрешён (только same-origin). Применяется при старте/после рестарта. | | `AIHUMMER_CSP` | Заголовок Content-Security-Policy (переопределение) | `text` | — | после перезапуска | Переопределяет CSP-заголовок. Пусто = безопасный дефолт. Применяется при старте/после рестарта. | | `AIHUMMER_INBOUND_SECRET` | Ключ связи плагинов каналов с сервером | `text` | — | после перезапуска | Им подключённые каналы (Telegram, VK и другие) подтверждают, что сообщения пришли именно от них. Задаётся автоматически при установке — менять не нужно. Если он пуст, сервер отклоняет все каналы, пока ключ не задан. | | `AIHUMMER_OPENAI_COMPAT_KEY` | OpenAI-совместимый вход: статический API-ключ | `text` | — | после перезапуска | Общий ключ для программ, которые подключаются к серверу как к OpenAI-совместимому сервису. Пусто — общий ключ выключен; подключаться можно персональными ключами со страницы «Ключи API». | | `AIHUMMER_OPENAI_COMPAT_WORKSPACE` | OpenAI-совместимый вход: ID рабочего пространства | `text` | — | после перезапуска | ID рабочего пространства, в которое маппится статическая OpenAI-совместимая аутентификация. Пусто = AIHUMMER_DEFAULT_WORKSPACE_ID. Применяется при старте/после рестарта. | | `AIHUMMER_REQUIRE_2FA` | Требовать 2FA для операторов | `bool` | `0` | сразу | Требовать второй фактор (TOTP/passkey) для операторов. Включено: операторам без 2FA при входе предлагается немедленно настроить его (без блокировки, чтобы не запереть владельца). Применяется сразу. | | `AIHUMMER_REQUIRE_SECURE` | Принимать только защищённые соединения (HTTPS/WSS) | `bool` | `0` | после перезапуска | Когда включено, обычные HTTP-запросы перенаправляются на HTTPS (для GET/HEAD) или отклоняются (403); доступ с localhost всегда разрешён, чтобы не заблокировать оператора. Учитывает X-Forwarded-Proto от завершающего TLS обратного прокси. Применяется при старте/после рестарта. | | `AIHUMMER_TRUSTED_PROXIES` | Доверенные прокси | `list` | — | сразу | Если перед сервером стоит прокси (nginx, Caddy, балансировщик), впишите через запятую его адрес или сеть, например 10.0.0.0/8. Тогда в журнале действий, списке разрешённых IP и защите от подбора пароля будет виден настоящий адрес посетителя. Пусто — учитывается только адрес прямого подключения, и подменить его нельзя. | ## Tools | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_BROWSER_ALLOWED_HOSTNAMES` | Браузер: исключения для частных узлов | `list` | — | сразу | Точные имена через запятую, без масок, URL и портов. Дополнительные исключения для частной сети native CDP на собственном сервере; отдельно от web_fetch. | | `AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK` | Браузер: доступ к частной сети | `bool` | — | сразу | Пусто — прежняя политика; явные true или false включают проверяемый native CDP. Частная сеть доступна только на собственном сервере. Loopback, link-local и metadata закрыты. | | `AIHUMMER_BROWSER_PROFILE_SOCKET` | Сокет управления профилями браузера | `text` | — | сразу | Необязательно. Пусто — шлюз сам находит управляющий сокет managed-profiles.sock службы браузера в стандартном месте установки. Профили со входом на сайты заводятся на странице «Подключения» → «Профили браузера». Не URL и не путь к исходному профилю. | | `AIHUMMER_CODE_EXEC` | Выполнение кода агентом | `enum: off \\\| host \\\| sandbox` | `off` | сразу | Инструмент выполнения кода агента (code_exec). «Выключено» — по умолчанию. «На этом сервере» — команды идут на сервере шлюза: песочница ОС (bubblewrap) скрывает секреты установки, но агенту в режиме «Без ограничений» видны ключи SSH и запись вне его папки; только для доверенного сервера. «Только в песочнице» — всегда в песочнице ОС: секреты и ключи скрыты, запись только в папку агента; без bubblewrap (или образа контейнера) этот режим не сохраняется. Что может запускать каждый агент, задаётся у агента: «Агенты → профиль → Инструменты». | | `AIHUMMER_CODE_EXEC_INTERPRETERS` | Интерпретаторы code-exec (JSON) | `text` | — | сразу | JSON-объект {язык: путь_к_бинарю}, напр. {"python":"/usr/bin/python3"}. Пусто = автоопределение. | | `AIHUMMER_CODE_EXEC_NET_PORTS` | Сетевые порты, открытые коду агента | `list` | `53,80,443` | сразу | TCP-порты, к которым может подключаться код агента в песочнице ОС (выполнение кода и команды расписаний), через запятую. По умолчанию 53, 80 и 443: DNS и сайты. Остальные службы этого сервера и его локальной сети (база, панель, браузер, adb, локальные модели, Home Assistant) закрыты для кода агента. Порт из списка открыт на любом адресе, в том числе на этом сервере, поэтому добавляйте только нужное коду — например, 22 для SSH. Напишите any, чтобы снять ограничение. Агентов в режиме «Без ограничений» оно не касается. Нужен Linux 6.7 или новее; без него ограничение не действует, и об этом сказано в «Агенты → Инструменты». Действует сразу. | | `AIHUMMER_CODE_EXEC_READ_DIRS` | Каталоги, открытые коду агента на чтение | `list` | — | сразу | Каталоги этого сервера, которые может читать код агента: выполнение кода и команды расписаний в песочнице ОС. Через запятую или по одному в строке, например ~/reports. Можно указать и отдельный файл, например ~/scripts/report.py. Открытое здесь видно коду всех агентов, поэтому открывайте только то, что нужно коду. По умолчанию пусто: в песочнице код видит только папку своего агента и системные каталоги; домашний каталог пользователя шлюза, данные установки, папки других агентов, ключи и история команд скрыты. Корень, весь домашний каталог, данные установки и места с ключами открыть нельзя. Писать в эти каталоги код не может. Действует сразу. | | `AIHUMMER_CODE_EXEC_SANDBOX_IMAGE` | Образ песочницы code-exec | `text` | — | сразу | Необязательно, только для режима «Только в песочнице»: образ контейнера Docker вместо песочницы ОС (без сети, корень только для чтения, лимиты); нужен Docker на сервере. Пусто = песочница ОС (bubblewrap). | | `AIHUMMER_CODE_EXEC_TIMEOUT_SECONDS` | Предел времени выполнения кода (секунды) | `int` | `1800` | сразу | Сколько может работать одна команда агента, включая фоновые: от 10 секунд до 24 часов. На хосте с рабочими папками агентов команда, не ответившая за 30 секунд, не обрывается, а уходит в фон — агент проверяет её инструментом process. Без папок агентов и в контейнере фона нет, и вызов обрывается на 10 минутах. Агент может попросить меньший срок, но не больший. | | `AIHUMMER_DB_QUERY_DSN` | Подключение к базе для инструмента «Запрос к базе» | `text` | — | сразу | Строка подключения к базе данных, которую агент может читать (только чтение), например postgres://reader:пароль@host/db. Укажите пользователя с минимальными правами — не владельца базы. Пусто — инструмент выключен. | | `AIHUMMER_FS_ROOT` | Корень для инструмента файловой системы | `text` | — | сразу | Каталог, в пределах которого агент читает файлы сервера (filesystem_read; записывать файлы агент не может). Пусто = весь сервер с правами пользователя шлюза, кроме секретов: настроек установки (gateway.env), ключей SSH/GPG и окружения процессов. Чтобы сузить доступ, укажите каталог. | | `AIHUMMER_HTTP_ALLOWLIST` | Адреса для HTTP-запросов агента | `list` | — | сразу | Список хостов через запятую, к которым может обращаться инструмент http_request. Пусто = разрешены все, кроме внутренних и приватных адресов. | | `AIHUMMER_HTTP_AUTH_JSON` | Авторизация http_request (JSON) | `text` | — | сразу | JSON-карта соответствия хоста заголовкам авторизации для инструмента http_request, чтобы не хранить токены в промпте. Пусто = без авторизации. | | `AIHUMMER_MCP_SERVERS` | Серверы MCP (JSON) | `text` | — | сразу | JSON-описание внешних MCP-серверов, чьи инструменты подключаются к агенту. Пусто = внешних MCP нет. | | `AIHUMMER_PROJECT_STUDIOS_PUBLIC_NETWORK` | Студии проектов: публичная сеть | `bool` | `false` | сразу | Публичные HTTP(S)-адреса для выбранных провайдеров и явной загрузки моделей. Частные адреса, localhost и metadata закрыты. Офлайн-режим имеет приоритет. Применяется сразу. | | `AIHUMMER_SIDECAR_CLOAKBROWSER` | Браузер для агента (CloakBrowser) | `bool` | `0` | сразу | Антидетект-браузер (CloakBrowser, инструменты browser/computer). В комплект поставки НЕ входит: включение скачивает подписанное дополнение (~477 МиБ, из них Chromium ~207 МиБ) и ставит службу на хост. Самый тяжёлый из сайдкаров — включайте, только если агенту нужно открывать сайты. | | `AIHUMMER_SIDECAR_SEARXNG` | Веб-поиск (SearXNG) | `bool` | `0` | сразу | Веб-поиск (SearXNG, инструмент web_search). В комплект поставки НЕ входит: включение скачивает подписанное дополнение (~154 МиБ) и ставит службу на хост, выключение останавливает её и освобождает место. Установка идёт в фоне и занимает несколько минут; состояние здесь показывает, что реально стоит на сервере. | | `AIHUMMER_WEBFETCH_ALLOWLIST` | Сайты, которые агент может открывать | `list` | — | сразу | Список доменов через запятую, к которым может обращаться инструмент web_fetch. Пусто = разрешены все, кроме внутренних и приватных адресов. | | `AIHUMMER_WEB_SEARCH_LANGUAGE` | Веб-поиск: язык результатов по умолчанию | `text` | `auto` | сразу | Язык результатов веб-поиска, когда агент его не указал: код языка (ru, en, de…) или auto — определить по самому запросу. auto подходит почти всегда: на русский вопрос придут русские источники. Агент может попросить другой язык в конкретном поиске. | | `AIHUMMER_WEB_SEARCH_RESULTS` | Веб-поиск: результатов за один поиск | `int` | `5` | сразу | Сколько результатов веб-поиск возвращает, когда агент не попросил другое число: от 1 до 10. Больше результатов — полнее ответ, но длиннее контекст хода. | | `AIHUMMER_WEB_SEARCH_SOURCE` | Источник веб-поиска | `enum: auto \\\| searxng \\\| provider` | `auto` | сразу | Откуда агент ищет в интернете (инструмент web_search). auto — SearXNG, если он установлен, иначе встроенный поиск поставщика модели. searxng — только SearXNG: без него поиска нет. provider — встроенный поиск поставщика там, где он есть, а SearXNG — для остальных моделей. Встроенный поиск есть у Codex (подписка ChatGPT) и OpenAI (api.openai.com); у GigaChat, YandexGPT и других OpenAI-совместимых его нет — без SearXNG агенты на этих моделях не ищут. Claude (api.anthropic.com и подписка Claude) ищет встроенным поиском Anthropic; если учётная запись его отвергает, шлюз пишет об этом в журнал и дальше предлагает агенту только SearXNG. Кому из агентов можно искать, задаётся в карточке агента, как и раньше. Действует со следующего хода. | | `AIHUMMER_WEB_SEARCH_TIMEOUT_SECONDS` | Срок веб-поиска (секунды) | `int` | `30` | сразу | 1–600 секунд на поиск. Более короткий срок задачи остаётся в силе. | ## Updates | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_RESTART_APPLY` | Применять настройки, которым нужен перезапуск | `enum: quiet \\\| manual` | `quiet` | сразу | quiet (по умолчанию) — сохранённые настройки, которые вступают в силу только с новым запуском шлюза, применяются сами: шлюз перезапускается в ближайший тихий момент, когда агенты ничего не делают и люди молчат не меньше окна тишины. manual — только пометка «ждёт перезапуска» и кнопка. Перезапуск длится несколько секунд; разговоры и задачи не теряются. Действует сразу. | | `AIHUMMER_RESTART_QUIET_MINUTES` | Тихий момент: минут тишины перед автоматическим перезапуском | `int 0…1440` | `10` | сразу | Сколько минут люди должны молчать (и агенты ничего не делать), чтобы шлюз сам перезапустился и применил сохранённые настройки. 0 — как только агенты закончат текущую работу. 0–1440. Действует сразу. | ## Web UI (separate port) | Ключ | Название | Тип | По умолчанию | Когда вступает | Что делает | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_WEBUI_API_BASE` | Адрес сервера для отдельно размещённой панели | `text` | — | после перезапуска | Нужен, только если панель открывается не с того же адреса, что сам сервер. Укажите адрес, по которому браузер достучится до сервера, например https://api.example.ru. Пусто — используется публичный адрес сервера, а если его нет — локальный. | | `AIHUMMER_WEBUI_ENABLED` | Панель на отдельном порту | `bool` | `1` | после перезапуска | Включено — панель открывается на отдельном внутреннем порту, который можно закрыть от интернета, а публичный порт обслуживает только приложения и каналы. Выключите, чтобы панель была недоступна совсем. | | `AIHUMMER_WEBUI_ORIGIN` | Адрес, по которому открывают панель | `text` | — | после перезапуска | Заполните, если панель открывают через прокси или по имени, которое отличается от адреса её порта, например https://admin.example.ru. Сервер разрешит браузеру с этого адреса обращаться к нему. Пусто — берётся адрес порта панели. | Настроек, доступных оператору: 237.