Ultimate AI Connector for Compatible Endpoints
Ultimate AI Connector for Compatible Endpoints huunganisha API za viwanda vya AI vinavyolingana na OpenAI na mtandao wako wa WordPress multisite. Weka mipangilio ya viwanda vingi vya AI — kila mmoja na URL yake ya endpoint, API key, na mfumo wa msingi (default model) — na uelekeze maombi kwa kurudi nyuma kiotomatiki (automatic fallback) ikiwa mtoa huduma yeyote atashindwa kufanya kazi.
Vipengele Muhimu
- Usaidizi wa viwanda vingi (Multi-provider support): Ongeza kadi za viwanda vingi vya AI, kila kadi ikiwa na URL yake ya endpoint, API key, na mfumo wa msingi.
- Kubadilisha mpangilio kwa kuvuta (Drag-to-reorder): Panga viwanda kwa kipaumbele kwa kutumia kifungo cha kushika (grip handle) kwenye kila kadi; maombi hutumia viwanda kwa mpangilio.
- Uelekezaji wa kurudi nyuma kiotomatiki (Automatic fallback routing): Ikiwa mtoa huduma mkuu atashindwa kufanya kazi, maombi yanarudi nyuma kiotomatiki kwa mtoa huduma anayefuatayo uliowekwa.
- Mipangilio kwa kila mtoa huduma (Per-provider configuration): Kila mtoa huduma huwekwa mipangilio yake kivyake na siri zake (credentials) na uchaguzi wa mfumo.
- UI ya mipangilio inayotokana na kadi (Card-based settings UI): Imejengwa kwa kutumia vipengele vya Card vya WordPress 6.9+ vinavyoaminika (CardBody, CardHeader, CardDivider).
- Kukua kiotomatiki wakati wa kuongeza (Auto-expand on add): Kadi mpya za viwanda huenea kiotomatiki ili uweze kujaza maelezo mara moja.
- Kuzuia cache ya script (Script cache busting): Script za viwanda huzuiliwa cache wakati wa kusasisha plugin ili kuhakikisha kwamba toleo la hivi karibuni linapakuliwa.
Mahitaji
- WordPress 5.3 au zaidi
- PHP 7.4 au zaidi
- Plugin ya Ultimate Multisite (inapaswa iwe hai)
- Endpoint ya API inayolingana na OpenAI (inayohifadhiwa mwenyewe au ya upande wa tatu)
Usakinishaji
- Pakia faili za addon kwenye saraka yako ya
/wp-content/plugins/ - Washa plugin kupitia menyu ya 'Plugins' ndani ya WordPress
- Nenda kwenye Ultimate Multisite → AI Connector ili kuweka mipangilio ya addon
Mipangilio
Kuweka Mpangilio wa Viwanda Vingi
Skrini ya mipangilio inatumia muundo wa kadi ambapo kila kadi inawakilisha mtoa huduma mmoja wa AI. Unaweza kuongeza viwanda vingi kadri unavyohitaji.
Kuongeza Mtoa Huduma
- Nenda kwenye Ultimate Multisite → AI Connector katika kiadmin cha mtandao (network admin)
- Bonyeza Add Provider
- Kadi mpya ya mtoa huduma inaonekana na kuenea kiotomatiki
- Jaza maelezo ya mtoa huduma:
- Provider Name — jina la lebo la kutambua mtoa huduma huyu (mfano: "OpenAI", "Mistral", "Local Ollama")
- Endpoint URL — URL ya msingi ya API inayolingana na OpenAI (mfano:
https://api.openai.com/v1) - API Key — API key yako kwa mtoa huduma huyu
- Default Model — kitambulisho cha mfumo cha kutumika kwa msingi kwa mtoa huduma huyu (mfano:
gpt-4o,mistral-small)
- Bonyeza Save Settings
Kuondoa Mtoa Huduma
Bonyeza kitufe cha Remove kwenye kadi yoyote ya mtoa huduma ili kuifuta. Weka mipangilio ili kutumia mabadiliko.
Kupanga Upya Viwanda
Vuta ikoni ya kushika (⣿) upande wa kushoto wa kadi yoyote ya mtoa huduma ili kupanga upya. Mpangilio unadhibiti kipaumbele cha kurudi nyuma: maombi hutumwa kwa mtoa huduma wa kwanza na kurudi nyuma kwa viwanda vinavyofuata ikiwa maombi yanafeli.
Uelekezaji wa Kurudi Nyuma (Fallback Routing)
Wakati maombi kwa mtoa huduma mkuu yanashindikana — kwa sababu ya muda uliopita (timeout), kiwango cha maombi (rate limit), au kukatika kwa huduma — connector hujaribu kiotomatiki na mtoa huduma anayefuatayo or kwenye orodha. Hii inaendelea chini ya orodha hadi mtoa huduma atafanikiwa au viwanda vyote vimejaribiwa.
| Scenario | Behaviour |
|---|---|
| Primary provider responds | Maombi yanatolewa kwa kawaida |
| Primary provider fails | Maombi yanajaribiwa tena kwa mtoa huduma anayefuatayo |
| All providers fail | Hitilafu inarudishwa kwa anayemwomba |
Kurudi nyuma ni wazi kwa plugin au theme inayoomba — wanapokea au jibu la mafanikio au hitilafu ya mwisho, bila kujali ni viwanda vingapi vilijaribiwa.
Rejeleo la Mipangilio ya Mtoa Huduma
| Field | Required | Description |
|---|---|---|
| Provider Name | Yes | Lebo ya kuonyesha kwa mtoa huduma huyu |
| Endpoint URL | Yes | URL ya msingi ya API inayolingana na OpenAI |
| API Key | Yes | Key ya uthibitisho kwa mtoa huduma huyu |
| Default Model | Yes | Kitambulisho cha mfumo kinachotumika wakati hakuna mfumo uliowekwa katika maombi |
Kutatua Matatizo
Hakuna viwanda vilivyorodheshwa
Ikiwa orodha ya viwanda ni tupu baada ya kuweka mipangilio, thibitisha kwamba:
- Umebonyeza Save Settings baada ya kuongeza viwanda
- Kivinjari chako hakikuzuizi kurahisisha ukurasa wa mipangilio (angalia console ya kivinjari kwa makosa ya JavaScript)
- Plugin imewashwa na uko kwenye skrini ya kiadmin cha mtandao
Maombi yanashindikana kwa viwanda vyote
- Thibitisha kwamba URL ya endpoint ya kila mtoa huduma inapatikana kutoka kwenye seva yako (sio tu kutoka kwenye kivinjari chako)
- Angalia kwamba kila API key ni halali na haijapita muda wake
- Pitia hali ya kiwango cha maombi (rate-limit) na quota ya mtoa huduma katika dashboard yao
- Washa utoaji wa logi ya debug ya WordPress (
WP_DEBUG_LOG) ili kukamata ujumbe wa makosa wa kina kutoka kwa connector
Mtoa huduma hatatumika kwa kurudi nyuma
Kupanga upya kwa kuvuta (Drag-to-reorder) hubadilisha mpangilio wa kurudi nyuma. Thibitisha kwamba mtoa huduma unayotarajia kupokea maombi ya kurudi nyuma amepangwa vizuri katika orodha na kwamba URL ya endpoint na API key yake ni sahihi.
Kadi mpya ya mtoa huduma haikuenea kiotomatiki
Auto-expand inahitaji JavaScript iwe imewashwa kwenye kivinjari chako. Ikiwa kadi haikuenea kwa kubonyeza, angalia console ya kivinjari kwa makosa. Maudhui ya kadi huwa yanapatikana kwa kubonyeza kichwa cha kadi hata kama auto-expand haitafanya kazi.
Changelog
Tazama Changelog kwa historia kamili ya toleo.