Help index
Reindicizza le pagine del Knowledge Center affinché l’assistente integrato nell’applicazione possa trovarle.
Come funziona
L’assistente integrato utilizza la ricerca vettoriale su una copia suddivisa in segmenti e indicizzata del Knowledge Center per rispondere alle domande. Questo job ricostruisce (o aggiorna in modo incrementale) tale indice:
- Suddivide le pagine per intestazione
- Calcola gli embedding per i segmenti il cui contenuto è cambiato dall’ultima esecuzione
- Li scrive nella tabella globale
help_chunks - Elimina gli orfani — i segmenti la cui pagina sorgente non è più presente nell’insieme di input vengono rimossi quando si esegue in modalità “completa”
Il job dispone di due modalità:
- Incrementale — attivata dalla CI/CD dopo la pubblicazione del Knowledge Center. L’input elenca le pagine modificate con il relativo contenuto markdown incorporato
- Reindicizzazione completa — percorre la directory locale
content(il valore predefinito è/help/content). Utilizzata per il bootstrap di un nuovo deployment o per il ripristino in caso di corruzione dell’indice
L’indice della guida è globale, non per area di lavoro. Il job è associato all’area di lavoro di sistema e non può essere eseguito altrove.
Quando viene eseguito
Il job è gestito dall’operatore — non esiste un trigger pianificato. La CI/CD lo richiama dopo ogni deploy del Knowledge Center; è possibile avviarlo anche manualmente.
Parametri
| Parametro | Descrizione |
|---|---|
| Content Dir | Percorso di una directory Hugo locale dei contenuti. Utilizzato dalla modalità di reindicizzazione completa. Il valore predefinito è /help/content |
| Pages | Un elenco di percorsi di pagina con il relativo contenuto markdown incorporato. Utilizzato dalla modalità incrementale |
| Deleted Paths | Un elenco di percorsi di pagina da rimuovere dall’indice |
| Full | Se impostato insieme a Pages, attiva la pulizia degli orfani — qualsiasi segmento il cui percorso sorgente non è presente nell’insieme di pagine fornito viene eliminato. Da utilizzare solo quando Pages contiene l’insieme completo dei contenuti |
Il job viene saltato con skipped: true, reason: "embedder not configured" quando il deployment non ha un provider di embedding configurato.
Risultati del job
| Metrica | Descrizione |
|---|---|
files_processed | Numero di pagine elaborate |
chunks_created | Nuove righe di segmento inserite |
chunks_updated | Righe di segmento esistenti il cui embedding è stato aggiornato |
chunks_deleted | Righe di segmento orfane rimosse |
chunks_skipped | Segmenti il cui hash del contenuto corrisponde alla riga esistente (nessuna chiamata di embedding necessaria) |
languages | Insieme delle lingue rilevate |
Risoluzione dei problemi
| Problema | Soluzione |
|---|---|
Skip embedder not configured | Il deployment non dispone di un provider di embedding. È possibile configurarne uno oppure accettare che la ricerca dell’assistente utilizzi la ricerca per parole chiave come fallback |
| L’esecuzione fallisce con un errore di autorizzazione | Verificare che la chiave API dell’embedder configurato sia ancora valida |
| L’assistente restituisce ancora risposte obsolete | Ricaricare completamente la sessione dell’assistente. Il vector store viene letto di fresco a ogni query, ma l’assistente potrebbe aver memorizzato nella cache risposte recenti |