Zoekstrategieën

De KB Search Agent heeft vier zoekstrategieën tot zijn beschikking. De agent kiest autonoom de beste strategie op basis van de vraag, context en gewenste diepgang.

1. Chat Templates (semantisch zoeken + LLM antwoord)

De primaire zoekstrategie. De agent stelt een vraag aan een prompt template die automatisch relevante chunks uit de Knowledge Bases ophaalt via embedding-based search.

TemplateWat het doorzoektWanneer gebruiken
KB_SEARCH_BROAD Doc (10) + Help (10) + Video (6) chunks Algemene vragen, eerste verkenning
KB_SEARCH_DOCS Documentatie (20 chunks) Diep in feature-documentatie
KB_SEARCH_HELP Online Help (20 chunks) Schermbeschrijvingen, instellingen
KB_SEARCH_VIDEO Video's (12 chunks) How-to instructies, workflows
KB_SEARCH_WIKI Wiki (20 chunks) Technisch/code documentatie (developer)
KB_SEARCH_SUMMARY Top 50 samenvattingen per KB Overzicht, gerichte gap analysis
KB_SEARCH_SUMMARY_FULL ALLE samenvattingen (~521 bronnen) Exhaustieve gap analysis (duur!)

Hoe werkt een chat call?

  1. De vraag wordt omgezet naar een embedding vector
  2. De vector wordt vergeleken met alle chunk/samenvatting-vectoren in de geselecteerde KB's
  3. De meest relevante chunks worden als context meegegeven aan het LLM
  4. Het LLM genereert een antwoord met bronverwijzingen

Het antwoord bevat: answer (HTML), sources (bronnen met type/titel/URL), confidence (0-1), en gaps (ontbrekende informatie).

2. Keyword Search (directe tekstzoekopdracht)

Zoekt op exacte termen in de brontitels en metadata. Geschikt voor specifieke instellingsnamen, foutmeldingen, of technische termen.

Endpoint: GET /api/v2/knowledge-bases/{kb}/sources?search={term}

Elke KB wordt apart doorzocht. De agent combineert de resultaten.

3. Volledige Brontekst Ophalen

Wanneer een relevante bron is gevonden, kan de agent de complete tekst ophalen voor grondige analyse.

Endpoint: GET /api/v2/knowledge-bases/{kb}/sources/{code}

Retourneert het complete_content veld (volledige brontekst).

4. Chunk Search (zoeken binnen een bron)

Zoekt specifieke content binnen een bekende bron.

Endpoint: GET /api/v2/knowledge-bases/{kb}/sources/{code}/chunks?search={term}

Strategie-keuze

De agent kiest autonoom. Richtlijnen:

  • Snelle feitelijke vraagKB_SEARCH_BROAD
  • Specifieke term (bijv. "ART_APP") → Keyword search, dan gericht chat template
  • Diepe analyseKB_SEARCH_DOCS of KB_SEARCH_HELP
  • OverzichtsvraagKB_SEARCH_SUMMARY
  • Gap analysisKB_SEARCH_SUMMARY_FULL + keyword search
  • Technische vraagKB_SEARCH_WIKI meenemen

Laatste nieuws

Elke fout een keer, en dan de hele soort

Er gaat elke week iets stuk, en dat is de normale toestand van software die echt gebruikt wordt. Over de gewoonte die het team bij elkaar houdt: elk incident wordt geen pleister op dat ene geval, maar een regel die de hele soort afvangt.

Lees meer

De regel die niet kan twijfelen

De mail automatisch sorteren ging bijna altijd goed, maar een lastige soort bleef glippen, en de AI beter instrueren hielp niet meer. Over het moment waarop een botte, vaste regel betrouwbaarder is dan een slimme die af en toe mist.

Lees meer

De wachtlijst van de mens werd een rij knoppen

Als een AI-collega vastloopt op een beslissing die alleen een mens kan nemen, stelde hij die vraag als een lap tekst. En het systeem porde urenlang de verkeerde. Over drie stappen die de vraag aan de mens zichtbaar, klikbaar en snel maakten.

Lees meer

We ontdekten dat we een module hadden

De schermen waarmee we ons AI-team beheren waren stuk voor stuk gebouwd, precies wanneer we ze nodig hadden. Pas toen er iemand bij kwam die ze niet zelf had gebouwd, bleek wat er ontbrak. Niet nieuwe schermen, maar orde.

Lees meer