> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axottle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Подключение LLM-провайдера

> Профили модели Axosun: Anthropic или OpenAI-совместимый endpoint, безопасное хранение API-ключа и проверка соединения.

Axosun работает через **профили модели**. Профиль описывает, к какому LLM-провайдеру подключаться и с какими параметрами. Без хотя бы одного включённого профиля с ключом запуски ассистента не стартуют — панель предупредит об этом.

<Info>
  Для кого: администратор. Требуемые права: доступ к разделу **Axosun** панели; действующий API-ключ выбранного LLM-провайдера.
</Info>

## Поддерживаемые провайдеры

| Тип                 | Описание                                                                |
| ------------------- | ----------------------------------------------------------------------- |
| `anthropic`         | Anthropic Messages API                                                  |
| `openai_compatible` | Любой OpenAI-совместимый chat-endpoint; обязательно указать базовый URL |

## Что хранится в профиле

| Поле                                 | По умолчанию                             |
| ------------------------------------ | ---------------------------------------- |
| Название профиля                     | —                                        |
| Тип провайдера                       | —                                        |
| Базовый URL (для OpenAI-совместимых) | —                                        |
| Название модели                      | —                                        |
| API-ключ                             | хранится в защищённом хранилище секретов |
| Температура                          | 0.2                                      |
| Максимум токенов                     | 2048                                     |
| Таймаут, секунд                      | 60                                       |
| Включён / выключен                   | —                                        |
| Профиль по умолчанию                 | —                                        |

<Note>
  API-ключ вводится один раз и сразу сохраняется в защищённом хранилище секретов панели; в профиле остаётся только ссылка на запись. Ключ **не отображается повторно** ни в интерфейсе, ни в API. Подробнее — [Хранилище секретов](/ru/security/secrets).
</Note>

## Предварительные требования

* Административная сессия панели и действующая лицензия.
* API-ключ провайдера (Anthropic или OpenAI-совместимого сервиса).
* Для OpenAI-совместимого провайдера — базовый URL endpoint'а, например `https://llm.example.com/v1`.

## Подключение

<Steps>
  <Step title="Откройте профили">
    Панель → **Axosun** → вкладка **Профили**.
  </Step>

  <Step title="Создайте профиль">
    Укажите название, тип провайдера, название модели; для OpenAI-совместимого — базовый URL.
  </Step>

  <Step title="Введите API-ключ">
    Вставьте ключ (например, `sk-ant-xxxxxxxx...` — используйте собственный ключ). После сохранения он попадёт в хранилище секретов и больше не будет показан.
  </Step>

  <Step title="Проверьте соединение">
    Нажмите **Проверить соединение**. Панель выполнит короткий реальный запрос к провайдеру и запишет результат и задержку на профиле.
  </Step>

  <Step title="Назначьте профиль по умолчанию">
    Отметьте профиль как основной, если профилей несколько.
  </Step>
</Steps>

## Как выбирается профиль для запуска

Приоритет: явно указанный профиль → профиль по умолчанию из политики → профиль с флагом «по умолчанию» → первый включённый профиль с ключом. Если ни один не подходит, запуск не стартует.

## Проверка

<Steps>
  <Step title="Тест соединения">
    На профиле нажмите **Проверить соединение**.
  </Step>

  <Step title="Пробный запуск">
    Откройте чат Axosun и задайте простой вопрос — ответ должен прийти без ошибок провайдера.
  </Step>
</Steps>

<Check>Тест соединения успешен, на профиле отображается время последней проверки и задержка.</Check>

Если ключ неверный, тест вернёт ошибку провайдера (например, `401 unauthorized`); она сохранится на профиле как результат последней проверки, а в интерфейсе появится красный индикатор статуса.

## Откат

* **Сменить ключ**: отредактируйте профиль и введите новый ключ — старый будет заменён в хранилище секретов.
* **Временно отключить**: переведите профиль в состояние «выключен» — ассистент перестанет его использовать.
* **Удалить**: удаление профиля удаляет и его учётные данные из хранилища секретов.

## Ограничения и риски

* Ключ невозможно посмотреть после сохранения — если вы его потеряли, создайте новый у провайдера и замените в профиле.
* Ошибка провайдера в середине потокового ответа завершает запуск со статусом «ошибка» — чат фиксирует ход, а не зависает.
* Агентный режим требует, чтобы модель профиля поддерживала вызов инструментов; иначе запуски выполняются в классическом режиме.

## Типовые ошибки

<AccordionGroup>
  <Accordion title="Тест соединения падает с 401">
    Ключ неверный или отозван. Создайте новый ключ у провайдера и обновите профиль.
  </Accordion>

  <Accordion title="OpenAI-совместимый профиль не сохраняется">
    Для типа `openai_compatible` базовый URL обязателен. Укажите полный адрес endpoint'а.
  </Accordion>

  <Accordion title="Чат пишет, что нет доступного профиля">
    Нет ни одного включённого профиля с ключом. Создайте профиль или включите существующий.
  </Accordion>
</AccordionGroup>

## Связанные страницы

* [Axosun — обзор](/ru/axosun/overview)
* [Хранилище секретов](/ru/security/secrets)
* [Сессии и запуски](/ru/axosun/sessions-and-runs)

<Note>Проверено для версии Axottle текущей ветки. Дата проверки: 2026-07-11.</Note>