Kennisbank

Je kunt hier ook gewoon om vragen. Zeg "onthoud dit" en Command Center slaat een document op dat je hem geeft, of leest één webpagina in en bewaart die. Vraag "wat weet je over ons?" en hij somt de bronnen op (alleen titels en metadata, nooit de inhoud), inclusief welke nog verwerkt worden. Vraag "wat zou je lezen als ik X vraag?" om de passages te zien die de zoekfunctie van de agents zelf zou vinden. Een hele site importeren blijft op deze pagina, waar de paginalimiet en het resultaat zichtbaar zijn.

Waar kennis voor is

Kennis is het naslagmateriaal dat de agents lezen voordat ze antwoorden of een wijziging voorstellen: je documentatie, FAQ's, een gescrapete helpsite, of wat FixControl uit een gekoppelde codebase heeft geleerd. De intake-agent gebruikt het om issues te classificeren, de antwoord-agent om klantantwoorden op te stellen en de developer-agents om context te begrijpen. Zonder kennis werken agents alleen met de tekst van de melding.

FixControl gebruikt de gekoppelde projectbronnen om een antwoord voor te bereiden. Je kennis wordt alleen binnen je eigen organisatie doorzocht; een andere organisatie ziet haar nooit.

Je vindt het onder Kennisbank in het hoofdmenu (/knowledge).

Wie mag wat

De knoppen zijn voor iedereen zichtbaar. Zonder de juiste rol wordt opslaan geweigerd met een melding over je rechten.

Waar kennis vandaan komt

Kennis is wat je uploadt, plakt of scrapet, plus wat FixControl zelf genereert. Er is geen live koppeling met een wiki of documentplatform: wil je inhoud daaruit gebruiken, exporteer die dan als tekst of scrape de openbare pagina's.

De soorten en statussen in de lijst staan in het Engels op het scherm.

Scope: wie een bron mag gebruiken

Elke bron heeft een Scope, zichtbaar in een eigen kolom:

• Organisatiebreed: beschikbaar voor elk project in je organisatie. Gebruik dit voor algemeen materiaal, zoals je product-FAQ.
• Project: alleen beschikbaar voor agents die aan dat project werken.
• Codebase: gegenereerd uit, of gekoppeld aan, een specifieke codebase.

Organisatiebrede bronnen kunnen in antwoorden voor elk project terechtkomen. Zet projectspecifieke documentatie daarom op het project zelf.

Als een agent zoekt, krijgt hij de bronnen van het project van de melding plus je organisatiebrede bronnen, nooit de bronnen van een ander project. Dat is een vaste platformregel; je stelt hem niet in. Het zoeken combineert matching op betekenis met trefwoord- en fuzzy tekstmatching, zodat een bron ook gevonden wordt als de vraag andere woorden gebruikt.

Een bron toevoegen

De dialogen voor toevoegen, scrapen en inspecteren zijn in het Engels; hieronder staan de labels zoals je ze op het scherm ziet.

1. Klik op Kennisbank op Bron toevoegen. Wil je een bron voor één project toevoegen, open dan het project en voeg haar daar toe: de scope staat dan vast op dat project, en je kunt optioneel een codebase kiezen (standaard Project-wide).
2. Kies de Kind.
3. Vul een Title in en eventueel Tags (comma separated). Het veld Tenant is al voor je ingevuld; laat het zoals het is.
4. Sleep een bestand op het uploadvlak of gebruik browse files, of plak de tekst in Content. Bij een WINDEV-soort die alleen een referentie is, vul je in plaats daarvan Reference in.
5. Klik op Index source (of Add reference bij een soort die alleen een referentie is).

De bron verschijnt met status Processing terwijl FixControl haar klaarzet voor zoeken, en Indexed zodra agents haar kunnen vinden. Failed betekent dat ze niet verwerkt kon worden; verwijder haar en voeg haar opnieuw toe, of plak schonere tekst.

Een website scrapen

1. Klik op URL scrapen.
2. Vul de URL in en eventueel Tags (comma separated).
3. Wil je ook gelinkte pagina's importeren, vink dan Crawl linked pages (same path) aan en stel Max pages in (standaard 30, hooguit 100). Alleen links onder hetzelfde pad worden gevolgd.
4. Vanuit een project zie je ook Make available only to {project}: laat dit aangevinkt om de pagina's op het project te houden.
5. Klik op Scrape & index (of Crawl & index als je crawlt).

Als het klaar is zie je Pages crawled, Sources indexed en Errors, met de pagina's die geïndexeerd zijn en de URL's die mislukten. Redirects worden gevolgd en elk redirect-doel wordt opnieuw gecontroleerd voordat het wordt opgehaald; adressen binnen privénetwerken worden geweigerd. Een gescrapete pagina is een momentopname: scrape haar opnieuw als de site verandert.

Een codebase inspecteren

Codebase inspecteren maakt van een gekoppelde codebase doorzoekbare kennis: een Architecture-samenvatting, Module cards en een Issue map. De developer-agents gebruiken die, en ze worden meegegeven aan werkruimte-chats voor die codebase.

1. Klik op Codebase inspecteren (uitgeschakeld tot er een codebase gekoppeld is; zie Codebases).
2. Kies de codebase. De dialoog toont wat er eerder is gegenereerd en wanneer.
3. Klik op Run inspection, of op Re-inspect om de eerdere uitvoer te vervangen.

De gegenereerde bronnen verschijnen in de lijst onder het typefilter Codebase-docs. De gezondheid per codebase staat op Codebase-gezondheid (/knowledge/posture).

Kijk wat FixControl zou lezen

Het paneel Kijk wat FixControl zou lezen draait de zoekfunctie van de agents zelf voor een vraag die jij typt, zonder iets te wijzigen. Klik op Proberen om te zien welke passages de agents zouden vinden, in welke volgorde, waarom elke passage op die plek staat, en hoeveel bronnen voor die vraag buiten bereik waren (bijvoorbeeld omdat ze bij een ander project horen). Komt er niets terug, voeg dan het document toe dat de vraag beantwoordt.

Een passage die gemarkeerd is als geïndexeerd door een ouder model scoort lager tot FixControl je kennis opnieuw indexeert. Herindexeren doet FixControl; je kunt het niet zelf starten.

Voorgestelde concepten

Op /knowledge/suggestions stelt FixControl kennisartikelen voor die zijn opgesteld uit opgeloste tickets. Dat gebeurt alleen waar leren van tickets voor een integratie aan staat; standaard staat het uit.

Elk concept toont herkomst, taal en inhoud, met Edit, Reject en Approve. Alleen Approve maakt van een concept een geïndexeerde kennisbron; niets op deze pagina publiceert uit zichzelf. De suggestiepagina is in het Engels.

Systeemleringen

FixControl legt sommige uitkomsten vast als kennis van de soort System Learning, op het project:

• Patch-uitkomsten: als een patch wordt toegepast of afgewezen, of als de revisieronde vastloopt, wordt de case automatisch vastgelegd zodat later werk aan hetzelfde project ervan kan leren.
• Opgeloste tickets: uit Freshdesk, Jira, Odoo of TOPdesk, alleen als je leren voor die integratie aanzet (voor Freshdesk: Capture resolved tickets as project learning). Standaard uit. Persoonsgegevens worden eerst verwijderd, en tickets zonder project worden nooit vastgelegd.

Filter op System Learning om ze te zien. Vastgelegde goedkeuringsbeslissingen horen niet bij kennis en worden niet als context aan agents gegeven.

Kennis voor de websitechat

Voor de websitechat groepeer je documentatie in Kennisbundels onder Instellingen → Websitechat. Elke bundel heeft een zichtbaarheid: Publiek, Intern of Beperkt. Een publieke chat leest alleen publieke bundels, een interne chat leest publieke en interne bundels, en beperkte bundels worden door geen enkele chat gelezen. Een bundel bevat precies de bronnen die jij eraan toevoegt: een document uploaden in de Kennisbank zet het niet in een bundel.

Operator-oppervlak

De bronnenlijst heeft de gebruikelijke lijstfuncties:

• Zoeken op titels, tags en referenties, en filters op type, scope, project en codebase.
• Views: sla de huidige filters op als benoemde weergave, hernoem, dupliceer of verwijder weergaven, en markeer er één als je standaard.
• Kolommen om kolommen te tonen of te verbergen, en CSV om de huidige filterset te exporteren.
• Toetsenbord: j/k om te bewegen, / om te zoeken, Enter om te openen, x om te selecteren, Shift+x om een reeks te selecteren, Cmd/Ctrl+A om alle zichtbare rijen te selecteren, Esc om te wissen. Zie Toetsenbord & command palette.
• Verwijderen: per rij (met bevestiging) of voor de geselecteerde rijen. Een selectie geldt voor de huidige pagina; ze wordt gewist als je van pagina of filter wisselt. Verwijderen haalt de bron en haar chunks weg, zodat agents haar niet meer vinden; antwoorden die haar al citeerden houden hun vastgelegde bronvermelding.

Als er iets misgaat

• De agents lijken iets niet te weten. Gebruik Kijk wat FixControl zou lezen met de vraag van de klant. Komt er niets terug, dan ontbreekt het document of staat het nog op Processing; hoort het bij een ander project, voeg het dan toe aan het juiste project of maak het organisatiebreed.
• Opslaan of scrapen wordt geweigerd. Je hebt de rol beheerder of manager nodig; Codebase inspecteren vraagt de rol beheerder en een abonnement met codebase-analyse.
• Een scrape meldt fouten. De pagina blokkeert mogelijk geautomatiseerde toegang, vraagt een login, of verwijst door naar een adres dat geweigerd wordt. Plak de inhoud dan via Bron toevoegen.
• Ruwe e-mailthreads plakken. Die matchen luid en verdringen echte antwoorden. Vat eerst samen.

Veelgestelde vragen

Wat is het verschil tussen codebase-bronnen en je eigen documenten? Je eigen documenten (geplakt, geüpload, gescrapet) zijn vooral voor de antwoord- en intake-agents. Codebase-bronnen worden gemaakt door Codebase inspecteren, voor de developer-agents; die beheer je niet handmatig.

Wat betekent de status Reference? De bron is alleen als verwijzing opgeslagen: de inhoud is niet geïndexeerd, maar agents kunnen haar nog wel bij naam opzoeken.

Kan ik een bron beperken tot een project of codebase? Ja: voeg haar toe vanuit het project, of kies daar een codebase. Het zoeken respecteert de scope.

Zie ook: Antwoorden aan klanten, AI-geheugen, Projecten.