Help-index
Voegt pagina’s van het Kenniscentrum opnieuw in, zodat de assistent in de applicatie ze kan vinden.
Hoe het werkt
De assistent in de applicatie maakt gebruik van vectorzoeken over een opgesplitste, ingebedde kopie van het Kenniscentrum om vragen te beantwoorden. Deze taak herbouwt (of werkt stapsgewijs bij) die index:
- Pagina’s opsplitsen op basis van koppen
- Embeddings berekenen voor fragmenten waarvan de inhoud is gewijzigd sinds de laatste uitvoering
- Wegschrijven naar de globale tabel
help_chunks - Verweesde fragmenten verwijderen — fragmenten waarvan de bronpagina niet meer in de invoerset voorkomt, worden verwijderd bij uitvoering in de modus “volledig”
De taak heeft twee modi:
- Stapsgewijs — aangestuurd door CI/CD na een publicatie van het Kenniscentrum. De invoer bevat de gewijzigde pagina’s en hun inline markdown-inhoud
- Volledige herindexering — doorloopt de lokale map
content(standaard/help/content). Gebruikt bij het initialiseren van een nieuwe implementatie of het herstel na indexcorruptie
De help-index is globaal, niet per werkruimte. De taak is gekoppeld aan de systeemwerkruimte en weigert elders uit te voeren.
Wanneer de taak wordt uitgevoerd
De taak wordt door de beheerder gestart — er is geen geplande trigger. CI/CD roept de taak aan na elke publicatie van het Kenniscentrum; u kunt de taak ook handmatig starten.
Parameters
| Parameter | Beschrijving |
|---|---|
| Content Dir | Pad naar een lokale Hugo-inhoudsmap. Gebruikt door de modus voor volledige herindexering. Standaard /help/content |
| Pages | Een lijst met paginapaden en inline markdown-inhoud. Gebruikt door de stapsgewijze modus |
| Deleted Paths | Een lijst met paginapaden die uit de index moeten worden verwijderd |
| Full | Wanneer dit samen met Pages is ingesteld, wordt opruiming van verweesde fragmenten ingeschakeld — elk fragment waarvan het bronpad niet in de opgegeven paginaset staat, wordt verwijderd. Gebruik dit alleen wanneer Pages de volledige inhoudsset bevat |
De taak wordt overgeslagen met skipped: true, reason: "embedder not configured" wanneer er geen embedding-provider is geconfigureerd voor de implementatie.
Taakresultaten
| Meetwaarde | Beschrijving |
|---|---|
files_processed | Aantal verwerkte pagina’s |
chunks_created | Nieuwe ingevoegde fragmentrijen |
chunks_updated | Bestaande fragmentrijen waarvan de embedding is vernieuwd |
chunks_deleted | Verwijderde verweesde fragmentrijen |
chunks_skipped | Fragmenten waarvan de inhoudshash overeenkomt met de bestaande rij (geen embed-aanroep nodig) |
languages | Set van aangetroffen talen |
Problemen oplossen
| Probleem | Oplossing |
|---|---|
Overgeslagen wegens embedder not configured | De implementatie heeft geen embedding-provider. Configureer er een, of accepteer dat het zoeken door de assistent terugvalt op zoeken op trefwoorden |
| Taak mislukt met foutmelding over machtigingen | Controleer of de geconfigureerde API-sleutel van de embedding-provider nog geldig is |
| Assistent geeft nog steeds verouderde antwoorden | Vernieuw de assistentsessie volledig. De vectoropslag wordt bij elke zoekopdracht opnieuw gelezen, maar de assistent kan recente antwoorden hebben gecached |