FixControl/Documentatie

Beheerdersgids

Embeddings & knowledge

Hoe de kennisbank van je organisatie wordt geëmbed, doorzocht en actueel gehouden als FixControl de embedding-provider wisselt — en welke delen FixControl voor je draait.

De kennisbank hoort bij je organisatie. Upload je een document, FAQ of PDF, of voeg je een gescrapete URL toe, dan splitst FixControl die in chunks, embedt elk stuk, en slaat ze op voor retrieval. Op het moment van zoeken krijgen de agents onderbouwde context voor het issue waar ze aan werken.

Kennisbeheer voor gebruikers staat in de kennisgids. Deze pagina is de operationele kijk: wat er onder de motorkap gebeurt, en wat FixControl op de gehoste dienst voor je regelt.

Wie wat doet

OnderdeelWie
Bronnen toevoegen, afbakenen en verwijderenJij, in Knowledge
De embedding-provider en het model kiezenFixControl, voor de hele omgeving
Opnieuw embedden na een wissel van provider of modelFixControl
Zoekdiepte en zoekwegingFixControl, voor het hele platform
De health-pagina voor embeddingsFixControl-medewerkers

Er is hier niets dat een beheerder van je organisatie hoeft om te zetten of te starten. Zien zoekresultaten er voor jou verkeerd uit, vraag Command Center dan "wat zou je lezen als ik X vroeg?" om precies te zien welke passages retrieval aan een agent zou geven (zie de kennisgids), en laat je FixControl-contact weten wat je vond.

Fingerprinting

Elke chunk wordt opgeslagen samen met de provider, het model en de dimensies waaronder hij geëmbed is — zijn fingerprint. Wisselt de embedding-provider of het model, dan kun je een nieuwe query-embedding niet zinvol vergelijken met chunks onder de oude fingerprint: ze leven in verschillende vectorruimtes.

Retrieval handelt dat automatisch af. Chunks onder een oudere fingerprint worden als verouderd gemarkeerd: ze blijven vindbaar via full-text- en fuzzy tekstmatching, en hun vectorscore telt lager mee tot ze opnieuw geëmbed zijn. Een providerwissel maakt vector-search een tijdje minder goed; je kennisbank wordt er niet leeg van.

Opnieuw embedden

Wisselt FixControl de embedding-provider of het model van de omgeving, dan embedt het de betrokken chunks op de achtergrond opnieuw. Jij hoeft niets te doen, en er is geen re-embed-knop in je workspace.

Terwijl dat loopt, blijven zoekopdrachten werken: chunks die nog niet opnieuw geëmbed zijn, worden nog steeds via tekstmatching gevonden. Pauzeert een re-embed halverwege (provider plat, rate limit), dan gaat hij verder met de chunks die nog gemarkeerd staan; een chunk die al klaar was, wordt niet twee keer geëmbed.

FixControl-medewerkers volgen een health-pagina voor embeddings die de actieve provider en het model toont, hoeveel chunks bij de actieve fingerprint horen, hoeveel er verouderd zijn, en de uitkomst van de laatste re-embed. Die pagina hoort niet bij de instellingen van je organisatie.

Hybride retrieval

Op het moment van zoeken combineren de agents die kennis gebruiken drie soorten zoeken tot één rangschikking:

  • vector-search — semantische gelijkenis met de vraag;
  • full-text-search — overeenkomsten op woorden en zinsdelen;
  • trigram-matching — fuzzy tekstmatching die tegen typefouten en halve woorden kan.

De scores worden samengevoegd tot één rangschikking, en een optionele herrangschikkingsstap kan de beste kandidaten herordenen voordat de topresultaten naar de agent gaan. Hoeveel kandidaten er bekeken worden en hoeveel resultaten een agent krijgt, zijn platforminstellingen die FixControl voor de hele dienst zet; die stel je niet per organisatie in.

Isolatie en afbakening

Elke kenniszoekopdracht is afgebakend tot je organisatie. Een gebruiker in een andere organisatie kan nooit een chunk van jou ophalen, ook niet via de API.

Binnen je organisatie volgt retrieval de projectgrens: een agent die aan een issue werkt, ziet de bronnen van het project van dat issue plus de bronnen voor de hele organisatie — nooit die van een ander project. Bronnen van een verwijderd project of een verwijderde codebase blijven buiten retrieval.

Veelgestelde vragen

Moet ik opnieuw embedden nadat FixControl van embedding-provider wisselt? Nee. Andere modelruimtes, andere dimensies, andere fingerprints — FixControl draait de re-embed voor je.

Kunnen verschillende organisaties verschillende embedding-modellen gebruiken? Vandaag niet — provider en model liggen per omgeving vast.

Kan ik een bron buiten de agent-context houden? Verwijder hem, of baken hem af tot het project waar hij bij hoort, zodat andere projecten hem nooit zien. Een bron die als reference is opgeslagen (een verwijzing zonder geïndexeerde inhoud) is zichtbaar bij naam, maar de inhoud wordt niet doorzocht.

Iets onduidelijk of fout?Laat het ons weten →

FixControl is een handelsnaam van FixControl B.V.