Om een effectieve Typesense-zoekconfiguratie te ontwerpen die gebruikmaakt van geavanceerde synoniemenbeheer en fouttolerantie voor jouw productcatalogus, kun je de volgende aanpak volgen: 1. Indexstructuur en velden: - Maak een collectie aan met velden zoals naam, beschrijving en categorie. - Stel de velden in als "searchable" en "filterable" waar nodig. - Bijvoorbeeld: ```json { "name": "producten", "fields": [ {"name": "naam", "type": "string", "facet": false}, {"name": "beschrijving", "type": "string", "facet": false}, {"name": "categorie", "type": "string", "facet": true} ], "default_sorting_field": "naam" } ``` 2. Synoniemenbeheer: - Gebruik de "synonyms"-functie van Typesense om synoniemen en verwante termen te definiëren. - Bijvoorbeeld voor auto, wagen, voertuig: ```json { "synonyms": [ ["auto", "wagen", "voertuig"] ] } ``` - Deze synoniemen kunnen worden toegevoegd via de API of via configuratiebestanden. Zorg dat je deze regelmatig bijwerkt op basis van zoekgedrag. 3. Fouttolerantie en typo-correctie: - Typesense ondersteunt typo-correctie door de "prefix" search en "typo tolerance" instellingen. - Stel "typo_tolerance" in op een waarde die spelfouten en typefouten corrigeert zonder de relevantie te verminderen. - Bijvoorbeeld: ```json { "search_parameters": { "prefix": true, "typo_tolerance": "min", "num_typos": 1 } } ``` - Hiermee worden resultaten gevonden zelfs als er een of twee typfouten in de zoekterm zitten. 4. Relevantie en ranking: - Gebruik "ranking rules" om de relevantie te optimaliseren, bijvoorbeeld: ```json "ranking": [ "typo", "words", "proximity", "attribute", "exactness" ] ``` - Prioriteer woorden die exact overeenkomen en dicht bij elkaar liggen. 5. Geavanceerde optimalisaties: - Overweeg het gebruik van "searchable attributes" en "optional attributes" om meer controle te krijgen. - Bijvoorbeeld: ```json { "searchable_attributes": ["naam", "beschrijving", "categorie"] } ``` 6. Implementatievoorbeeld: - Wanneer je zoekopdrachten verwerkt, gebruik de API met bovenstaande parameters en synoniemen. - Zorg dat je API-aanroepen correct zijn geconfigureerd om typo-tolerantie en synoniemen te activeren. Door deze instellingen zorgvuldig te combineren, verbeter je de zoekervaring door relevante resultaten te tonen, fouten te corrigeren en synoniemen effectief te gebruiken. Blijf regelmatig je synoniemen en typo-instellingen evalueren op basis van gebruikersfeedback en zoekgedrag.

Absoluut! Hier is een gedetailleerd ontwerp voor je Typesense-zoekconfiguratie, specifiek afgestemd op een productcatalogus en gericht op het optimaliseren van de relevantie en gebruikerservaring. ### 1. Collection Schema Ontwerp Eerst definiëren we de structuur van je collection met de juiste velden en hun eigenschappen. De keuze van `token_separators` en `symbols_to_index` is cruciaal voor het correct splitsen van productnamen. ```json { "name": "producten", "fields": [ { "name": "naam", "type": "string", "locale": "nl", "infix": true, "index": true, "optional": false }, { "name": "beschrijving", "type": "string", "locale": "nl", "index": true, "optional": true }, { "name": "categorie", "type": "string", "locale": "nl", "facet": true, "index": true, "optional": false } ], "default_sorting_field": "naam", "token_separators": ["-", "@"], // Handelt samenstellingen zoals "sport-auto" "symbols_to_index": ["@", "&", "-", "_"] // Indexeer speciale tekens die vaak in productnamen voorkomen } ``` **Toelichting:** * `"infix": true` op het `naam`-veld: Zorgt voor **prefix-, suffix- en infix-zoeken**. Een zoekopdracht zoals `band` vindt ook `autoband` en `banden`. * `"locale": "nl"`: Zorgt voor een correcte tokenization (woordafbreking) voor de Nederlandse taal. * `"facet": true` op `categorie`: Maakt het mogelijk om op categorie te filteren en facetten te tonen. --- ### 2. Geavanceerde Synoniemenbeheer Voor je voorbeeld `auto -> wagen, voertuig` zijn er twee soorten synoniemen nuttig: **meerwoordige** en **eenrichtingsverkeer**. **a) Multi-Way Synoniemen (Aanbevolen voor jouw geval)** Deze creëren een equivalentie tussen termen. Zoeken op een van deze termen retourneert resultaten voor alle anderen. ```json // POST naar collections/producten/synonyms { "synonyms": [ "auto", "wagen", "voertuig", "automobiel", "car" ] } ``` **b) One-Way Synoniemen (Uitbreiding)** Handig voor het verbreden van zoekopdrachten zonder exacte equivalentie. Bijvoorbeeld, als iemand zoekt op een specifiek merk, wil je misschien ook algemenere resultaten tonen. ```json { "root": "volkswagen", "synonyms": ["vw", "golf", "polo"] } ``` **Aanvullende voorbeelden van synoniemengroepen voor een productcatalogus:** * `["telefoon", "smartphone", "gsm", "mobiel", "toestel"]` * `["laptop", "notebook", "ultrabook"]` * `["tv", "televisie", "smart-tv", "tevee"]` * `["fiets", "bicycle", "rijwiel", "stadsfiets", "mountainbike", "mtb"]` * `["pc", "desktop", "computer", "tower"]` --- ### 3. Fouttolerantie (Typo-tolerantie) Typesense heeft uitzonderlijk goede, ingebouwde typo-tolerantie. Je configureert dit per zoekopdracht via search parameters, niet in het schema. **Aanbevolen parameters in je zoekquery:** ```json { "q": "autto", // De (fout gespelde) zoekterm van de gebruiker "query_by": "naam, beschrijving, categorie", // Velden om in te zoeken "num_typos": 2, // Aantal toegestane typefouten "prefix": true, // Prefix-zoeken inschakelen (vindt "automa" bij zoeken op "auto") "drop_tokens_threshold": 1, // Staat toe om een term te negeren bij multi-word queries als er geen goede match is "typo_tokens_threshold": 1, // Staat toe om een term met typo te matchen als er geen exacte match is "exhaustive_search": true // Zoekt nauwgezet door alle tokens, zorgt voor betere matches maar is iets langzamer } ``` **Hoe het werkt:** * `"num_typos": 2`: Herkent en corrigeert **tot 2 typefouten** per woord. Zoekopdrachten zoals `"autto"`, `"vooertuig"` of `"waggon"` vinden nog perfect resultaten voor `auto`, `voertuig` en `wagen`. * `"prefix": true`: Lost het probleem op van **onvolledige zoekopdrachten**. Zoeken op `"aud"` vindt producten met `"Audi"` en `"audio"`. * De combinatie van `drop_tokens_threshold` en `typo_tokens_threshold` zorgt ervoor dat complexe zoekopdrachten zoals `"rode sport autto"` nog steeds robuuste resultaten opleveren, zelfs met een spelfout. --- ### 4. Optimalisatie voor Relevantie en Gebruikerservaring Alleen vinden is niet genoeg; de beste resultaten moeten eerst getoond worden. **a) Weging van Velden (Priority)** Geef het `naam`-veld meer gewicht dan de `beschrijving`, omdat een match in de naam doorgaans relevanter is. ```json { "q": "volkswagen", "query_by": "naam, beschrijving, categorie", "query_by_weights": "3, 1, 2", // Gewicht voor naam, beschrijving, categorie "num_typos": 2, "prefix": true } ``` **b. Sorteren op Relevantie (Text Match)** Stel `sort_by` in op `_text_match:desc` om de beste matches bovenaan te zetten. Dit is vaak de standaard, maar het is expliciet zetten is goed. **c. Gebruik van Facetten voor Filteren** Facetten op `categorie` stellen gebruikers in staat om hun zoekresultaten direct te verfijnen. ```json { "q": "auto", "query_by": "naam, beschrijving", "facet_by": "categorie", // Toon beschikbare categorieën voor filtering "num_typos": 2 } ``` ### Samenvatting van je configuratiestrategie: 1. **Schema:** Definieer je velden met `infix:true` en `locale:nl`. 2. **Synoniemen:** Voeg multi-way synoniemengroepen toe (bijv. `["auto", "wagen", "voertuig"]`) via de Synonyms API. 3. **Zoekopdrachten:** Gebruik in al je zoekquery's de parameters `num_typos: 2` en `prefix: true` voor maximale fouttolerantie. 4. **Relevantie:** Fine-tune de resultaten met `query_by_weights` en `facet_by`. Deze combinatie zorgt voor een zeer vergevingsgezinde, intuïtieve en relevante zoekervaring voor je gebruikers, waarbij ze vinden wat ze zoeken, zelfs als ze niet precies weten hoe het heet of hoe het gespeld wordt.