Ultimate AI Connector for Compatible Endpoints
Ultimate AI Connector for Compatible Endpoints integruе API правайдараў AI, сумяшчальныя з OpenAI, з вашай сеткай WordPress multisite. Вы можаце накіраваць некалькі AI-правайдараў — кожны з якіх мае ўласны URL-адрэс endpoint, API key і пачатковая мадэль — і аўтаматычна перанакіраваць запыты з рэзервальнай копіяй (fallback), калі провайдар недаступны.
Key Features
- Multi-provider support: Дадайце некалькі картак правайдараў AI, кожная з якіх мае свой уласны URL-адрэс endpoint, API key і пачатковая мадэль
- Drag-to-reorder: Вызначайце прыярытэт правайдараў, перацягваючы іх па карце; запыты выкарыстоўваюць правайдараў па паказванні
- Automatic fallback routing: Калі першапачатковы провайдар недаступны, запыты аўтаматычна перанакіраваўваюцца на наступнага настроіранага провайдэра
- Per-provider configuration: Кожны провайдар наладжаецца незалежна з яго ўласнымі ўлічэннямі і выбарам мадэлі
- Card-based settings UI: Спрамую на базе стабільных кампанентаў Card WordPress 6.9+ (CardBody, CardHeader, CardDivider)
- Auto-expand on add: Новыя карты правайдараў аўтаматычна разкрываюцца, каб вы маглі неадкладна зарэгістраваць дэталі
- Script cache busting: Скрыпты правайдараў "выбіваюцца з кэша" (cache-busted) пры абноўленні плагіна, каб гарантаваць загрузку найлепшый версіі
Requirements
- WordPress 5.3 або больш высокі
- PHP 7.4 або больш высокі
- Плагін Ultimate Multisite (актыўны)
- API endpoint, сумяшчальны з OpenAI (саўстоўны або ад трэцяй бакі)
Installation
- Загрузіце файлы аддону ў каталог
/wp-content/plugins/ - Актывуйце плагін праз меню 'Plugins' у WordPress
- Адыйце ў Ultimate Multisite → AI Connector, каб наладзіць аддон
Configuration
Multi-Provider Setup
Экран канфігурацыі выкарыстоўвае макет на аснове картак, дзе кожная карта прадстаўляе аднаго AI-провайдэра. Вы можаце дадаць колькі га ўам патрэбна.
Adding a Provider
- Адыйце ў Ultimate Multisite → AI Connector у адмініструванні сеткі
- Націсніце Add Provider
- Паявіцца і аўтаматычна разкрэецца новая карта провайдэра
- Зарэгістраруйце дэталі провайдэра:
- Provider Name — ярлык для ідэнтыфікацыі гэтага провайдэра (напрыклад, "OpenAI", "Mistral", "Local Ollama")
- Endpoint URL — базавы URL API, сумяшчальнага з OpenAI (напрыклад,
https://api.openai.com/v1) - API Key — ваш API key для гэтага провайдэра
- Default Model — ідэнтыфікатар мадэлі, які выкарыстоўваецца па спілкуванні для гэтага провайдэра (напрыклад,
gpt-4o,mistral-small)
- Націсніце Save Settings
Removing a Provider
Націсніце кнопку Remove на любой карце провайдэра, каб выдаліць яго. Захавайце налады, каб заапраўдаваць змены.
Reordering Providers
Перазначайце парядок, перацягваючы значок захвату (⣿) у левым боку любой карты провайдэра. Парядок вызначае прыярытэт fallback: запыты адпраўляюцца першапачатковаму провайдэру і перанакіраваўваюцца на наступных провайдэраў, калі запыт не ўдакладняецца.
Fallback Routing
Калі запыт да першапачатковага провайдэра не ўдакладняецца — з-за таўтавай, абмежавання патраты (rate limit) або перапынку паслуг — каннеКТор аўтаматычна папрабуе наступнага провайдэра ў спісе. Гэта працягваецца па спісе, пакуль провайдэр не ўдакладніцца або пакуль не будуць праспробаваны ўсе провайдэры.
| Scenario | Behaviour |
|---|---|
| Primary provider responds | Запыт паслугоўваецца ў звычайным рэжыме |
| Primary provider fails | Запыт папрабаваны з наступным провайдэрам |
| All providers fail | Памылка вяртаецца выклікальчу |
Fallback празрачны для выклікальнага плагіна або тэмы — яны атрымліваюць або паспяховую адказ, або канчатковую памылку, незалежна ад колькасці правайдараў, якія былі праспробаваны.
Provider Configuration Reference
| Field | Required | Description |
|---|---|---|
| Provider Name | Yes | Ярлык для адбыдання гэтага провайдэра |
| Endpoint URL | Yes | Базавы URL API, сумяшчальнага з OpenAI |
| API Key | Yes | Ключ аўтэнтыкацыі для гэтага провайдэра |
| Default Model | Yes | Ідэнтыфікатар мадэлі, выкарыстоўваецца, калі ў запыце не ўказана мадэль |
Troubleshooting
No providers are listed
Калі спіс провайдэраў пуст пасля захавання, пераканайцеся, што:
- Вы націснулі Save Settings пасля дадання провайдэраў
- Ваш браўзер не заблікаваў захаванне адкалення (праверце кансоль браўзера на наяўнасць памылак JavaScript)
- Плагін актыўны і вы знаходзіцеся на экране адміністрування сеткі
Requests are failing for all providers
- Праверце, што URL-адрэс endpoint кожнага провайдэра даступны з вашага сервера (а не толькі з вашага браўзера)
- Праверце, што кожны API key валідны і не прайшоў кроку даўгаччя
- Пагледзьце статус абмежавання патраты і квоты провайдэра ў яго адкалення
- Уключыце дэбаг-журналуванне WordPress (
WP_DEBUG_LOG), каб зарэгістраваць дэталізаваныя паведамленні пра памылкі ад каннектара
A provider is not being used for fallback
Перазначаванне пачатку fallback вызначае парядок fallback. Пераканайцеся, што провайдэр, які вы чакаеце, што атрымае запыты fallback, правільна пазначаны ў спісе, і што яго endpoint URL і API key правільныя.
New provider card does not expand automatically
Auto-expand патрабуе, каб JavaScript быў уключаны ў вашым браўзеры. Калі карта не разкрываецца па кліку, праверце кансоль браўзера на наяўнасць памылак. Дэталі карты заўсёды даступныя па кліку на заголовок карты, нават калі auto-expand не спраўляецца.
Changelog
Пагледзьце Changelog для поўнага гісторыі версій.