Глобальные настройки SenDev: AI Core

Страница настроек модуля задаёт общие правила работы AI Core: кэш, HTTP-таймаут, очередь, повторные попытки, бюджетные ограничения, журнал, маскирование, максимальный размер промпта и параметры интеграции с Bitrix24.

Эти параметры действуют на весь AI Core. Меняйте их осознанно: одно значение может повлиять сразу на несколько функциональных модулей, использующих общий AI-слой.

Раздел доступен администратору. Перед изменением значений рекомендуется проверить текущее состояние в «Диагностике» и сохранить рабочие параметры.

[Скриншот 1: верхняя часть глобальных настроек и статус шифрования секретов]

Статус шифрования секретов

В начале страницы отображается сообщение о готовности защищённого хранения. AI Core шифрует секретные значения, а мастер-ключ берёт из защищённого окружения сервера или криптографической конфигурации 1С-Битрикс.

Мастер-ключ не хранится в обычных настройках AI Core. Если отображается предупреждение «Шифрование секретов не настроено», сначала передайте задачу системному администратору и только потом сохраняйте рабочие API-ключи или секреты Bitrix24.

Кэш

TTL кэша по умолчанию, сек.

Определяет, сколько секунд стандартный кэшированный результат считается актуальным, если конкретный запрос не передал собственный срок.

Стандартный ориентир — 3600 секунд, то есть один час.

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

Кэш помогает экономить квоту, но при тестировании нового промпта или модели может мешать увидеть свежий результат. В «Песочнице» для таких тестов выключайте использование кэша.

HTTP

HTTP timeout, сек.

Максимальное время ожидания ответа внешнего AI-сервиса. Стандартное значение — около 25 секунд.

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

Изменяйте этот параметр только после анализа журнала. Если один конкретный провайдер требует больше времени, сначала оцените возможность указать подходящий таймаут в его профиле.

Очередь

Очередь позволяет обрабатывать AI-задачи фоново и контролировать повторные попытки. Значения этого блока тесно связаны между собой.

Использовать очередь

Глобально включает механизм очереди. При выключении новые сценарии, рассчитанные на фоновое выполнение, не должны рассчитывать на штатный queue-worker.

Для стандартной эксплуатации рекомендуется оставлять включённым, если очередь используется функциональными модулями.

Размер пачки очереди

Сколько заданий один запуск обработчика может взять за один проход. Стандартное значение — 10.

Увеличение повышает объём работы за запуск, но может увеличить нагрузку и время выполнения. Уменьшение полезно на слабом сервере или при тяжёлых AI-задачах.

Лимит времени одного запуска worker, сек.

Ограничивает длительность одного рабочего цикла очереди. Стандартный ориентир — 50 секунд.

Значение помогает не удерживать один процесс бесконечно. Если очередь состоит из долгих задач, не увеличивайте параметр вслепую: сначала проверьте журнал и особенности конкретного функционального модуля.

Максимум pending/processing задач (0 = без лимита)

Ограничивает суммарное количество ожидающих и выполняющихся заданий. 0 означает отсутствие лимита.

Такой предохранитель полезен, если автоматический процесс теоретически может создать слишком много задач. При достижении предела новые постановки в очередь могут быть отклонены.

Максимум попыток задачи

Сколько раз AI Core может повторить обработку неуспешной задачи. Стандартное значение — 5.

Повтор полезен при временной сетевой ошибке или кратковременной недоступности сервиса. Если причина постоянная — например неверный ключ, — большое количество попыток только создаёт лишние запросы и записи.

Базовая задержка retry, сек.

Начальная задержка перед повторной попыткой. Стандартное значение — 30 секунд.

Максимальная задержка retry, сек.

Верхний предел интервала между повторными попытками. Стандартное значение — 300 секунд.

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

Таймаут блокировки задачи, сек.

Определяет, через какое время слишком долго «захваченная» задача может считаться зависшей и снова стать доступной для обработки. Стандартное значение — 600 секунд.

Не ставьте таймаут меньше обычного времени выполнения тяжёлых задач, иначе одна задача может ошибочно восприниматься как зависшая.

[Скриншот 2: блок настроек очереди, повторных попыток и лимитов]

Контроль бюджета

Контролировать бюджетные лимиты

Глобально включает правила со страницы «Лимиты». Если флажок снят, сохранённые лимиты остаются в системе, но не должны блокировать запросы.

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

Structured output

Разрешить один repair-запрос для structured output

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

Опция выключена по умолчанию. Включайте её, если функциональные модули действительно используют структурированный результат и дополнительный вызов приемлем по стоимости.

Следует учитывать: repair — это дополнительный AI-запрос, поэтому он может расходовать квоту и бюджет.

Журнал

Хранить логи, дней

Срок хранения записей. Стандартное значение — 30 дней.

Для активного сайта слишком длинный период увеличивает объём базы. Слишком короткий — усложняет поиск редких ошибок и анализ расходов. Выберите срок, соответствующий внутреннему процессу поддержки.

Маскировать логи

Включает обработку чувствительных данных перед сохранением диагностического предпросмотра. Для рабочего сайта рекомендуется оставлять включённым.

Типы данных для маскирования

Список категорий через запятую. Стандартно используются:

• api_key;
• bearer_token;
• cookie;
• authorization;
• email;
• phone.

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

Длина preview в журнале

Максимальный размер сохраняемого фрагмента запроса/ответа. Стандартное значение — 2000 символов.

Увеличение помогает диагностировать длинные ответы, но увеличивает объём журнала и количество сохраняемого контента. Для большинства задач стандартного значения достаточно.

Ограничение промпта

Максимальная длина промпта

Глобальный предохранитель от чрезмерно больших запросов. Стандартное значение — 32000 символов.

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

Маршрутизация

Стратегия маршрутизации

Определяет общий принцип выбора профиля, если конкретное подключение не указано явно. В стандартной конфигурации используется стратегия priority, то есть приоритет.

При такой стратегии важна «Сортировка» профиля: меньшее число означает более высокий приоритет среди совместимых активных подключений.

Обычному администратору не рекомендуется вводить произвольные названия стратегии. Используйте значение, поддерживаемое текущей версией AI Core.

Интеграция Bitrix24

Нижняя группа параметров относится к публичной точке входа Bitrix24. Для обычной работы AI Core на текущем сайте она не нужна и по умолчанию выключена.

Включайте её только при наличии реальной интеграции и после настройки проверки входящих запросов.

Bitrix24 endpoint включён

Включает приём входящих обращений через специальную точку AI Core. Не активируйте флажок «на всякий случай».

Перед включением должен быть настроен хотя бы предусмотренный проектом механизм подтверждения запроса: application token, HMAC или JWT.

Максимальный размер запроса Bitrix24 endpoint, байт

Ограничивает тело входящего HTTP-запроса. Стандартное значение — 1048576 байт, примерно 1 МБ.

Предел защищает endpoint от чрезмерно больших входных данных. Увеличивайте только если интеграция действительно передаёт большие полезные данные и это согласовано с серверными ограничениями.

Bitrix24 application token

Секрет для проверки интеграции. Поле отображается как пароль и не выводит сохранённое значение обратно.

Если поле оставить пустым и сохранить настройки, текущее значение сохраняется. Вводите значение только при первичной настройке или смене секрета.

HMAC secret для endpoint

Секрет для проверки HMAC-подписи входящего запроса. Также сохраняется в защищённом виде и не показывается обратно в форме.

Не используйте один и тот же секрет для разных независимых систем без необходимости.

Разрешённые callback-hosts

Список доменов, на которые разрешены обратные обращения. AI Core принимает callback URL только по HTTPS и только для разрешённых доменов.

Составляйте список минимально: добавляйте только те хосты, которые действительно участвуют в интеграции.

JWT client_id / audience

Ожидаемое значение получателя токена. Используется при JWT-проверке и должно совпадать с настройкой вашей интеграции.

JWT issuer (iss)

Ожидаемый издатель JWT. Заполняется только при использовании соответствующей схемы авторизации.

Bitrix24 member_id для JWT

Позволяет связать JWT с конкретным порталом/участником интеграции.

JWT public key

Публичный ключ, которым AI Core проверяет подпись JWT. Это многострочное поле. Публичный ключ не является секретным аналогом приватного ключа, но его содержимое должно точно соответствовать ключевой паре интеграции.

Если JWT не используется, связанные поля оставляйте пустыми.

Особенность секретных полей

Поля application token и HMAC secret намеренно не показывают текущее сохранённое значение. При пустом поле существующий секрет остаётся без изменений.

Это сделано для того, чтобы администратор не мог случайно скопировать секрет из HTML-формы. Не воспринимайте пустое поле после повторного открытия страницы как отсутствие сохранённого значения.

Рекомендуемые значения для начала работы

Если нет специальных требований, не меняйте параметры сразу после установки. Стартовая конфигурация рассчитана на обычный сценарий:

• TTL кэша — 3600 секунд;
• HTTP timeout — 25 секунд;
• очередь включена;
• пачка очереди — 10;
• worker — около 50 секунд;
• до 5 попыток задачи;
• задержка retry от 30 до 300 секунд;
• таймаут блокировки — 600 секунд;
• контроль бюджетов включён;
• repair structured output выключен;
• журнал — 30 дней;
• маскирование включено;
• предпросмотр — 2000 символов;
• максимальный промпт — 32000 символов;
• маршрутизация — priority;
• публичный Bitrix24 endpoint выключен.

Если после изменения настроек возникла проблема

1. Верните последнее изменённое значение к предыдущему.
2. Откройте «Диагностику».
3. Проверьте очередь и фоновые задания.
4. Выполните Dummy-тест в «Песочнице».
5. Затем проверьте реального провайдера.
6. Посмотрите журнал.

Если проблема появилась после изменения очереди, временно не меняйте сразу все параметры retry и worker — иначе будет трудно определить исходную причину.

Какие настройки лучше не менять без необходимости

• стратегию маршрутизации;
• максимальную длину промпта;
• внутренние параметры очереди и блокировки;
• Bitrix24 endpoint и его параметры безопасности;
• список типов маскирования.

Для обычной эксплуатации основная работа выполняется через «Провайдеры», «Промпты», «Песочницу» и «Лимиты». Глобальные параметры нужны реже.

[Скриншот 3: нижняя часть настроек — журнал, маршрутизация и Bitrix24 endpoint]

Итог

Глобальные настройки задают общие ограничения и поведение инфраструктуры AI Core. Начинайте со стандартных значений, меняйте один параметр за раз и после существенных изменений проверяйте «Диагностику», «Песочницу» и «Журнал». Публичный Bitrix24 endpoint оставляйте выключенным, если он не используется в конкретной интеграции.