Hjælpe-indeks
Re-embedder Videnscenter-sider, så den indbyggede assistent kan finde dem.
Sådan virker det
Den indbyggede assistent bruger vektorsøgning over en chunket og embeddet kopi af Videnscentret til at besvare spørgsmål. Dette job genopbygger (eller opdaterer inkrementelt) det indeks:
- Opdeler sider efter overskrift
- Beregner embeddings for chunks hvis indhold er ændret siden sidste kørsel
- Skriver dem til den globale
help_chunks-tabel - Sletter forældreløse — chunks hvis kildeside ikke længere er i input-sættet fjernes ved kørsel i “full”-tilstand
Jobbet har to tilstande:
- Inkrementel — drevet af CI/CD efter en Videnscenter-udgivelse. Inputtet lister de ændrede sider og deres inline markdown-indhold
- Fuld gen-indeksering — gennemgår den lokale
content-mappe (standard/help/content). Bruges ved opstart af et nyt deployment eller gendannelse fra indeks-korruption
Hjælpe-indekset er globalt, ikke pr. arbejdsområde. Jobbet er fastgjort til system-arbejdsområdet og nægter at køre andre steder.
Hvornår det kører
Jobbet er operatør-drevet — der er ingen planlagt udløser. CI/CD kalder det efter hver Videnscenter-deploy; du kan også udløse det manuelt.
Parametre
| Parameter | Beskrivelse |
|---|---|
| Content Dir | Sti til en lokal Hugo content-mappe. Bruges af fuld-gen-indekserings-tilstand. Standard /help/content |
| Pages | En liste over sti og inline markdown-indhold pr. side. Bruges af inkrementel tilstand |
| Deleted Paths | En liste over sidestier der skal droppes fra indekset |
| Full | Når sat sammen med Pages, aktiveres oprydning af forældreløse — enhver chunk hvis kildesti ikke er i det leverede sidesæt slettes. Brug kun når Pages indeholder hele indholdssættet |
Jobbet springes over med skipped: true, reason: "embedder not configured", når deploymentet ikke har en embedding-udbyder konfigureret.
Jobresultater
| Metrik | Beskrivelse |
|---|---|
files_processed | Antal sider gennemgået |
chunks_created | Nye chunk-rækker indsat |
chunks_updated | Eksisterende chunk-rækker hvis embedding blev opdateret |
chunks_deleted | Forældreløse chunk-rækker fjernet |
chunks_skipped | Chunks hvis indholds-hash matchede den eksisterende række (intet embed-kald nødvendigt) |
languages | Sæt af locales set |
Fejlfinding
| Problem | Løsning |
|---|---|
embedder not configured-spring | Deploymentet har ingen embedding-udbyder. Konfigurer en, eller acceptér at assistent-søgningen falder tilbage til nøgleord |
| Kørslen fejler med en tilladelses-fejl | Bekræft at den konfigurerede embedder API-nøgle stadig er gyldig |
| Assistenten returnerer stadig forældede svar | Hard-genindlæs assistent-sessionen. Vektor-lageret læses friskt ved hver forespørgsel, men assistenten kan have cachet nylige svar |