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.

1. 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ó.
2. 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.
3. 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.
4. 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.

Az oldal külön kezeli az Automatic Knowledge Sync, a Metadata configuration layers, valamint a források áttekintésére és kézi közzétételére szolgáló részt. A megfelelő szakaszt megnyitva dolgozhat vele; egy szakasz összecsukása nem jelent mentést. A források felületén megtekintheti a létrehozott Markdown előnézetét és az átviteli állapotot, szerkesztheti a dokumentum metaadatait, továbbá kifejezetten kézi közzétételt vagy visszavonást végezhet. Ez nem egy második automatikus szinkronizálási szabályzat. A kézi visszavonás nem tartja kizárva a dokumentumot, ha az automatikus tartalomszabályzat továbbra is engedélyezi a következő átvitelét; ezért azt a szabályzatot is tekintse á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.

Strukturált mezők és szövegformátumok áttekintése​

A Content policy részen a kiválasztott Public content type határozza meg az alatta látható összes szabályzatmezőt. Először válassza ki azt a típust, amelynek rekordjait be kívánja állítani. A Choose fields to mirror and edit their mappings listában jelölje be a jóváhagyandó mezőt, majd válassza ki a nevét a Selected field details megnyitásához. Itt csak a kiválasztott mező leképezését és Source text format értékét szerkeszti. Ezek a választók a szerkesztendő objektumot jelölik ki; nem keresési szűrők.

A ténylegesen szerzői HTML-t tartalmazó mezőnél a mezőformátum beállításában hagyja jóvá a HTML rich text értéket. Ne válassza pusztán azért, mert egy egyszerű szövegben csúcsos zárójelek szerepelnek. A HTML-, Markdown- és egyszerűszöveg-jelölések kifejezett forrásszabályzatot alkotnak; a rendszer soha nem találja ki őket a tárolt értékekből. A formátumok támogatásához a SmartCloud AI Kit WordPress-bővítmény 1.6.9-es vagy újabb verziója és a WP Suite Deployment Access v1.0.129-es vagy újabb sablonja szükséges; az utóbbit külön kell telepíteni az AWS-fiókba. A backendnek hirdetnie kell a knowledge.structured-content.text-formats:1 képességet.

A lista regisztrált meződefiníciókat mutat, nem látogatói adatokat vagy kitalált értékeket. A beépített bejegyzésmezők, például a szerzői kivonat és a kép helyettesítő szövege nem kínálnak HTML-formátum-felülírást; megtartják az egyszerű szöveges adatszerződésüket.

Mentse az áttekintett tartalomszabályzatot, hajtson végre egy jóváhagyott szinkronizálást új forrásverzióval, majd várja meg az átvitelt és az indexelést. A megjelenítési sablon módosítása önmagában nem ad szövegformátumot leíró metaadatot a meglévő tükrözött rekordokhoz. A meglévő leképezések nem migrálódnak észrevétlenül, a mentett válaszok és statikus exportok nem íródnak át.

A HTML-ként jelölt tartalom alapértelmezésben olvasható egyszerű szövegként jelenik meg. A strukturált kártyák korlátozott formázásához külön engedélyezze a megjelenítési sablonban az Allow safe rich-text formatting kapcsolót, alkalmazza a sablont a profil vázlatára, majd mentse a profilt. Ehhez 4-es megjelenítési szabályzatverzió és 3-as adatátviteli verzió szükséges; a kapcsoló soha nem engedélyez nyers HTML-t, hivatkozásokat vagy képeket a szövegértékeken belül. A jelöletlen és egyszerű szöveges mezők, a natív tudásbázis-kivonatok és a képek helyettesítő szövege egyszerű szöveg marad. Nincs további modell- vagy fordítási lépés a forrásértékek átírására.

A szinkronizált tartalom meghatározásakor különítse el a fő nyilvános tartalmat a kapcsolódó tartalmakat ajánló elemektől. Szakemberprofiloknál az adott személy saját, jóváhagyott bemutatkozását, mezőit és kifejezett kapcsolatait vegye fel, ne az oldalt lezáró, más szolgáltatásokat, klinikákat vagy híreket ajánló körhintát. Egy megjelenített ajánlórész kizárása nem tisztítja meg a külön szerkesztett kivonatot és metaadatokat: ezeket a forrásmezőket is tekintse át. Egy klinikához való kapcsolat nem bizonyít szabad időpontot.

Ü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.

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:

1. A dokumentum kifejezett Forrás-URL értéke az Alapdokumentum metaadatainak szerkesztése alatt.
2. KB-beállítások → Alap URL felülírása, a WordPress közvetlen hivatkozására alkalmazva.
3. 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.