Hjelpeindeks
Embedder Hjelpesenter-sider på nytt slik at den innebygde assistenten kan finne dem.
Hvordan det fungerer
Den innebygde assistenten bruker vektorsøk over en oppdelt, embedded kopi av Hjelpesenteret for å svare på spørsmål. Denne jobben bygger den indeksen på nytt (eller oppdaterer den trinnvis):
- Deler sider opp etter overskrift
- Beregner embeddings for biter hvis innhold har endret seg siden forrige kjøring
- Skriver dem til den globale
help_chunks-tabellen - Sletter foreldreløse — biter hvis kildeside ikke lenger er i inndatasettet fjernes når jobben kjører i «full» modus
Jobben har to moduser:
- Trinnvis — drevet av CI/CD etter en publisering av Hjelpesenteret. Inndataene lister opp de endrede sidene og deres innebygde markdown-innhold
- Full reindeksering — går gjennom den lokale
content-katalogen (standard er/help/content). Brukes ved oppstart av en ny distribusjon eller ved gjenoppretting fra indekskorrupsjon
Hjelpeindeksen er global, ikke per arbeidsområde. Jobben er festet til systemarbeidsområdet og nekter å kjøre andre steder.
Når den kjører
Jobben er operatørdrevet — det finnes ingen planlagt utløser. CI/CD kaller den etter hver distribusjon av Hjelpesenteret; du kan også utløse den manuelt.
Parametere
| Parameter | Beskrivelse |
|---|---|
| Content Dir | Sti til en lokal Hugo-innholdskatalog. Brukes av full reindekseringsmodus. Standard er /help/content |
| Pages | En liste over sidestier og innebygd markdown-innhold. Brukes av den trinnvise modusen |
| Deleted Paths | En liste over sidestier som skal fjernes fra indeksen |
| Full | Når dette settes sammen med Pages, aktiveres opprydding av foreldreløse — enhver bit hvis kildesti ikke er i det oppgitte sidesettet slettes. Bruk bare når Pages inneholder det komplette innholdssettet |
Jobben hoppes over med skipped: true, reason: "embedder not configured" når distribusjonen ikke har noen embedding-leverandør konfigurert.
Jobbresultater
| Måltall | Beskrivelse |
|---|---|
files_processed | Antall sider som ble gjennomgått |
chunks_created | Nye bit-rader satt inn |
chunks_updated | Eksisterende bit-rader hvis embedding ble oppdatert |
chunks_deleted | Foreldreløse bit-rader fjernet |
chunks_skipped | Biter hvis innholdshash matchet den eksisterende raden (ingen embed-kall nødvendig) |
languages | Settet av lokaler som ble sett |
Feilsøking
| Problem | Løsning |
|---|---|
embedder not configured-overhopping | Distribusjonen har ingen embedding-leverandør. Enten konfigurer en, eller godta at assistentsøket faller tilbake på nøkkelordsøk |
| Kjøringen mislykkes med tilgangsfeil | Kontroller at API-nøkkelen for den konfigurerte embedderen fortsatt er gyldig |
| Assistenten returnerer fortsatt utdaterte svar | Tving en oppdatering av assistentøkten. Vektorlageret leses ferskt ved hvert spørsmål, men assistenten kan ha hurtigbufret nylige svar |