> For the complete documentation index, see [llms.txt](https://docs.artific.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.artific.nl/voor-beheerders/kennisbank/zoektools.md).

# Zoektools

Een zoektool maakt een collectie vindbaar voor een assistent. Te vinden onder **Kennisbank → Zoektools**.

## Waarom deze stap bestaat

Collecties bewaren documenten. Zoektools maken ze doorzoekbaar. Door die twee gescheiden te houden kun je één collectie op verschillende manieren aanbieden aan verschillende assistenten, en verandert een geüpload document nooit ongemerkt wat een assistent kan zien.

Niets in een collectie is doorzoekbaar totdat een zoektool het bestrijkt *en* die tool aanstaat voor de assistent.

## Er een aanmaken

Kies **Zoektool aanmaken**. De wizard heeft drie stappen.

### Stap 1: Inhoud

| Veld           | Wat je invult                                                                                              |
| -------------- | ---------------------------------------------------------------------------------------------------------- |
| **Naam**       | Hoe de tool gaat heten. Gebruik het onderwerp, niet de techniek: *Supportartikelen*, niet *Zoekmachine 1*. |
| **Collecties** | Vink de collecties aan die deze tool moet doorzoeken. Minstens één.                                        |

Onder **Geavanceerd: inhoudsfilters (optioneel)** kun je het verder inperken met regels, bijvoorbeeld alleen bestanden met een bepaald label, of alleen documenten onder een bepaald pad. Laat het leeg om alles uit de gekozen collecties mee te nemen.

### Stap 2: Zoeken

Hoe er gezocht moet worden.

| Optie                 | Wat het doet                                    | Waarvoor je het gebruikt                                                 |
| --------------------- | ----------------------------------------------- | ------------------------------------------------------------------------ |
| **Slim zoeken**       | Vindt zowel op betekenis als op exacte woorden. | Vrijwel alles. Dit is de aanbevolen standaard.                           |
| **Op betekenis**      | Begrijpt synoniemen en omschrijvingen.          | Vragen in gewone taal, waarbij de gebruiker jouw terminologie niet kent. |
| **Op exacte woorden** | Zoekt letterlijk.                               | Artikelnummers, productcodes en onderdeelnamen die exact moeten kloppen. |

Twijfel je, houd dan **Slim zoeken** aan. Dat combineert de andere twee.

### Stap 3: Controleren

Een samenvatting van wat er aangemaakt wordt. Het onderdeel **Technische details** toont de instellingen die voor je gekozen zijn; daar hoef je niets aan te doen.

Kies **Zoektool aanmaken**. Het instellen duurt een paar seconden, daarna worden je documenten op de achtergrond verwerkt. Je kunt gewoon doorwerken.

### Koppelen

Op het slotscherm kun je met **Nu gebruiken** de zoektool meteen koppelen aan assistenten en AI Toolbox-elementen. Je kunt dit ook overslaan en later koppelen via het tabblad **Tools** van een assistent of element.

## De lijst met zoektools

| Status                            | Betekenis                                                                                   |
| --------------------------------- | ------------------------------------------------------------------------------------------- |
| **Klaar voor gebruik**            | Werkt. De documenten zijn doorzoekbaar.                                                     |
| **Bestanden doorzoekbaar maken…** | Bezig, met een teller van de voortgang. Normaal na het toevoegen van documenten.            |
| **Indexeren mislukt**             | Er kon niets verwerkt worden. Controleer de documenten in de collectie.                     |
| **Configuratie onvolledig**       | De tool bestaat, maar er zijn geen collecties aan gekoppeld. Bewerk hem en voeg er een toe. |

**Bewerken** opent de wizard opnieuw met de huidige instellingen. **Verwijderen** haalt de zoektool en de bijbehorende zoekinstellingen weg. De documenten blijven in hun collectie staan, maar niets kan ze nog vinden.

{% hint style="warning" %}
Een zoektool verwijderen verzwakt ongemerkt elke assistent die hem gebruikt: die blijven werken, maar verliezen toegang tot die kennis. Kijk voordat je verwijdert welke assistenten hem aan hebben staan.
{% endhint %}

## Hoe je je zoektools indeelt

Eén zoektool per collectie is de eenvoudigste indeling en meestal de juiste.

Wijk daarvan af als:

* **Meerdere collecties bij één onderwerp horen.** Eén tool over al die collecties geeft de assistent één samenhangende plek om te zoeken.
* **Eén collectie verschillende doelgroepen bedient.** Bouw twee tools met verschillende inhoudsfilters (één die met een label beperkt is tot het openbare materiaal, één die alles bestrijkt) en geef elke assistent de passende tool.

Geef één assistent niet te veel overlappende zoektools. Hij moet bij elke vraag tussen die tools kiezen, en bij overlappende bereiken wordt die keuze willekeurig.

## Gezond houden

* Kijk na een grote upload naar de status tot die weer op **Klaar voor gebruik** staat.
* Worden bepaalde documenten niet gevonden, open dan het detailpaneel van het bestand en controleer de status onder **Zoekconfiguraties**. Eén **Mislukt** document zie je in een grote collectie snel over het hoofd.
* Filter een collectie af en toe op status **Mislukt** om documenten te vinden die het nooit gehaald hebben.