Встроенный AI и своя модель

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

Где в облакеКопировать ссылку на раздел

«Настройки» (шестерёнка у названия пространства) → вкладка «AI». Читать страницу могут все участники, менять подключение — только владелец пространства. Блок «Встроенный AI» виден, если на вашем сервере он настроен; на self-host его обычно нет, и там страница называется «Модель AI», а AI работает только на вашей модели (см. Self-host).

Встроенный AIКопировать ссылку на раздел

Это общая модель сервера, она работает без вашего ключа и включена у пространств сразу. Владелец может выключить её переключателем «Использовать встроенный AI». На странице видно, какая модель и какой провайдер обрабатывают тексты пространства. Если для вашей компании это важно, подключите свою модель.

КвотаКопировать ссылку на раздел

• Квота считается в токенах (вход плюс выход) за календарный месяц по UTC и сбрасывается 1-го числа. Размер задаёт сервер.
• Квота общая на все пространства владельца: расход пишется на самого раннего по вступлению владельца пространства.
• Поиск по смыслу (эмбеддинги) работает на ключе платформы и в квоту не входит.
• Встроенный AI недоступен, если у владельца не подтверждена почта, аккаунт заблокирован администратором сервера или AI выключен в пространстве. Причина написана жёлтой плашкой в настройках.

Где видно остаток:

• индикатор в нижней части сайдбара — «Встроенный AI» и расход вида «120 тыс. / 2 млн», клик ведёт в настройки; виден всем участникам;
• полоса под шапкой страниц пространства, когда использовано 80% («осталось N% квоты») и когда квота закончилась, с кнопками «Подробнее» и «Скрыть»;
• блок «Использование в …» с названием текущего месяца в «Настройки → AI»: итог по квоте виден всем, а разбивка по функциям и пространствам — владельцу квоты.

Что происходит, когда квота закончиласьКопировать ссылку на раздел

AI-операции на встроенном ключе останавливаются до следующего месяца. Вместо результата AI в соответствующих местах показывается карточка «Квота встроенного AI закончилась» с кнопкой «Подключить свою модель»: так выглядят страница AI-продакт, оценки фич, разбивка на задачи, сборка карты системы. Бот в Telegram отвечает сообщением об исчерпанной квоте. Всё, что не требует AI, продолжает работать. Если исчерпан общий потолок сервера, встроенный AI временно отключается у всех, кто не подключил свою модель.

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

Своя модельКопировать ссылку на раздел

Подключить свою модель могут только владельцы. Квоту она не расходует и главнее встроенного AI.

1. Откройте «Настройки → AI» и нажмите «Подключить свою модель».
2. Выберите провайдера: «OpenAI», «Claude» или «OpenAI-совместимый» (DeepSeek, OpenRouter, свой сервер).
3. Для совместимого провайдера укажите «Адрес API» — публичный https-адрес, например https://api.deepseek.com/v1, и «Модель». Для OpenAI и Claude модель можно не указывать: подставится значение по умолчанию.
4. Вставьте «Ключ API». Он хранится в зашифрованном виде, потом виден только хвост из четырёх символов. При смене провайдера или адреса ключ нужно ввести заново.
5. Нажмите «Проверить подключение»: облако сделает тестовый запрос. Успех выглядит как «Подключение работает · модель …», при ошибке видна причина.
6. Нажмите «Сохранить». Сохранение тоже проверяет подключение; после него появляется сообщение «Своя модель подключена».

После подключения все AI-операции пространства идут через вашу модель. В сайдбаре вместо полосы квоты показано название модели и подпись «Своя модель · без квоты», а в настройках — расход токенов по функциям отдельно от квоты. Внутренние адреса (localhost, частные сети) для API не принимаются.

Если ключ перестанет работать, AI-операции будут завершаться ошибкой «Свой ключ AI не работает», автоматического возврата на встроенный AI нет. Исправьте ключ кнопкой «Изменить» или нажмите «Отключить свою модель»: пространство вернётся на встроенный AI, а там, где его нет, AI выключится.

Что отключается без AIКопировать ссылку на раздел

• Сайдбар и шапка: «AI-продакт» и счётчик рисков.
• Фича: вкладка «План», баннер AI-оценки и «Оценка по журналу», фильтр «С замечаниями AI».
• Релиз: панель AI-сводки.
• «Тест-план»: кнопка «Сгенерировать чек-лист» неактивна, рядом ссылка на настройки AI.
• Карта системы: «Собрать карту» и «Пересобрать»; вкладка «Архитектура» предлагает включить AI.
• Заметки: кнопка «Предложить с AI».
• Telegram-бот отвечает шаблоном фактов с подсказкой включить AI.

Связь с журналом и агентамиКопировать ссылку на раздел

Локальные агенты и журнал на вашей машине используют собственные модели и встроенный AI Actari не получают: квота относится только к функциям облака. Токены, потраченные агентами на задачи, пишутся отдельно — см. Учёт времени.