Перейти к основному содержимому

Ultimate AI Connector for Compatible Endpoints

Ultimate AI Connector for Compatible Endpoints интегрирует API провайдеров ИИ, совместимых с OpenAI, с вашей мультисайтовой сетью WordPress. Настройте несколько ИИ-провайдеров — каждый со своим URL конечной точки (endpoint), ключом API и моделью по умолчанию — и маршрутизируйте запросы с автоматическим резервированием (fallback), если один из провайдеров недоступен.

Ключевые возможности

  • Поддержка нескольких провайдеров: Добавьте несколько карточек провайдеров ИИ, каждая со своим URL конечной точки, ключом API и моделью по умолчанию.
  • Изменение порядка перетаскиванием: Расположите провайдеров в порядке приоритета, используя ручку захвата на каждой карточке; запросы будут использовать провайдеров в указанном порядке.
  • Автоматическое резервирование маршрутизации: Если основной провайдер недоступен, запросы автоматически перенаправляются к следующему настроенному провайдеру.
  • Конфигурация для каждого провайдера: Каждый провайдер настраивается независимо, используя свои учетные данные и выбор модели.
  • Интерфейс настроек на основе карточек: Построен на стабильных компонентах Card WordPress 6.9+ (CardBody, CardHeader, CardDivider).
  • Автоматическое расширение при добавлении: Новые карточки провайдеров автоматически расширяются, чтобы вы могли сразу заполнить детали.
  • Обход кэша скриптов: Скрипты провайдеров очищаются от кэша при обновлении плагина, чтобы гарантировать загрузку самой последней версии.

Требования

  • WordPress 5.3 или выше
  • PHP 7.4 или выше
  • Плагин Ultimate Multisite (активен)
  • Конечная точка API, совместимая с OpenAI (самостоятельно размещенная или сторонний сервис)

Установка

  1. Загрузите файлы аддона в каталог /wp-content/plugins/
  2. Активируйте плагин через меню «Плагины» в WordPress
  3. Перейдите в Ultimate Multisite → AI Connector, чтобы настроить аддон

Настройка

Настройка нескольких провайдеров

Экран настройки использует макет на основе карточек, где каждая карточка представляет одного ИИ-провайдера. Вы можете добавить столько провайдеров, сколько вам потребуется.

Добавление провайдера

  1. Перейдите в Ultimate Multisite → AI Connector в административной панели сети.
  2. Нажмите Add Provider (Добавить провайдера).
  3. Появится и автоматически расширится новая карточка провайдера.
  4. Заполните детали провайдера:
    • Provider Name (Название провайдера) — метка для идентификации этого провайдера (например, "OpenAI", "Mistral", "Local Ollama").
    • Endpoint URL (URL конечной точки) — базовый URL API, совместимого с OpenAI (например, https://api.openai.com/v1).
    • API Key (Ключ API) — ваш ключ API для этого провайдера.
    • Default Model (Модель по умолчанию) — идентификатор модели, который будет использоваться по умолчанию для этого провайдера (например, gpt-4o, mistral-small).
  5. Нажмите Save Settings (Сохранить настройки).

Удаление провайдера

Нажмите кнопку Remove (Удалить) на любой карточке провайдера, чтобы удалить ее. Сохраните настройки, чтобы применить изменения.

Изменение порядка провайдеров

Перетащите значок захвата (⣿) в левой части любой карточки провайдера, чтобы изменить ее порядок. Порядок определяет приоритет резервирования: запросы отправляются первому провайдеру и перенаправляются к последующим провайдерам, если запрос не удался.

Резервирование маршрутизации (Fallback Routing)

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

СценарийПоведение
Основной провайдер отвечаетЗапрос обрабатывается в обычном режиме
Основной провайдер не отвечаетЗапрос повторяется с использованием следующего провайдера
Все провайдеры не отвечаютОбработка ошибки возвращается вызывающей стороне

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

Справочник конфигурации провайдера

ПолеОбязательноОписание
Provider NameДаОтображаемая метка для этого провайдера
Endpoint URLДаБазовый URL API, совместимого с OpenAI
API KeyДаКлюч аутентификации для этого провайдера
Default ModelДаИдентификатор модели, используемый, если в запросе не указана модель

Устранение неполадок

Провайдеры не отображаются

Если список провайдеров пуст после сохранения, убедитесь, что:

  • Вы нажали Save Settings (Сохранить настройки) после добавления провайдеров.
  • Ваш браузер не заблокировал сохранение страницы настроек (проверьте консоль браузера на наличие ошибок JavaScript).
  • Плагин активен и вы находитесь на экране административной панели сети.

Запросы не проходят для всех провайдеров

  • Убедитесь, что URL конечной точки каждого провайдера доступен с вашего сервера (а не только из вашего браузера).
  • Проверьте, что каждый ключ API действителен и не истек.
  • Просмотрите статус лимитов и квот провайдера в его панели управления (dashboard).
  • Включите отладку WordPress (WP_DEBUG_LOG), чтобы захватить подробные сообщения об ошибках от коннектора.

Провайдер не используется для резервирования

Изменение порядка перетаскиванием меняет порядок резервирования. Убедитесь, что провайдер, который, по вашему мнению, должен получать запросы резервирования, расположен правильно в списке, и что его URL конечной точки и ключ API верны.

Новая карточка провайдера не расширяется автоматически

Автоматическое расширение требует включения JavaScript в вашем браузере. Если карточка не расширяется при нажатии, проверьте консоль браузера на наличие ошибок. Содержимое карточки всегда доступно нажатием на заголовок карточки, даже если автоматическое расширение не срабатывает.

Журнал изменений

См. Changelog для полной истории версий.