Ultimate AI Connector за съвместими endpoints
Ultimate AI Connector за съвместими endpoints интегрира API на доставчици на AI, съвместими с OpenAI, със вашата WordPress multisite мрежа. Настройте множество AI доставчици — всеки със собствена URL за endpoint, API ключ и по подразбиране модел — и маршрутизирайте заявките с автоматично fallback, когато някой от доставчиците не е достъпен.
Основни функции
- Поддръжка на множество доставчици: Добавете множество карти за доставчици на AI, всяка с собствен endpoint URL, API ключ и по подразбиране модел.
- Пренареждане чрез плъзгане: Подреждайте доставчиците по приоритет, използвайки иконата за хващане (grip handle) на всяка карта; заявките използват доставчиците в този ред.
- Автоматично маршрутизиране при отказ (Automatic fallback routing): Ако основният доставчик не е достъпен, заявките автоматично се пренасочват към следващия конфигуриран доставчик.
- Конфигурация на ниво доставчик: Всеки доставчик се конфигурира независимо със собствени данни за удостоверяване и избор на модел.
- Интерфейс за настройки, базиран на карти: Изграден върху стабилните компоненти Card (CardBody, CardHeader, CardDivider) на WordPress 6.9+.
- Автоматично разширяване при добавяне: Новите карти за доставчици се разширяват автоматично, така че можете незабавно да попълните данните.
- Предотвратяване на кеширане на скриптове: Скриптовете на доставчиците се "cache-bust" при актуализация на плагина, за да се гарантира, че се зарежда най-новата версия.
Изисквания
- WordPress 5.3 или по-висок
- PHP 7.4 или по-висок
- Плагин Ultimate Multisite (активен)
- OpenAI-съвместим API endpoint (самохостван или от трета страна)
Инсталация
- Качете файловете на аддона в директорията
/wp-content/plugins/ - Активирайте плагина през менюто 'Plugins' в WordPress
- Навигирайте до Ultimate Multisite → AI Connector, за да конфигурирате аддона
Конфигурация
Настройка на множество доставчици
Екранът за конфигурация използва разположение, базирано на карти, където всяка карта представлява един AI доставчик. Можете да добавите колкото и доставчици са ви необходими.
Добавяне на доставчик
- Отидете на Ultimate Multisite → AI Connector в административната част на мрежата (network admin).
- Кликнете върху Add Provider.
- Появява се и автоматично се разширява нова карта за доставчик.
- Попълнете данните на доставчика:
- Provider Name — етикет за идентифициране на този доставчик (напр. "OpenAI", "Mistral", "Local Ollama")
- Endpoint URL — базовият URL на OpenAI-съвместимия API (напр.
https://api.openai.com/v1) - API Key — вашият API ключ за този доставчик
- Default Model — идентификатор на модела, който се използва по подразбиране за този доставчик (напр.
gpt-4o,mistral-small)
- Кликнете върху Save Settings.
Премахване на доставчик
Кликнете върху бутона Remove на всяка карта за доставчик, за да я изтриете. Запазете настройките, за да приложите промяната.
Пренареждане на доставчиците
Плъзгайте иконата за хващане (⣿) от лявата страна на всяка карта за доставчик, за да я пренаредите. Поредбата определя приоритета на fallback: заявките се изпращат към първия доставчик и се пренасочват към следващите доставчици, ако заявката се провали.
Fallback маршрутизиране
Когато заявка към основния доставчик се провали — поради изтичане на време (timeout), лимит на заявки (rate limit) или прекъсване на услугата — connector автоматично се опитва отново с следващия доставчик в списъка. Това продължава надолу по списъка, докато доставчикът успее или всички доставчици са опитани.
| Сценарий | Поведение |
|---|---|
| Основният доставчик отговаря | Заявката се обработва нормално |
| Основният доставчик се проваля | Заявката се опитва отново с следващия доставчик |
| Всички доставчици се провалят | Грешката се връща към извикателя |
Fallback е прозрачен за плагина или тема, които извикват заявката — те получават или успешна заявка, или окончателна грешка, независимо колко доставчици са били опитани.
Референтен списък за конфигурация на доставчици
| Поле | Изисква се | Описание |
|---|---|---|
| Provider Name | Да | Етикет за показване на този доставчик |
| Endpoint URL | Да | Базов URL на OpenAI-съвместимия API |
| API Key | Да | Ключ за удостоверяване за този доставчик |
| Default Model | Да | Идентификатор на модела, използван, когато в заявката не е указан модел |
Отстраняване на неизправности
Не са изброени доставчици
Ако списъкът с доставчици е празен след запазване, потвърдете, че:
- Кликнали сте върху Save Settings след добавянето на доставчици.
- Браузърът ви не е блокирал запазването на страницата с настройки (проверете конзолата на браузъра за грешки в JavaScript).
- Плагинът е активен и сте на екр ана на административната част на мрежата.
Заявките се провалят за всички доставчици
- Проверете дали endpoint URL на всеки доставчик е достъпен от вашия сървър (не само от браузъра ви).
- Проверете дали всеки API ключ е валиден и не е изтекъл.
- Прегледайте статуса на лимита и квотата на доставчика в неговия dashboard.
- Включете WordPress debug logging (
WP_DEBUG_LOG), за да уловите подробни съобщения за грешки от connector.
Доставчикът не се използва за fallback
Пренареждането чрез плъзгане променя реда на fallback. Потвърдете дали доставчикът, който очаквате да получи заявки за fallback, е позициониран правилно в списъка и дали неговият endpoint URL и API ключ са коректни.
Новата карта за доставчик не се разширява автоматично
Автоматичното разширяване изисква JavaScript да е активиран в браузъра ви. Ако картата не се разширява при клик, проверете конзолата на браузъра за грешки. Съдържанието на картата винаги е достъпно, дори ако автоматичното разширяване не се активира.
Changelog
Вижте Changelog за пълната история на версиите.