Automatikus tudásszinkronizálás és metaadat-konfiguráció
Az Automatikus tudásszinkronizálás kézi közzététel nélkül tartja elérhetővé a kiválasztott nyilvános WordPress-tartalmat az AI-Kit Tudásbázisában. Elkülönül a Static Publishertől: az egyik a keresés és csevegés tudásforrását frissíti, a másik nyilvános statikus oldalakat telepít.
A webhely csatlakoztatása
Nyissa meg a SmartCloud → AI-Kit beállításai → Tudásbázis → Automatikus tudásszinkronizálás oldalt. A csatlakoztatott Pro-funkció kompatibilis AI-Kit háttérrendszert igényel. Az AI-Kit 1.4.19 és újabb az automatikus dokumentumkiszolgáláshoz 5-ös knowledge.automation képességet igényel, amely az 1.0.85 és újabb kompatibilis háttérrendszer-kiadásokban érhető el. Az alábbi szinkronizálási forrásállapotok az AI-Kit 1.4.20 verziójától elérhetők.
- Először állítsa be az API-beállításokat. Ez a háttérrendszer hiteles forrása: a közvetlen URL közvetlenül használatos, a Gatey REST API-neve pedig a beállított végpontjára oldódik fel. Az API-beállítások háttérrendszere csak olvasható.
- A Kapcsolat és futtató alatt válassza ki a megfelelő környezetet és privátkulcs-tárolást. Elérhető a Titkosított WordPress-beállítás; a Védett fájl a webgyökéren kívül lehetőséghez beállított védett kiszolgálóhely szükséges. Letiltott állapotban a webhely nem vehető fel.
- Mentse a kapcsolati beállításokat, majd válassza a Párosítási kód létrehozása és felvétel lehetőséget. A rövid élettartamú kód webhelyspecifikus aláírókulcsot hoz létre a későbbi kiszolgálóoldali kérésekhez.
- Ellenőrizze a Felvéve állapotot, és szükség esetén használja a Kapcsolat ellenőrzése lehetőséget.
A felvétel önmagában nem kapcsolja be minden tartalomtípus szinkronizálását.
Tartalom és jóváhagyási szabályzat kiválasztása
A Tartalomszabályzat alatt válasszon nyilvános tartalomtípust, engedélyezze A tartalomtípus automatikus szinkronizálása lehetőséget, állítsa be szabályzatát, majd mentse a tartalomszabályzatot. Ismételje meg minden kívánt típusnál. A szabványos bejegyzések és oldalak mellett a nyilvános URL-lel rendelkező alkalmas egyéni bejegyzéstípusok is támogatottak.
- A WordPress-közzététel a jóváhagyás engedélyezi a közzétett tartalommódosítások automatikus kiszolgálását.
- A Kézi KB-felülvizsgálat visszatartja a módosításokat, amíg egy adminisztrátor át nem nézi őket, és az Üzemeltetési állapot alatt ki nem választja a Kiválasztott tartalomtípus jóváhagyása lehetőséget.
- A Metaadatokban szereplő taxonómiák határozza meg, mely taxonómiák járulnak hozzá a dokumentumkifejezésekhez és a WordPressből származó szókészlethez. A taxonómiák kiválasztása a tartalomszabályzat engedélyezése és mentése nélkül nem tesz közzé szókészletet.
- A Dokumentumprofil a háttérrendszeri dokumentum-metaadatokkal tárolt haladó útvonalválasztási címke. Tartsa
defaultértéken, kivéve, ha lekérési szűrői kifejezetten más profilt használnak; önmagában nem módosítja az átalakítást vagy betöltést.
Csak a kiválasztott nyilvános tartalomtípusok alkalmas, közzétett tartalma kerül kiszolgálásra. A vázlatok, változatok, közzé nem tett javaslatok és privát állapotú tartalmak nem automatikus kiszolgálási források. Egy korábban szinkronizált tartalom közzétételének visszavonása eltávolítási kérést hoz létre a nem nyilvános változat feltöltése helyett. A nagy törlési készletek kifejezett jóváhagyást igényelhetnek.
Ne engedélyezze az automatikus szinkronizálást jelszóval védett vagy tagokra korlátozott közzétett tartalmat tartalmazó típusoknál, amíg nem ellenőrzött kifejezett kizárást. A közzétett állapot önmagában nem jelenti, hogy a tartalom biztonságosan elérhetővé tehető egy nyilvános Tudásbázison keresztül; ne feltételezze, hogy egy látogatói hozzáférést szabályozó bővítmény a kiszolgálóoldali szinkronizálási vetületet is szűri.
Ütemezés és kezdeti szinkronizálás
Az AI-Kit ötpercenként esedékes WordPress cron-eseményt regisztrál. A szokásos WP-Cron-forgalom végrehajthatja. Alacsony forgalmú webhelyeken vagy a forgalom által indított WP-Cron kikapcsolásakor ütemezze a wp cron event run --due-now parancsot ötpercenként a WordPress-kiszolgálón. A futtatózár megakadályozza az átfedő meneteket.
Ez PHP-/kiszolgálóoldali munkafolyamat, nem a statikus látogatói felület látogatói által végzett feladat. A WordPress-gazdagépnek kimenő kapcsolatra van szüksége a feloldott háttérrendszerhez. A böngészőalapú chatbot és Doc Search a forrás WordPress-telepítés tartalomszinkronizálása után statikus webhelyen is működhet.
Az Egy szinkronizálási menet futtatása egy korlátozott menetet hajt végre, nem feltétlenül a teljes kezdeti importot. Az alapszint és az átviteli batchméret korlátozza a menetenkénti munkát; a cron folytatja a fennmaradó feladatokat. A függő munkát, alapszintbejegyzéseket, blokkolási okokat, betöltési állapotot és a futtató legutóbbi eredményét az Üzemeltetési állapot alatt ellenőrizze.
Metaadat-konfigurációs rétegek
A Metaadat-konfigurációs rétegek doboz három egymástól független tulajdonú bemenetet egyesít. Nem ugyanazon létrehozott fájl három szerkeszthető másolata.
| Lap | Formátum és cél |
|---|---|
| Kézi szabályzat | Szerkeszthető YAML: stabil szerzői beállítások és egyesítési szabályok, beleértve a termelő bemenetétől függetlenül megőrzendő értékeket. |
| Külső szókészletek | Szerkeszthető YAML-lista: WordPressen kívüli termelők, például dokumentáció által biztosított szókészletek. |
| WordPressből származó | Csak olvasható YAML: engedélyezett tartalomszabályzatokból létrehozott, az aláírt futtató által kiszolgált kifejezések. |
| Tényleges eredmény | Csak olvasható YAML: a lekérés által használt utolsó ismert érvényes konfiguráció. |
| Javasolt eredmény | Csak olvasható YAML-előnézet örökölt migráció során, az előkészített bemenetek aktiválása előtt. |
| Eredet | Csak olvasható YAML auditálási térkép, amely azonosítja az egyes tényleges értékekhez hozzájáruló rétegeket. |
Minden metaadatréteg-szerkesztő és -előnézet YAML-t használ. Ez a formátum nem módosítja az API strukturált JSON kérés- és válaszobjektumait vagy a Tudásbázis betöltéséhez szükséges dokumentumonkénti *.metadata.json kísérőfájlokat; azok JSON formátumúak maradnak.
A létrehozott eredmény az engedélyezett külső és WordPress-szókészleteket egyesíti a kézi szabályzattal. A kézi rétegben megőrzendő értékekhez használja az allowedCategories, allowedTags és namespaceTags mezőt; a namespaceTags értékeinek az allowedTags között is szerepelniük kell. A meglévő mezők, például a categoryPolicies, szerzői szabályzatok maradnak. A vocabularyPolicy csak álnevek, kizárások vagy zárolt megjelenítési értékek miatti normalizáláshoz használatos. A bemeneteket vagy szabályzatot szerkessze, ne a létrehozott eredményt.
Egy külső szókészlet például úgy fejezhet ki kategóriahierarchiát, hogy a gyermekkategóriából nem készít másik legfelső szintű kategóriát:
- id: docusaurus
enabled: true
namespaces:
category:
- slug: guides
label: Guides
- slug: setup
label: Setup
parentSlug: guides
post_tag:
- ai-kit
Tartsa stabilan a termelőazonosítókat. A külső YAML-lista szókészletburkolókat tartalmaz, nem feltöltendő dokumentumokat. A panel frissítése csak az aktuális állapotát olvassa; futtasson szinkronizálási menetet, vagy várja meg, hogy a cron kiszolgálja a módosult WordPress-szókészletet.
Meglévő konfiguráció migrálása
Amikor megjelenik az Örökölt konfiguráció migrálásra kész állapot, a külső és WordPress-bemenetek előkészülnek, miközben az aktuális tényleges konfiguráció változatlan marad. A Kézi réteg létrehozása kiválasztása előtt vizsgálja meg a Javasolt eredményt. A javasolt kézi réteg megőrzi a csak kézi és ismeretlen szabályzatmezőket, a termelő által biztosított szókészletet pedig a termelő irányítása alatt hagyja.
A kézi réteg létrehozása aktiválja az előkészített egyesítést. Nem utasít a meglévő egyéni szabályzat eldobására, és nem távolít el régi dokumentumokat a Tudásbázisból. Tudatosan tekintse át a megőrzött kézi kategória- és címkeértékeket; ne törölje őket pusztán azért, mert másik termelő is használja e kifejezéseket. Migráció után a további érvényes bemenet- vagy szabályzatmentések új létrehozási lépés nélkül frissíthetik a tényleges eredményt.
Forrás-URL-ek és dokumentumfelülírások
Automatikusan létrehozott alapdokumentumnál a forrás-URL elsőbbségi sorrendje:
- A dokumentum kifejezett Forrás-URL értéke az Alapdokumentum metaadatainak szerkesztése alatt.
- KB-beállítások → Alap URL felülírása, a WordPress közvetlen hivatkozására alkalmazva.
- Az eredeti WordPress közvetlen hivatkozás.
Használja a globális felülírást, ha a szerkesztői webhely nyilvános forrása eltér, például amikor fejlesztői hálózati néven szerkeszt, de éles hálózati néven szolgálja ki a tartalmat. A dokumentumonkénti kifejezett URL elsőbbséget élvez.
Az automatikus szinkronizálás az alapdokumentum cím-, leírás-, kategória-, alkategória- és címkefelülírásait is figyelembe veszi. E metaadat-felülírások önmagukban nem zárolják a létrehozott Markdownt. A metaadat-módosítások ugyanazon jóváhagyási szabályzat alatt lépnek be a szinkronizálási munkafolyamatba; a globális Alap URL felülírásának módosítása kiváltja a meglévő dokumentumok egyeztetését.
Az állapot helyes értelmezése
A KB-források közzétételiállapot-szűrője és jelvényei megkülönböztetik az automatikus kiszolgálás állapotait, például szinkronizálásra vár, szinkronizálás alatt, kiszolgálva, hiba, blokkolva és eltávolítva. A hibák lehetőség szerint tartalmazzák konkrét okukat.
A Kiszolgálva azt jelenti, hogy a háttérrendszer megkapta a dokumentum aktuális generációját. Nem jelenti azt, hogy a Tudásbázis indexelése befejeződött. A frissített keresési vagy csevegési eredmények elvárása előtt ellenőrizze a háttérrendszeri betöltést az Üzemeltetési állapot alatt.
A Felülvizsgálat szükséges állapot továbbra is jelentős a kézi jóváhagyású munkánál, külön kézi dokumentumoknál vagy elavult zárolt felülírásoknál. Egy alapdokumentum sikeres automatikus kiszolgálása nem hagyja automatikusan jóvá ezeket a külön elemeket. Fordítva: a kézi közzétételi rekord puszta hiánya önmagában nem helyez felülvizsgálatra egy szinkronizált alapdokumentumot.