Вход и аккаунт АСТРА ИИ [ХАБ]
АСТРА ИИ [ХАБ] — сервис, через который приложение получает доступ к языковым моделям. Без входа в АСТРА ИИ [ХАБ] работа с агентом невозможна.
Вход выполняется в браузере, на странице входа АСТРА ИИ [ХАБ]. На стандартном сервере АСТРА ИИ [ХАБ] войти можно двумя способами:
- аккаунтом АСТРА ИИ [ХАБ] — по имени пользователя или адресу электронной почты и паролю АСТРА ИИ [ХАБ];
- через ГК Астра — корпоративной учётной записью группы компаний «Астра», кнопкой ГК Астра на странице входа. Отдельный пароль АСТРА ИИ [ХАБ] для этого не нужен.
Если у вас нет аккаунта или доступа к моделям, обратитесь к администратору АСТРА ИИ [ХАБ] вашей организации. На сервере АСТРА ИИ [ХАБ] вашей организации способы входа задаёт её администратор.
Первый вход
Вход выполняется на втором шаге мастера первого запуска.
- На экране Добро пожаловать в АСТРА ИИ [КОД] нажмите Начать.
- На шаге Войдите в АСТРА ИИ [ХАБ] под текстом шага показана плашка с адресом сервера АСТРА ИИ [ХАБ], например
hub.ai.astra-team.ru. Если администратор вашей организации выдал адрес своего сервера, щёлкните по плашке и укажите его — см. подраздел «Подключение к своему серверу АСТРА ИИ [ХАБ]» ниже. - Нажмите Войти через АСТРА ИИ [ХАБ]. Страница входа откроется в браузере, а в приложении появится надпись Ждем вас в браузере.
- Войдите в АСТРА ИИ [ХАБ] в браузере в течение 5 минут — аккаунтом АСТРА ИИ [ХАБ] или через ГК Астра, см. подраздел «Вход в браузере» ниже — и вернитесь в приложение. После сообщения Вход выполнен мастер перейдёт к шагу Выберите оформление — см. раздел «Первоначальная настройка».
![Шаг входа: плашка с адресом сервера АСТРА ИИ [ХАБ]](images/next-interface/server-chip.png)
Пока приложение ждёт браузер, под надписью показан адрес сервера. Если страница входа не открылась, нажмите Настройки подключения рядом с вопросом «Страница входа не открылась?»: вход будет отменён и откроется форма Подключение к АСТРА ИИ [ХАБ]. Чтобы просто отменить вход, нажмите Отменить вход.
Оставьте приложение открытым до завершения входа. Не оставляйте компьютер с открытым приложением без блокировки экрана: любой, кто получит доступ к вашему сеансу, сможет работать от вашего имени.
Вход в браузере
После нажатия Войти через АСТРА ИИ [ХАБ] (на экране входа — Продолжить через АСТРА ИИ [ХАБ]) приложение открывает страницу входа в браузере, который выбран в системе по умолчанию. Вверху страницы написано «Астра ИИ [Хаб]», ниже — форма Sign in to your account. Надписи формы на английском языке.
Вход проходит в два шага: сначала имя пользователя, затем пароль или другой способ входа. Кнопка ГК Астра появляется на втором шаге.
![Второй шаг входа: пароль АСТРА ИИ [ХАБ] или кнопка «ГК Астра»](images/next-interface/hub-login-password.png)
Аккаунтом АСТРА ИИ [ХАБ]
- В поле Username or email введите имя пользователя или адрес электронной почты аккаунта АСТРА ИИ [ХАБ] и нажмите Sign In.
- В поле Password введите пароль АСТРА ИИ [ХАБ] и нажмите Sign In.
- Дождитесь страницы Аутентификация получена и вернитесь в приложение — см. подраздел «Страница после входа» ниже.
Через ГК Астра
Этот способ — для сотрудников группы компаний «Астра» с корпоративной учётной записью.
- В поле Username or email введите корпоративный адрес электронной почты и нажмите Sign In.
- На втором шаге поле Password не заполняйте: под надписью Or sign in with нажмите кнопку ГК Астра.
- Откроется корпоративная страница входа ГК Астра: логотип «Астра» и форма Вход в учетную запись. В поле Имя пользователя или E-mail введите имя пользователя или адрес электронной почты корпоративной учётной записи, в поле Пароль — её пароль и нажмите Вход. Язык страницы выбирается в списке справа от заголовка.
- Браузер вернётся к приложению. Дождитесь страницы Аутентификация получена и вернитесь в приложение.
Повторный ввод пароля
При каждом входе приложение просит сервер входа заново проверить учётную запись, даже если вы уже вошли в АСТРА ИИ [ХАБ] в этом браузере. Поэтому на втором шаге поле Username or email бывает уже заполнено, а над полем Password написано «Please re-authenticate to continue». Это не ошибка: введите пароль или снова нажмите ГК Астра.
Проверьте имя в поле Username or email: браузер мог подставить другой сохранённый аккаунт. Чтобы ввести другое имя, нажмите значок с круговыми стрелками справа от поля — вход начнётся с первого шага.
Страница после входа
Когда вход в браузере завершён, сервер входа возвращает браузер на локальный адрес приложения http://127.0.0.1:<порт>. Эту страницу показывает само приложение, на русском или английском языке.
Страница Аутентификация получена (Authentication received) означает, что вход в браузере завершён. Вкладку можно закрыть. Вернитесь в приложение и дождитесь сообщения Вход выполнен: приложение ещё подключается к АСТРА ИИ [ХАБ] и загружает модели.
Если вход сорвался, на странице показаны заголовок и код ошибки (строка Код ошибки), а приложение возвращается к шагу Войдите в АСТРА ИИ [ХАБ] или к экрану входа без объяснения причины. Запишите код и время попытки — они понадобятся поддержке.
| Заголовок и код ошибки | Что произошло | Что сделать |
|---|---|---|
Вход отменён (Sign-in cancelled), access_denied |
Вход отменён на странице входа | Начните вход заново в приложении |
Не удалось войти (Couldn't sign in), authorization_error |
Сервер входа вернул ошибку вместо результата входа | Повторите вход. Если ошибка повторяется, обратитесь к администратору АСТРА ИИ [ХАБ] и назовите код и время попытки |
Ссылка для входа устарела (Sign-in link is out of date), state_mismatch |
Ответ сервера входа не относится к текущей попытке входа | Начните вход заново в приложении |
Не удалось завершить вход (Couldn't complete sign-in), token_exchange_failed |
Вход в браузере прошёл, но приложение не получило данные входа от сервера входа | См. подраздел «Ошибка token_exchange_failed» ниже |
Не удалось проверить аккаунт (Couldn't verify your account), invalid_token |
Сервер входа вернул данные, которые приложение не принимает. Например, адрес сервера входа в приложении не совпадает с адресом, который указывает сам сервер | Проверьте поле Адрес сервера входа в форме Подключение к АСТРА ИИ [ХАБ]. Если адрес верный, обратитесь к администратору: см. подраздел «Для администратора: подготовка сервера» |
Не удалось сохранить вход (Couldn't save sign-in), credentials_not_saved |
Приложение не смогло сохранить вход на компьютере | Войдите снова. Если ошибка повторяется, обратитесь в поддержку |
| Выбран другой аккаунт (You selected a different account) | В приложении сохранён вход под другим аккаунтом | В приложении нажмите Выйти и войти другим аккаунтом — см. подраздел «Способ входа и аккаунт» ниже |
Ошибка token_exchange_failed
Страница Не удалось завершить вход с кодом token_exchange_failed означает, что в браузере вы вошли и сервер входа вернул приложению одноразовый код, но обменять его на данные входа не удалось. Обмен выполняет ядро приложения напрямую, без браузера. Поэтому причина обычно в сети или сертификатах компьютера, а не в пароле или способе входа.
Проверьте по порядку:
- Корневой сертификат. Браузер проверяет сертификат сервера входа по своему хранилищу, а ядро — только по системному хранилищу сертификатов. Если в системе нет корневого сертификата, которым подписан сервер входа, страница входа открывается, а обмен не проходит. Стандартный сервер подписан корневым сертификатом GlobalSign Root R46, которого нет, например, в Astra Linux 1.7 — см. раздел «Диагностика и поддержка», подраздел «Linux и Astra Linux». Для сервера вашей организации выберите сертификат в строке Для сервера входа формы Подключение к АСТРА ИИ [ХАБ] или установите корневой сертификат организации в систему.
- Прокси. Если приложение запущено с переменными
HTTPS_PROXYилиHTTP_PROXY, ядро обращается к серверу входа через этот прокси. Добавьте адрес сервера входа вNO_PROXY, напримерNO_PROXY=.astra-team.ru. - Повтор. Нажмите Продолжить через АСТРА ИИ [ХАБ] или Войти через АСТРА ИИ [ХАБ] и войдите снова. Если ошибка повторяется, обратитесь в поддержку: укажите время попытки, способ входа (аккаунт АСТРА ИИ [ХАБ] или ГК Астра) и ОС. Ответа сервера входа нет ни на странице, ни в приложении, поэтому по времени попытки администратор найдёт её в журнале сервера входа.
Способ входа и аккаунт
Приложение запоминает аккаунт АСТРА ИИ [ХАБ], под которым выполнен вход, а не способ входа. При повторном входе, например после истечения сессии, входите тем же способом, что и в первый раз.
Если войти другим способом или под другой учётной записью и сервер АСТРА ИИ [ХАБ] сочтёт это другим аккаунтом, браузер покажет страницу Выбран другой аккаунт, а приложение — экран с тем же названием. Чтобы работать под новым аккаунтом, нажмите в приложении Выйти и войти другим аккаунтом, затем Выйти и войти. Проекты и история при этом остаются на компьютере.
Подключение к своему серверу АСТРА ИИ [ХАБ]
По умолчанию приложение подключается к стандартному серверу АСТРА ИИ [ХАБ] hub.ai.astra-team.ru. Если в вашей организации работает свой сервер АСТРА ИИ [ХАБ], подключите приложение к нему до входа — в форме Подключение к АСТРА ИИ [ХАБ].
Что получить у администратора
Адреса и сертификаты выдаёт администратор АСТРА ИИ [ХАБ] вашей организации:
| Что | Пример | Где указать |
|---|---|---|
| Адрес сервера входа | https://auth.company.ru/realms/astra — оканчивается на /realms/<имя> |
Поле Адрес сервера входа |
| Адрес сервера АСТРА ИИ [ХАБ] | https://hub.company.ru/api/v1/client-config — оканчивается на /api/v1/client-config |
Поле Адрес сервера АСТРА ИИ [ХАБ] |
| Сертификат сервера, если серверы подписаны собственным удостоверяющим центром организации | Файл .pem, .crt или .cer в формате PEM; один файл может подходить для обоих серверов |
Блок Сертификаты сервера в форме и, кроме того, системное хранилище сертификатов |
| Учётная запись на этом сервере АСТРА ИИ [ХАБ] с доступом к моделям | — | Вводится в браузере при входе |
Если компьютер выходит в сеть через прокси или VPN, попросите администратора сети добавить оба сервера в исключения прокси (см. раздел «Диагностика и поддержка»).
Сертификат из формы использует только ядро приложения. Браузер, в котором выполняется вход, и проверка адреса входа его не видят, поэтому собственный корневой сертификат организации нужно также установить в хранилище сертификатов системы, а если браузер ведёт своё хранилище, — и в браузер. Как это сделать в вашей ОС, уточните у администратора.
Как подготовить сервер и проверить его, описано в подразделе «Для администратора: подготовка сервера» ниже.
Открыть форму
Форма Подключение к АСТРА ИИ [ХАБ] открывается:
- щелчком по плашке с адресом сервера на шаге Войдите в АСТРА ИИ [ХАБ] мастера или на экране входа Войдите в АСТРА ИИ [КОД] (подсказка плашки — Настройки подключения);
- ссылкой Настройки подключения на экране ожидания браузера, рядом с вопросом «Страница входа не открылась?»;
- кнопкой Настройки подключения на экранах ошибок адреса и связи с сервером (например, Сервер АСТРА ИИ [ХАБ] не отвечает, Ошибка в настройках подключения, Не удалось войти в АСТРА ИИ [ХАБ]);
- кнопкой Настройки подключения в строке Сервер раздела Настройки → Аккаунт — если вход уже выполнен, сначала нужно выйти из аккаунта (см. подраздел «Сменить сервер после входа» ниже).
Заполнить форму
![Форма «Подключение к АСТРА ИИ [ХАБ]» с адресами и сертификатами сервера](images/next-interface/server-form.png)
- В поле Адрес сервера входа укажите адрес сервера входа, например
https://auth.company.ru/realms/astra. - В поле Адрес сервера АСТРА ИИ [ХАБ] укажите адрес сервера АСТРА ИИ [ХАБ], например
https://hub.company.ru/api/v1/client-config. - Если администратор выдал файл сертификата, в блоке Сертификаты сервера нажмите Выбрать файл… в строке Для сервера входа, затем в строке Для сервера АСТРА ИИ [ХАБ] и выберите файл. Имя выбранного файла показано в строке, полный путь — в подсказке; кнопка × убирает сертификат.
- Нажмите Сохранить и проверить. Пока идёт проверка, на кнопке написано Проверяем сервер…. Кнопка Отмена закрывает форму без изменений.
Оба адреса обязательны. Форма не примет адрес, если он:
- не начинается с
https://— «Адрес должен начинаться с «https://».»; - содержит имя пользователя,
?или#— «Адрес не должен содержать логин, «?» или «#».»; - записан с ошибкой — «Адрес указан неверно. Пример: https://auth.example.ru/realms/astra.».
Храните файлы сертификатов в постоянной папке: приложение запоминает путь к ним. Если файл удалить или переместить, вход перестанет работать (см. подраздел «Если вход не удаётся»).
Проверка сервера
Приложение сначала сохраняет адреса, затем проверяет оба сервера — до открытия браузера. Поэтому ошибка адреса или сертификата видна сразу, а не после долгого ожидания страницы входа.
Если проверка прошла, форма закрывается, а плашка показывает новый адрес, например hub.company.ru. Нажмите Войти через АСТРА ИИ [ХАБ] в мастере или Продолжить через АСТРА ИИ [ХАБ] на экране входа и войдите учётной записью вашего сервера.
Если проверка не прошла, под полями появляется сообщение «Адрес сохранен, но проверка не прошла:» со списком причин. Исправьте адреса или сертификаты и снова нажмите Сохранить и проверить. Кнопка Продолжить с этим адресом оставляет адреса как есть и закрывает форму.
| Сообщение проверки | Что сделать |
|---|---|
| «Система не доверяет сертификату сервера входа …, браузер покажет предупреждение. Установите сертификат сервера в систему или обратитесь к администратору.» | Установите корневой сертификат организации в систему: сертификат из формы браузер не использует |
| «Сервер АСТРА ИИ [ХАБ] … не отвечает или не принял сертификат. Проверьте адрес и сертификат.» | Проверьте поле Адрес сервера АСТРА ИИ [ХАБ] и выберите файл сертификата в строке Для сервера АСТРА ИИ [ХАБ] |
| «Адрес сервера входа … не найден. Проверьте адрес.» | Проверьте поле Адрес сервера входа |
| «Сервер входа … не ответил вовремя», «Сервер входа … недоступен» | Проверьте сетевое подключение, прокси и адрес сервера входа |
| «Сервер входа … ответил кодом …. Проверьте адрес сервера входа, обычно он заканчивается на /realms/astra.» | Проверьте адрес сервера входа: часть после /realms/ должна совпадать с той, что выдал администратор |
| «Не удалось применить настройки подключения. Проверьте файлы сертификатов.» | Выберите файлы сертификатов заново |
При сохранении ядро может отказать сразу, ещё до проверки:
| Сообщение | Что сделать |
|---|---|
| «Файл сертификата не найден.» | Выберите файл заново |
| «Файл сертификата не прочитан. Нужен сертификат в формате PEM.» | Попросите у администратора сертификат в формате PEM |
| «Настройки подключения повреждены. Нажмите «Вернуть стандартный сервер» и укажите адреса заново.» | Нажмите Вернуть стандартный сервер, затем снова откройте форму и укажите адреса |
| «Вы вошли на сервере … Приложение выйдет из аккаунта и сохранит новый адрес, проекты и история останутся.» | Вход сохранён для другого сервера. Нажмите Выйти и сменить сервер в форме |
Вернуть стандартный сервер
Если указан свой сервер, в форме есть кнопка Вернуть стандартный сервер. Она удаляет свои адреса и сертификаты и возвращает стандартный сервер, после чего проверка выполняется для него. Если стандартный сервер недоступен из вашей сети, проверка сообщит об этом.
Сменить сервер после входа
Пока сохранён вход в АСТРА ИИ [ХАБ], сервер меняется только через выход из аккаунта.
- Откройте раздел Настройки → Аккаунт. В строке Сервер показан адрес сервера; у стандартного сервера рядом с адресом написано «стандартный».
- Нажмите Настройки подключения.
- В окне Сменить сервер АСТРА ИИ [ХАБ]? прочитайте предупреждение: войти через другой сервер можно только после выхода из аккаунта, проекты и история сохранятся. Если агент выполняет запрос, окно предупреждает, что выход его остановит. Нажмите Выйти и сменить сервер или Отмена.
- После выхода откроется экран входа с формой Подключение к АСТРА ИИ [ХАБ]: укажите адреса, нажмите Сохранить и проверить, затем войдите заново.
![Окно «Сменить сервер АСТРА ИИ [ХАБ]?» в разделе «Аккаунт»](images/next-interface/account-change-server.png)
Сервер, заданный администратором
Администратор может заранее настроить приложение на сервер организации, тогда вводить адреса не нужно.
- Поставка с сервером организации. Приложение можно собрать с адресами сервера организации. В такой поставке плашка сразу показывает сервер организации, а в разделе Настройки → Аккаунт рядом с его адресом написано «стандартный». Кнопка Вернуть стандартный сервер в этой поставке возвращает сервер организации. Если на компьютере уже сохранён вход на другом сервере, приложение останется на нём: чтобы перейти на сервер организации, выйдите из аккаунта и перезапустите приложение. Если адрес раньше вводили в форме, нажмите в ней Вернуть стандартный сервер.
- Переменные окружения. Адреса и сертификаты задают переменные окружения ядра:
ASTRAHUB_AUTH_ISSUER_URL(адрес сервера входа),ASTRAHUB_CONFIG_URL(адрес сервера АСТРА ИИ [ХАБ]),ASTRAHUB_AUTH_CA_CERTIFICATEиASTRAHUB_CA_CERTIFICATE(пути к файлам сертификатов для сервера входа и для сервера АСТРА ИИ [ХАБ]). Переменные действуют сильнее адресов из формы. Если хотя бы одна из них задана, сервер в приложении не меняется: плашка с адресом неактивна (подсказка «Адрес задан в настройках системы и здесь не меняется»), в строке Сервер раздела Настройки → Аккаунт написано «задан в настройках системы», а кнопка Настройки подключения недоступна. Чтобы сменить сервер, обратитесь к администратору.
Для администратора: подготовка сервера
Сервер входа АСТРА ИИ [ХАБ] — Keycloak. Приложение входит через клиент astra-cli в той области (realm), адрес которой вы выдаёте пользователям: по коду авторизации с PKCE, без секрета клиента. Результат входа браузер передаёт приложению на локальный адрес http://127.0.0.1 с портом, который приложение выбирает заново при каждом входе.
Настройте в этой области клиент:
| Параметр клиента в Keycloak | Значение |
|---|---|
| Client ID | astra-cli |
| Client authentication | Выключено: клиент публичный (в старых версиях Keycloak — Access Type public) |
| Authentication flow | Включён Standard flow. Метод PKCE S256 можно сделать обязательным в расширенных настройках клиента (Advanced → Proof Key for Code Exchange Code Challenge Method) |
| Valid redirect URIs | http://127.0.0.1:* — любой порт на адресе 127.0.0.1. Адрес localhost приложение не использует |
| Области доступа (client scopes) | openid, email, profile |
| Refresh token | Должен выдаваться (по умолчанию в Keycloak так и есть): по нему приложение продлевает вход |
Кроме того:
- Поле
issuerв токенах Keycloak должно в точности совпадать с адресом сервера входа, который вы выдаёте пользователям (без/в конце). Если Keycloak работает за обратным прокси, задайте в Keycloak внешний адрес сервера (hostname): токены с другимissuerприложение отклонит. - Сервер АСТРА ИИ [ХАБ] должен принимать токены этой области, а учётная запись пользователя — состоять в организации на сервере АСТРА ИИ [ХАБ] и иметь доступ к моделям. Если членство в организации отключено, вход в браузере проходит, а приложение показывает АСТРА ИИ [ХАБ] временно недоступен.
Как проверить сервер:
- Откройте в браузере адрес сервера входа с окончанием
/.well-known/openid-configuration, напримерhttps://auth.company.ru/realms/astra/.well-known/openid-configuration. Должна открыться страница в формате JSON, а значениеissuerв ней — совпасть с адресом сервера входа. - На компьютере пользователя выполните
curl -i https://hub.company.ru/api/v1/client-config(в PowerShell —curl.exe -i …). Код ответа401без входа — это нормально: сервер доступен и его сертификат принят. Ошибка сертификата или соединения означает, что сервер недоступен из сети пользователя или корневой сертификат организации не установлен в системе. - В приложении укажите оба адреса в форме Подключение к АСТРА ИИ [ХАБ] и нажмите Сохранить и проверить. Затем войдите тестовой учётной записью и откройте меню моделей у поля ввода: в нём должны быть модели. Если вход проходит, но приложение показывает Не удалось завершить настройку или АСТРА ИИ [ХАБ] временно недоступен, проверьте, что учётная запись состоит в организации на сервере АСТРА ИИ [ХАБ].
Если вход не удаётся
Если сервер АСТРА ИИ [ХАБ] недоступен или настроен неверно, вместо рабочего окна приложение показывает экран с причиной и подходящими кнопками. В мастере первого запуска общий сбой называется Не удалось подключить АСТРА ИИ [ХАБ] (кнопки Повторить, Настройки подключения и, если нужно, Выйти из АСТРА ИИ [ХАБ]). Экраны ошибок адреса, Вход в АСТРА ИИ [ХАБ] отклонен и Выбран другой аккаунт в мастере такие же, как на экране входа.
![Экран ошибки входа: сервер АСТРА ИИ [ХАБ] не отвечает](images/next-interface/login-error.png)
| Экран | Что сделать |
|---|---|
| Сервер АСТРА ИИ [ХАБ] не отвечает | Проверьте интернет или VPN и нажмите Повторить проверку. Если адрес сервера менялся, нажмите Настройки подключения |
| АСТРА ИИ [ХАБ] временно недоступен | Подождите: приложение проверит сервер снова само. Выходить из аккаунта не нужно. Если экран не уходит долго, а вход в браузере прошёл, возможно, ваш аккаунт не добавлен в организацию на сервере АСТРА ИИ [ХАБ] или доступ к ней отключён. Скопируйте сведения для поддержки и обратитесь к администратору АСТРА ИИ [ХАБ] |
| Ошибка в настройках подключения | Скорее всего, удалён или перемещён файл сертификата. Нажмите Настройки подключения и выберите его заново или нажмите Вернуть стандартный сервер |
| Вход выполнен на другом сервере | Адрес сервера сменился после входа. Верните прежний адрес кнопкой Настройки подключения или нажмите Выйти из АСТРА ИИ [ХАБ] и войдите заново |
| Не удалось войти в АСТРА ИИ [ХАБ] | Прочитайте причину под заголовком и нажмите Повторить вход |
| Приложение вернулось к экрану входа без сообщения | Вход не завершён за 5 минут или сорвался в браузере. Начните вход заново; если в браузере открылась страница с ошибкой, см. подраздел «Страница после входа» |
| Не удалось проверить АСТРА ИИ [ХАБ] | Нажмите Повторить проверку |
| Вход в АСТРА ИИ [ХАБ] отклонен | Чаще всего так бывает после входа под другим аккаунтом в консольной версии ядра. Нажмите Войти снова: приложение очистит прежний вход и откроет браузер |
| Выбран другой аккаунт | В браузере выбран аккаунт, отличный от сохранённого. Нажмите Выйти и войти другим аккаунтом, затем Выйти и войти — после выхода браузер откроется сам |
| Хранилище учетных данных недоступно | Приложение не прочитало сохранённый вход из системного хранилища паролей. Нажмите Повторить проверку; если не помогло — Выйти из АСТРА ИИ [ХАБ] и войдите заново |
| Не удалось завершить настройку | Вход выполнен, но модели пока недоступны. Нажмите Повторить настройку |
| Не удалось завершить выход | Нажмите Повторить выход |
| Экран об остановке ядра | Проверьте, не заблокировал ли антивирус файл ядра, и нажмите Повторить проверку. Кнопка Настройки ядра открывает поле пути к ядру — меняйте его только по указанию поддержки |
| Экран о несовместимом ядре | Версия ядра не поддерживает вход через АСТРА ИИ [ХАБ]. Обратитесь к администратору; путь к ядру меняйте кнопкой Настройки ядра только по указанию поддержки |
| Браузер пишет «Не удается получить доступ к сайту» или «Соединение разорвано» на странице входа | Браузер идёт через прокси или VPN-клиент без доступа к АСТРА ИИ [ХАБ]. Добавьте адрес сервера входа, например .astra-team.ru, в исключения прокси в настройках системы или VPN-клиента и перезапустите браузер. В приложении нажмите Отменить вход и начните вход заново |
Когда сервер АСТРА ИИ [ХАБ] недоступен, экран проверяет его снова сам — под текстом показано «Повторим проверку автоматически через …», интервал растёт от 30 секунд до 5 минут. Когда сервер ответит, экран закроется сам.
Если адрес сервера задан переменными окружения, на экранах ошибок адреса вместо Настройки подключения есть кнопка Повторить проверку и пояснение «Адрес сервера задан в настройках компьютера. Обратитесь к администратору, затем нажмите «Повторить проверку».».
На экранах ошибок есть ссылка Скопировать сведения для поддержки. Полный отчёт сохраняет окно Справка → О программе АСТРА ИИ [КОД]: оно открывается и на экране входа, в нём есть кнопки Сохранить отчет для поддержки…, Скопировать сводку и Открыть папку журналов. Она копирует версии приложения и ядра, ОС, код и текст ошибки, адреса серверов и имена файлов сертификатов — без токенов, адреса электронной почты и имени пользователя. Вставьте их в обращение в поддержку (см. раздел «Диагностика и поддержка»). Узнать версию приложения на экране входа можно пунктом меню Справка → О программе АСТРА ИИ [КОД] (в macOS — в меню АСТРА ИИ [КОД]).
Связь с АСТРА ИИ [ХАБ] во время работы
После входа приложение следит за связью с АСТРА ИИ [ХАБ] в фоне.
- Если ответы модели перестали приходить, над полем ввода появляется плашка Нет связи с АСТРА ИИ [ХАБ] со сроком следующей проверки. Кнопка Проверить сейчас проверяет связь сразу, Подробнее показывает причину: обрыв соединения, ошибку сервера, ограничение числа запросов или истекшее время ответа. Если для сервера выбран свой сертификат, после первой проверки связь проверяется со следующим запросом, и кнопка Проверить сейчас пропадает.
- Справа в полосе вкладок появляется метка «Нет связи с АСТРА ИИ [ХАБ]» или «АСТРА ИИ [ХАБ] отвечает с задержкой». Когда связи нет, точка на кнопке модели у поля ввода становится красной.
- Когда ядро повторяет запрос к модели, под надписью Думаю… показано, например, «АСТРА ИИ [ХАБ] отвечает с задержкой, повторяем запрос: 2 из 5».
- Когда связь восстановится, плашка ненадолго сменится надписью Соединение с АСТРА ИИ [ХАБ] восстановлено и исчезнет. Пока на ней указатель, она не исчезает; крестик закрывает её сразу.
![Плашка «Нет связи с АСТРА ИИ [ХАБ]» над полем ввода](images/next-interface/connection-lost.png)
Если запрос не выполнился из-за обрыва связи, повторите его кнопкой Повторить запрос под сообщением об ошибке в ленте. Если меню моделей не загрузилось, оно сохраняет прежний список и предлагает кнопку Обновить модели — см. раздел «Модели, контекст и память».
Повторный вход
Если срок действия входа истёк, приложение показывает экран Сессия АСТРА ИИ [ХАБ] истекла. Нажмите Войти снова и завершите вход в браузере тем же способом, что и в первый раз (см. подраздел «Способ входа и аккаунт»). Доступ к моделям восстановится; проекты и история хранятся на компьютере и не меняются.
Аккаунт и выход
Щёлкните по адресу электронной почты внизу боковой панели и выберите пункт АСТРА ИИ [ХАБ] — откроется раздел Настройки → Аккаунт. В блоке Аккаунт АСТРА ИИ [ХАБ] показаны адрес электронной почты, состояние подключения и адрес сервера. Кнопка Пройти заново в блоке Первичная настройка снова открывает мастер первого запуска.
![Аккаунт АСТРА ИИ [ХАБ]](images/next-interface/account.png)
Перед выходом завершите текущую задачу. Выйти можно:
- кнопкой Выйти в разделе Настройки → Аккаунт;
- пунктом главного меню Файл → Выйти из АСТРА ИИ [ХАБ] (в macOS — Астра ИИ [Код] → Выйти из АСТРА ИИ [ХАБ]);
- кнопкой Выйти из АСТРА ИИ [ХАБ] на экранах ошибок входа — например, чтобы войти другим аккаунтом.
Подтвердите выход в окне Выйти из АСТРА ИИ [ХАБ]?. Если агент выполняет запрос, окно предупреждает об этом, а кнопка подтверждения называется Остановить запрос и выйти. Пункт меню Выйти из АСТРА ИИ [ХАБ] спрашивает подтверждение в системном окне с кнопками Выйти и Отмена. На экране Вход в АСТРА ИИ [ХАБ] отклонен кнопка Выйти из АСТРА ИИ [ХАБ] выходит без подтверждения.
После выхода вместо рабочего окна открывается экран входа: проекты, история и модели недоступны до нового входа. Чтобы войти, нажмите Продолжить через АСТРА ИИ [ХАБ] и завершите вход в браузере. Данные при выходе остаются на компьютере. Вход на другом компьютере историю не переносит — см. раздел «Данные и восстановление».