Локальная редакция: установка, ядро и поставщики моделей

Локальная редакция — отдельная сборка «АСТРА ИИ [КОД]». Она работает со своим ядром без входа и с поставщиком моделей, которого вы подключаете сами. Вход в АСТРА ИИ [ХАБ] не нужен. Перейти из одной редакции в другую внутри приложения нельзя.

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

Установить

Получите пакет локальной редакции для своей ОС у поставщика. Ядро входит в пакет, отдельно его скачивать не нужно. Пакеты .exe, .deb, .AppImage и .dmg устанавливаются так же, как в основной редакции — см. раздел «Установка и запуск». При первом запуске выполните шаги ниже.

Для работы нужны адрес программного интерфейса (API) поставщика моделей, доступная модель и, если поставщик этого требует, ключ API. Текст запросов и содержимое файлов, которые читает агент, передаются на сервер выбранного поставщика моделей.

Если на компьютере уже работала основная редакция, после перехода на локальную в ленте может появиться предупреждение «Ядро не открыло базу состояния: поиск и цели сессий могут не работать» — см. раздел «Известные ограничения».

Ядро

Ядро без входа устанавливается вместе с приложением, и приложение находит его само. Подходит ядро версии 0.7.0 или новее; ядро основной редакции (со входом через АСТРА ИИ [ХАБ]) не подходит.

При запуске приложение ищет ядро в таком порядке:

1. По пути, сохранённому в настройках.
2. В папке установки приложения.
3. В Linux и macOS — файл ~/.local/bin/astracode.
4. Команду astracode (astracode.exe в Windows) в каталогах из переменной PATH.

Если прежняя версия сохранила путь к отдельному файлу ядра и файл на месте, приложение запускает его, а не встроенное ядро. Чтобы вернуться к встроенному ядру, откройте раздел Настройки → Ядро и диагностика, в группе Ядро нажмите Остановить, затем Сбросить у поля Путь к ядру и Запустить.

Другое ядро указывается там же, в поле Путь к ядру. Пока ядро работает, кнопки Сохранить, Сбросить и Выбрать файл недоступны — сначала остановите его кнопкой Остановить. Храните файл ядра в постоянной папке, а не в «Загрузках»: приложение запоминает путь к нему. Приложение показывает номер версии ядра без служебного суффикса редакции.

Если ядро не подошло

Если подходящее ядро не найдено, при запуске открывается экран выбора ядра. Укажите исполняемый файл ядра или папку с ним в поле Путь к ядру и нажмите Сохранить и проверить или выберите файл кнопкой Выбрать файл ядра. Если поле Путь к ядру заполнено, на экране есть кнопка Использовать автопоиск: она очищает сохранённый путь и возвращает автоматический поиск.

Заголовок экрана показывает причину:

• Это ядро требует АСТРА ИИ [ХАБ] — найдено ядро основной редакции;
• заголовок, начинающийся с Обновите ядро, — версия ядра ниже 0.7.0;
• Не удалось запустить ядро — ядро подходит, но не запустилось. Под заголовком показан текст ошибки. В этом состоянии поле пути скрыто, а на экране две кнопки: Повторить — проверить ядро ещё раз, Выбрать другое ядро — указать другой файл.

Если под заголовком написано «Не удалось проверить версию ядра» с текстом GLIBC_… not found, ядро собрано для более новой версии Linux. Узнайте версию glibc командой getconf GNU_LIBC_VERSION и получите ядро для неё: например, для Astra Linux 1.7 нужно ядро для glibc 2.28. Если в тексте error while loading shared libraries с libcap.so.2 или libdbus-1.so.3, установите пакеты libcap2 и libdbus-1-3.

Активировать лицензионное ядро

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

При запросе активации выполните в терминале операционной системы:

astracode license activate --file <путь к license.key>

Если команда не найдена, укажите полный путь к файлу ядра. Затем нажмите Повторить в приложении. Та же команда нужна, если лицензия недействительна, повреждена или её срок действия истёк, — активируйте новый файл лицензии. Если приложение сообщает о неверных дате или времени, исправьте часы ОС и повторите проверку. Если приложение сообщает «Лицензия отозвана», обратитесь к поставщику.

Пройти первоначальную настройку

После проверки ядра открывается тот же мастер первого запуска, что и в основной редакции, но без входа в АСТРА ИИ [ХАБ] и с двумя дополнительными шагами:

1. На приветствии нажмите Начать.
2. На шаге Язык ответов агента выберите Русский или English и нажмите Продолжить. Это язык ответов агента и сообщений ядра; интерфейс приложения остаётся русским. Если язык уже задан в настройках ядра, он выбран заранее.
3. Выберите оформление, стиль общения и, если ОС предложит, включите уведомления — см. раздел «Первоначальная настройка».
4. На шаге Выберите режим работы выберите Чат или Код.
5. На шаге Права агента выберите Чтение, Правки или Полный доступ и нажмите Продолжить. Кнопка Оставить «Правки» сохраняет вариант по умолчанию. Чем различаются режимы — см. раздел «Права и подтверждения».
6. Для режима Код нажмите Выбрать папку…, выберите папку и подтвердите доверие. Кнопка Выбрать позже пропускает шаг.
7. Пройдите короткий тур или нажмите Пропустить тур.

Поставщик моделей и модель настраиваются после завершения мастера.

Подключить поставщика моделей

1. Откройте раздел Настройки → Провайдеры и нажмите + Добавить провайдера.
2. В форме Новый провайдер заполните поля Название, Адрес API и, если поставщик этого требует, API-ключ.
3. Нажмите Далее: приложение проверит подключение и загрузит список моделей. Ошибка показывается под полем, к которому она относится.
4. Выберите модель. Оставьте отмеченным флажок Использовать для новых запросов во всех чатах, если этот поставщик должен стать активным. Первый добавленный поставщик становится активным сам.
5. Нажмите Добавить и проверьте модель у поля ввода.

Поставщика без доступных моделей добавить нельзя. В поле Адрес API укажите адрес программного интерфейса поставщика, а не адрес его сайта или личного кабинета. Адрес, ключ и модель уже добавленного поставщика меняются в форме изменения — там же есть кнопка Проверить подключение. После смены адреса или ключа прежние результаты проверки моделей сбрасываются.

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

Кнопка Проверить подключение заодно проверяет, умеет ли модель вызывать инструменты: результат показан значком Инструменты.

В сессиях доступны модели активного поставщика. Если настройки поставщиков недоступны для изменения, дождитесь завершения запросов во всех сессиях. Если после смены поставщика модель, выбранная для роли субагента, больше недоступна, приложение сбрасывает её и сообщает: «Модель сброшена на наследование у ролей субагентов: …». Кнопка Сбросить модели… в разделе Настройки → Субагенты в локальной редакции снимает модель у всех ролей, включая встроенные.

Проверить работу

Отправьте короткий текстовый запрос в новом чате. Затем откройте папку проекта и попросите агента прочитать README, ничего не меняя.

При ошибке проверьте запуск ядра, адрес API, ключ и модель. Состояние ядра показано в разделе Настройки → Ядро и диагностика. Для обращения в поддержку откройте раздел Настройки → О программе и в блоке Отчет для поддержки нажмите Скопировать сводку — см. раздел «Диагностика и поддержка». Редакция ядра уже указана в сводке.

Обновить

В разделе Настройки → О программе, в блоке Обновления, показано Автообновление отключено: встроенного обновления в локальной редакции нет. Новую версию приложения установите из нового пакета так же, как при первой установке. Встроенное ядро обновляется вместе с приложением. Если вы указали отдельное ядро, обновляйте его командой astracode update по инструкции поставщика; версия ядра должна оставаться не ниже 0.7.0. Для ядра, положенного файлом вручную или установленного вместе с приложением, команда не работает и сообщает «Could not detect the AstraCode installation method». После обновления ядра откройте приложение и убедитесь, что оно прошло проверку ядра.

Перед переносом данных сделайте резервную копию — см. раздел «Данные и восстановление».