AI-Kit módok és AI-képességek WordPresshez

Az AI‑Kit minden funkciót két forrás egyikéből futtathat:

  • eszközön — a Chrome beépített AI API-jai (Gemini Nano) a felhasználó böngészőjében
  • háttérrendszerben — saját, AWS-en futó AI‑Kit háttérrendszere (SAR-sablon)

Módbeállítás

A globális beállítás lehetséges értékei:

  • local-only — kizárólag az eszközön, háttérrendszer soha
  • backend-fallback — az eszköz előnyben részesítése, szükség esetén háttérrendszer
  • backend-only — kizárólag háttérrendszer, az eszköz figyelmen kívül hagyásával

Ezeket az értékeket az AiModePreference képviseli.

Támogatott funkciók

Az AI‑Kit minden beépített AI-funkció képességét külön követi:

  • prompt
  • summarizer
  • writer
  • rewriter
  • proofreader
  • language-detector
  • translator

Programozott képességellenőrzések

Ezekkel a segédekkel még a kezelőfelület megjelenítése előtt dönthet:

import { decideCapability, checkOnDeviceAvailability, getMinChromeVersions } from "@smart-cloud/ai-kit-core";

const min = await getMinChromeVersions(); // { prompt: "...", summarizer: "...", ... }

const onDevice = await checkOnDeviceAvailability("writer");
if (onDevice.available) {
// Chrome API is available / downloadable / downloading
}

// For translator you must pass source/target languages to availability()
const translator = await checkOnDeviceAvailability("translator", {
sourceLanguage: "en",
targetLanguage: "de",
});

const decision = await decideCapability("writer");

// Optional overrides:
// - availability options (same shape as Chrome create() options)
// - modeOverride to force local/backend behaviour for this call
const forcedBackend = await decideCapability(
"writer",
undefined,
"backend-only",
);

console.log(decision.source); // "on-device" | "backend" | "none"
console.log(forcedBackend.reason); // detailed string explaining the decision

A decideCapability(feature, availabilityOptions?, modeOverride?) az AI‑Kit belső futásidejű logikáját tükrözi.

Az availabilityOptions értékének egyeznie kell a kért funkció Chrome API create() beállításaival; a Translator például sourceLanguage és targetLanguage értéket igényel. A modeOverride a globális beállítások módosítása nélkül ideiglenesen kikényszerítheti a "local-only", "backend-fallback" vagy "backend-only" módot.

Háttérrendszer-konfiguráció (ha engedélyezett)

Ha engedélyezett a háttérrendszer használata, az AI‑Kitnek szüksége van:

  • backendTransport: "fetch" or "gatey"
    (a gatey jelentése „a Gatey aláírt átvitelének használata”, ha a Gatey jelen van)
  • backendBaseUrl: a háttérrendszer API-jának teljes alap URL-je, jellemzően ezt használja
  • backendApiName: az API neve, ha az átvitel megköveteli

A legtöbb beállításban csak a backendBaseUrl értéket kell megadnia.

Látogatói és adminisztrációs felület

Az AI‑Kit a háttérrendszer-hívásoknál megkülönbözteti a context: "admin" | "frontend" értékeket. Egyes telepítések külön útvonal-előtagokat, például /admin/* és /frontend/*, tehetnek elérhetővé eltérő biztonsági szabályzatokkal.