Ultimate AI Connector for Compatible Endpoints
Ultimate AI Connector for Compatible Endpoints integruje API poskytovatelů AI kompatibilní s OpenAI do vaší síti WordPress multisite. Konfigurujte více AI poskytovatelů — každý se svým vlastním URL koncovým bodem (endpoint), API klíčem a výchozním modelem — a směrování požadavků s automatickým fallbackem, když je nějaký poskytovatel nedostupný.
Klíčové funkce
- Podpora více poskytovatelů: Přidejte více karet poskytovatelů, každá se svým vlastním URL koncovým bodem, API klíčem a výchozím modelem.
- Přesuzování: Uspořádejte poskytovatele podle priority pomocí uchopovacího prvku (grip handle) na každé kartě; požadavky používají poskytovatele v pořadí.
- Automatické směrování fallbacku: Pokud není primární poskytovatel dostupný, požadavky automaticky přepnou na další nakonfigurovaného poskytovatele.
- Konfigurace pro poskytovatele: Každý poskytovatel je nezávisle nakonfigurován se svými vlastními přihlašovacími údaji a výběrem modelu.
- UI založené na kartách: Postaveno na stabilních komponentách Card WordPress 6.9+ (CardBody, CardHeader, CardDivider).
- Automatické rozbalení při přidání: Nové karty poskytovatelů se automaticky rozbalí, takže můžete okamžitě vyplnit detaily.
- Cache busting pro skripty: Skripty poskytovatelů jsou při aktualizaci pluginu vymazány z cache, aby byla zajištěna načtení nejnovější verze.
Požadavky
- WordPress 5.3 nebo vyšší
- PHP 7.4 nebo vyšší
- Plugin Ultimate Multisite (aktivní)
- OpenAI kompatibilní API koncový bod (self-hosted nebo třetí strany)
Instalace
- Nahrajte soubory addon do adresáře
/wp-content/plugins/ - Aktivujte plugin v menu „Plugins“ v WordPressu
- Přejděte na Ultimate Multisite → AI Connector pro nakonfiguraci addon.
Konfigurace
Nastavení více poskytovatelů
Konfigurační obrazovka používá rozložení založené na kartách, kde každá karta představuje jednoho AI poskytovatele. Můžete přidat tak mnoho poskytovatelů, kolik potřebujete.
Přidání poskytovatele
- Přejděte na Ultimate Multisite → AI Connector v administraci sítě.
- Klikněte na Add Provider.
- Vznikne nová karta poskytovatele a automaticky se rozbalí.
- Vyplňte detaily poskytovatele:
- Provider Name — štítek k identifikaci tohoto poskytovatele (např. "OpenAI", "Mistral", "Local Ollama")
- Endpoint URL — základní URL kompatibilního s OpenAI API (např.
https://api.openai.com/v1) - API Key — váš API klíč pro tento poskytovatel
- Default Model — identifikátor modelu, který se pro tento poskytovatele bude používat výchozí.
- Klikněte na Save Settings.
Odstranění poskytovatele
Klikněte na tlačítko Remove na jakékoli kartě poskytovatele, abyste ji smazali. Uložte nastavení, abyste změnu aplikovali.
Přespořádání poskytovatelů
Přetáhněte ikonu uchopovacího prvku (⣿) na levé straně jakékoli karty poskytovatele, abyste ji přespořádali. Pořadí určuje prioritu fallbacku: požadavky jsou odeslány nejprve prvnímu poskytovateli a v případě selhání požadavku se přepnou na následující poskytovatele.
Fallback směrování
Pokud selže požadavek na primárního poskytovatele — kvůli časování, limitu rychlosti nebo výpadku služby — konektor automaticky pokusí znovu s další poskytovatelem v seznamu. To pokračuje po seznamu, dokud poskytovatel nezíská úspěch nebo dokud se nepokusí všechny poskytovatelé.
| Scénář | Chování |
|---|---|
| Primární poskytovatel odpovídá | Žádost je zpracována normálně |
| Primární poskytovatel selže | Žádost je opakována s další poskytovatelem |
| Všechny poskytovatele selžou | Chyba je vrácena volajícímu |
Fallback je pro volající plugin nebo téma průhledný — obdrží úspěšnou odpověď nebo finální chybu, bez ohledu na to, kolik poskytovatelů bylo zkoušeno.
Reference konfigurace poskytovatele
| Pole | Požadováno | Popis |
|---|---|---|
| Provider Name | Ano | Zobrazit štítek pro tento poskytovatel |
| Endpoint URL | Ano | Základní URL kompatibilního s OpenAI API |
| API Key | Ano | Klíč pro ověření totožnosti pro tento poskytovatel |
| Default Model | Ano | Identifikátor modelu používaný, když není v požadavku specifikován model |
Řešení problémů
Nejsou uvedeni žádní poskytovatelé
Pokud je seznam poskytovatelů prázdný po uložení, potvrďte, že:
- Klikli jste na Save Settings po přidání poskytovatelů.
- Váš prohlížeč neblokoval uložení stránky nastavení (zkontrolujte konzoli prohlížeče kvůli JavaScript chybám).
- Plugin je aktivní a nacházíte se na obrazovce administrace sítě.
Požadavky selhávají pro všechny poskytovatele
- Ověřte, že URL koncového bodu každého poskytovatele je zobrazeno z vašeho serveru (nejen z vašeho prohlížeče).
- Zkontrolujte, že každý API klíč je platný a neuzpálil.
- Projděte stav limitu rychlosti a kvóty poskytovatele v jeho dashboardu.
- Zapněte debugování WordPressu (
WP_DEBUG_LOG) k zachycení podrobných chybových zpráv z konektoru.
Poskytovatel není použit pro fallback
Přespořádání pomocí přetáhnutí mění pořadí fallbacku. Potvrďte, že poskytovatel, který očekáváte, že obdrží požadavky fallbacku, je správně umístěn v seznamu a že jeho URL koncového bodu a API klíč jsou správné.
Nová karta poskytovatele se automaticky nerozbalí
Automatické rozbalení vyžaduje, aby ve vašem prohlížeči byla povolena JavaScript. Pokud se karta při kliknutí nerozbalí, zkontrolujte konzoli prohlížeče kvůli chybám. Obsah karty je vždy dostupné kliknutím na hlavičku karty, i když automatické rozbalení neproběhne.
Changelog
Podívejte se na Changelog pro kompletní historii verzí.