Knowledge

Waar knowledge voor is

Knowledge-bronnen zijn documenten (URLs, handmatige invoer, integration-imports) die de agents van FixControl gebruiken om hun antwoorden te onderbouwen. De intake-agent gebruikt ze om accuraat te classificeren. De support-reply-agent gebruikt ze om antwoorden op te stellen. De patch-developer-agent gebruikt ze om context te begrijpen.

Tenantdata is strikt gescheiden. Een zoekopdracht binnen jouw tenant ziet nooit bronnen van een andere tenant.

Soorten bronnen

Kind	Waar het vandaan komt
Manual	Door een operator geplakt (`md`, `txt`, FAQ-paren).
Scraped	URL-crawls. Volgt redirects met hervalidatie; respecteert robots.txt.
PDF	Geüpload als bron-tekst.
Integration	Imports vanuit gekoppelde systemen (bijv. een interne docs-portal).
Generated	Door FixControl zelf geproduceerd (codebase-samenvattingen, FAQs, system-learning-notities). Niet handmatig gecureerd.

Voorgestelde concepten (door mensen goedgekeurd)

FixControl kan knowledge voorstellen in plaats van dat jij het vanaf nul schrijft — maar een concept wordt nooit gepubliceerd vóór een mens het goedkeurt. Concepten komen binnen als pending suggesties met hun herkomst erbij, waaronder:

Opgeloste Freshdesk-tickets — wanneer een support-ticket is opgelost, zet FixControl het oplossingsantwoord van de agent om in een concept (kwaliteitsgepoort: te korte, alleen-afsluitnotitie en generieke oplossingen worden overgeslagen). Zie Integraties → Freshdesk.
Opgeloste FixControl-issues — dezelfde oogst uit interne oplossingen.

Elke suggestie wordt ontdubbeld tegen bestaande knowledge zodat je niet verzuipt in bijna-duplicaten. Beoordeel ze op het suggesties-scherm en keur goed om een concept te promoveren tot een echte, geïndexeerde bron — of wijs het af. Support-content van klanten wordt nooit automatisch gepubliceerd.

Hoe retrieval werkt

Wanneer een agent context nodig heeft, doorzoekt FixControl jouw knowledge met een mix van semantische en keyword-matching, mengt de resultaten en geeft de top-matches aan de agent. Je tunet de formule niet — je cureert de bronnen.

Operator-oppervlak

De Knowledge-pagina is een gepagineerde DataTable met de standaard primitives:

Server-side paginering — grote tenants blijven snel; selectie overleeft pagewissels.
Saved views (standaard: All, Mine, Stale, Failed).
Kolomzichtbaarheid + CSV-export van de huidige filter-set.
Keymap — j/k/Enter///x/Esc, plus Cmd/Ctrl+A om alle zichtbare rijen te selecteren. Volledige lijst in Toetsenbord & command palette.
Bulk delete — selecteer rijen over meerdere pagina's, één keer bevestigen. Wordt geaudit.
Sticky chrome — toolbar en kolomheader blijven vast tijdens scrollen.
Scrape-modal stickiness — de Scrape URL-modal sluit niet meer per ongeluk bij een click-outside. Je kunt een URL erop droppen, focus verliezen, naar een tab switchen om een URL te kopiëren, en terugkomen zonder half-getypte input kwijt te raken. Esc / expliciete Cancel / Save sluiten 'm zoals voorheen.

Een bron toevoegen

Klik op Add source of Scrape URL in de toolbar.
Kies URL, Manual entry, PDF of Import from integration.
Geef het een titel en optionele tags.
De bron komt binnen met status processing terwijl FixControl 'm klaarzet voor zoeken; indexed zodra retrieval 'm kan gebruiken.

Stale bronnen

Bronnen kunnen worden gemarkeerd als Stale wanneer hun indexering ververst moet worden. Klik op Re-embed in de toolbar om een refresh in te plannen. Zoeken werkt nog steeds op stale bronnen via de keyword-fallback, maar matching is gedegradeerd totdat de refresh klaar is.

Confidence op knowledge-antwoorden

Wanneer FixControl retrieval gebruikt om te antwoorden (bijv. bij het opstellen van een SUPPORT-reply), toont het AI-result-paneel:

Confidence van het antwoord.
Sources — welke knowledge-chunks zijn gebruikt, met relevance-scores.
Uncertainty — waar het model zegt onzeker over te zijn.

Klik op een bron om door te springen naar de onderliggende knowledge-entry.

Feedback loop

Elk AI-antwoord dat knowledge gebruikt heeft thumbs-up / thumbs-down-knoppen in de operator-UI. Het signaal voedt de system-learning-store, die bronnen in de loop van de tijd herrangschikt. Negatieve feedback komt ook bovendrijven onder de Failed-view, zodat een admin kan bijschaven.

Bulk delete

Selecteer rijen (x om te togglen, Shift+x voor een range, Cmd/Ctrl+A voor de zichtbare pagina), dan Delete in de sticky bulk-toolbar. Bulk delete wordt geaudit.

Selectie overleeft de volgende page-klik — een bulk delete kan een willekeurig grote gefilterde set bestrijken zonder dat je tussentijds rijen kwijtraakt.

Tagging en filtering

Tags zijn vrije labels (payment, odoo, topdesk, printer). Op de Knowledge-pagina filter je live op zoektekst, tenant, kind-groep en eventueel op gekoppelde codebase. Goede tags maken het zoeken sneller en helpen je later snel een bron terug te vinden.

Veelgemaakte fouten

Ruwe e-mailthreads als knowledge plakken. Die retrieven luid en verdringen daadwerkelijke antwoorden. Vat eerst samen.
Stale bronnen laten opstapelen. Draai Re-embed om retrieval scherp te houden.
Lage confidence interpreteren als "te weinig bronnen". Soms zijn er bronnen genoeg en is het model om andere redenen onzeker. Lees de rationale, niet alleen de score.

Veelgestelde vragen

Wat is het verschil tussen codebase-bronnen en userdoc-bronnen? Userdoc-bronnen (manual, scraped, PDF) voeg jij handmatig toe en worden geconsumeerd door de support-reply-agent. Codebase-bronnen worden automatisch geproduceerd door Inspect codebase en zijn bedoeld voor de dev-agents in de Workspace. Je beheert ze niet handmatig.

Wat doet status `reference`? Sommige bronnen worden alleen als pointer opgeslagen — de inhoud is niet geïndexeerd, maar agents kunnen er nog steeds bij naam naar verwijzen.

Kan ik een bron scopen tot een project of codebase? Ja — stel de scope in bij het toevoegen. Retrieval respecteert het.