Zoekresultaten met meer structuur en context

Met deze update geven we je meer grip op de presentatie van zoekresultaten. Je kunt nu extra metadata meesturen via de API, zoals auteur, publicatiedatum of contenttype. Die metadata kun je vervolgens tonen in de zoekresultaten zodat bezoekers sneller zien wat ze vinden en waarom het relevant is

Zo stel je het in

Stap 1: Metadata meesturen via de API of Drupal Search API

Zorg dat je de gewenste metadata meestuurt vanuit je CMS. Gebruik duidelijke systeemnamen. Deze koppelen we aan vragen.ai en zijn daar zichtbaar als metadata.

Stap 2: instellen in vragen.ai

Voor elk nieuw veld dat je via de API meestuurt, maak je in vragen.ai een nieuw metadata-veld aan onder Instellingen.

Bij het toevoegen:

• Gebruik als naam de systeemnaam uit de API.

• Kies het juiste type, dit bepaalt de weergave:

  • Text

  • Number

  • Date (datum)

  • Boolean (ja/nee)

• Voeg eventueel een beschrijving toe.

• Stel eventueel een default value in voor documenten zonder deze metadata.

• Vink Is multiple aan als een veld meerdere waarden kan bevatten (bijv. meerdere auteurs).

Bestaande documenten krijgen metadata niet automatisch met terugwerkende kracht. Start een herindex vanuit de API om ontbrekende metadata toe te voegen. Neem contact op als je hulp wilt bij deze herindexatie.

Stap 3: metadata tonen bij zoekresultaten

Ga naar Mijn integraties en bewerk de gewenste integratie. Onder Semantisch zoeken vind je Zoekresultaatvelden. Als dit leeg is, wordt de standaardweergave gebruikt (titel en korte beschrijving).

• Klik op Voeg veld toe aan zoekresultaten.

• Selecteer per veld de gewenste metadata en geef optioneel een label, bijvoorbeeld: Auteur: [metadata].

• Pas de volgorde aan zoals je wilt dat deze wordt weergegeven.

De wijzigingen worden binnen circa 15 minuten zichtbaar.

Stap 4: layout aanpassen

We hanteren een standaardlayout. Wil je hiervan afwijken, dan kun je de weergave aan websitezijde aanpassen via custom CSS.

Waarom dit verschil maakt

Goed gestructureerde zoekresultaten helpen bezoekers sneller te begrijpen wat ze zien. Metadata zoals publicatiedatum en auteur geven context die de relevantie van een resultaat direct duidelijk maakt. Dit is vooral waardevol bij langere content, documenten of kennisartikelen waarin context het verschil maakt tussen vinden en begrijpen. Precies wat bezoekers van AI‑zoekervaringen verwachten. 

Met deze update koppelen we technische verbeteringen aan praktische leesbaarheid, zodat jouw zoekfunctie niet alleen meer relevante resultaten geeft, maar ook laat zien waarom iets relevant is.