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

Как работает встроенный AI пространства и как подключить свою модель.

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

## Где в облаке

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

![Настройки AI: встроенный AI, использование квоты и своя модель](/docs/cloud/ai-settings.png)

## Встроенный AI

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

### Квота

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

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

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

### Что происходит, когда квота закончилась

AI-операции на встроенном ключе останавливаются до следующего месяца. Вместо результата AI в соответствующих местах показывается карточка «Квота встроенного AI закончилась» с кнопкой «Подключить свою модель»: так выглядят страница [AI-продакт](/docs/cloud/ai-product), оценки фич, разбивка на задачи, сборка [карты системы](/docs/cloud/system-map). Бот в [Telegram](/docs/cloud/telegram-bot) отвечает сообщением об исчерпанной квоте. Всё, что не требует 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 не получают: квота относится только к функциям облака. Токены, потраченные агентами на задачи, пишутся отдельно — см. [Учёт времени](/docs/cloud/time-tracking).