Руководство по настройке

Руководство по настройке провайдера

Инструкции по настройке и устранению неполадок по инструментам.

Настройка LobeChat

LobeChat — это веб-интерфейс для чата от LobeHub. В этой инструкции описана интеграция провайдеров OpenAI или совместимых с OpenAI в LobeChat: сначала получите API Key, Base URL и название модели в панели управления провайдера, а затем укажите их в LobeChat в разделе «Settings - Language Model».

Сначала разберемся, за что отвечает эта страница

В официальной документации раздел настроек находится в меню Settings во вкладке Language Model. Его можно представить как «страницу управления провайдерами моделей»: после включения провайдера OpenAI LobeChat будет знать, куда отправлять запросы, какой ключ использовать и какие модели отображать в окне чата.

Если вы используете сторонний AI-провайдер, вы все равно можете выбрать OpenAI на странице LobeChat. Единственное отличие — поля API Key и API Proxy Address. В них нужно указать данные вашего AI-провайдера, а не официальный адрес OpenAI по умолчанию.

Где находятся настройки Сначала перейдите на страницу настроек языковых моделей, затем разверните блок провайдера OpenAI. Скриншот ниже приведен только для ориентира по интерфейсу и полям.
Language Model settings in the official LobeChat documentation

Как заполнять эти поля?

Скриншот взят из официальной документации LobeChat. Интерфейс на скриншоте на английском языке, поэтому ниже сохранены оригинальные английские названия полей; в интерфейсе на других языках они могут называться «Language Model», «API Key», «API Proxy Address», «Model List».
Параметр конфигурацииКак заполнять
Переключатель OpenAIСначала включите этого провайдера. Если переключатель выключен, даже при указанном ключе соответствующая модель может не появиться на странице чата.
API KeyВведите ключ, созданный в панели управления провайдера. Он также может называться токеном, ключом или секретным ключом. Не используйте пример из скриншота.
API Proxy AddressЭто Base URL / адрес API. Пример по умолчанию с официального сайта — https://api.openai.com/v1; для стороннего AI-провайдера его нужно заменить на адрес API из панели управления (некоторые адреса содержат /v1, некоторые — нет).
Use Client-Side Fetching ModeОбычным пользователям рекомендуется сначала ознакомиться с инструкцией провайдера. Если провайдер требует клиентских запросов, включите эту опцию; если вы используете собственное серверное развертывание и сервер перенаправляет запросы централизованно, обычно включать её не требуется.
Model ListЗдесь определяется, какие модели будут доступны для выбора в чате. Сначала попробуйте получить список моделей автоматически; если запрос завершится ошибкой, добавьте их вручную в соответствии с названиями в панели провайдера.
Connectivity CheckИспользуется для проверки доступности подключения по связке Key и API Proxy Address. Если проверка не проходит, сначала проверьте ключ, Base URL и права доступа к модели.

Порядок настройки

  1. Откройте LobeChat и перейдите в раздел Settings - Language Model. Если интерфейс на английском, перейдите в Settings - Language Model.
  2. Разверните блок OpenAI и включите переключатель справа.
  3. В поле API Key введите ключ, сгенерированный в панели управления провайдера.
  4. В поле API Proxy Address укажите Base URL / адрес API, предоставленный провайдером. Не нужно угадывать, требуется ли добавлять /v1 — следуйте примеру из панели провайдера.
  5. Нажмите Get Model List, чтобы загрузить список моделей; если загрузка завершится ошибкой, вручную добавьте названия моделей от провайдера в поле Model List.
  6. Нажмите Check, чтобы протестировать соединение. После успешной проверки вернитесь в чат и выберите настроенную модель в выпадающем списке.
Выбор модели После настройки вернитесь на страницу чата и убедитесь, что добавленная модель доступна для выбора в выпадающем списке.
Model selection on the LobeChat chat page

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

Пример переменных окружения для совместимости с OpenAI в LobeChat
OPENAI_API_KEY=YOUR_API_KEY OPENAI_PROXY_URL=YOUR_PROVIDER_API_URL
При самостоятельном развертывании названия переменных окружения могут меняться в зависимости от версии. На странице сохранена ссылка на официальную документацию; точные параметры уточняйте в документации к используемой вами версии.