> 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/assistenten/tools.md).

# Tools

Het tabblad **Tools** van een assistent bepaalt wat hij kan *doen*, in tegenstelling tot wat hij weet. Te bereiken via **AI Assistenten → Assistenten → ⋮ → Tools**.

## Wat een tool is

Standaard kan een assistent alleen praten. Met een tool kan hij handelen: een order opzoeken in een ander systeem, je kennisbank doorzoeken, een van je AI Toolbox-elementen uitvoeren of iets ophalen bij een externe dienst.

De assistent bepaalt zelf wanneer een tool het gebruiken waard is, op basis van de beschrijving die jij die tool geeft. Goede beschrijvingen zijn wat tools laat werken.

## Het Tools-scherm

Het tabblad toont elke tool die voor je organisatie beschikbaar is als kaart. Elke kaart heeft een schakelaar: **Activeren** zet de tool aan voor deze assistent, **Deactiveren** zet hem uit. Een tool aanzetten voor de ene assistent heeft geen gevolgen voor een andere.

Gebruik het veld **Zoek een tool** om een lange lijst te filteren.

Een tool die niet gebruikt kan worden, toont **Niet beschikbaar** met een slotje. De meest voorkomende reden is het model van de assistent: sommige modellen kunnen helemaal geen tools gebruiken, en zoeken op afbeeldingen vraagt om een model dat afbeeldingen kan lezen. Het scherm waarschuwt je bovenaan wanneer dit speelt, met een snelkoppeling **Kies een ander model**.

## Waar tools vandaan komen

| Herkomst                | Wat het is                                                                                                      | Waar het beheerd wordt                                |
| ----------------------- | --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| Platformtools           | Kant-en-klare mogelijkheden die met het platform worden meegeleverd, zoals zoeken op het web en bestandsexport. | Voor je klaargezet; alleen aan- of uitzetten.         |
| Zoeken in de kennisbank | Ontstaat wanneer je een zoektool over je collecties bouwt.                                                      | [Zoektools](/voor-beheerders/kennisbank/zoektools.md) |
| AI Toolbox-elementen    | Elk element in je Toolbox, aan de assistent aangeboden als actie.                                               | Vanaf dit scherm aangemaakt.                          |
| Eigen tools             | Aanroepen van je eigen API of die van een derde partij.                                                         | Vanaf dit scherm aangemaakt.                          |

Alleen die laatste twee kun je hier aanmaken. Al het andere wordt geleverd door het platform of door de kennisbank, en is alleen-lezen.

{% hint style="info" %}
Je kunt alleen tools bewerken en verwijderen die je eigen organisatie heeft aangemaakt. Tools die van elders met je gedeeld zijn en platformtools zijn alleen-lezen. De kaart legt uit waarom als je over de uitgeschakelde actie zweeft.
{% endhint %}

## Een elementtool aanmaken

Hiermee bied je een AI Toolbox-element aan de assistent aan, zodat een gebruiker hetzelfde resultaat krijgt door erom te vragen in een gesprek.

1. **Aanmaken → Elementtools**.
2. Selecteer één of meer elementen. Voor elk wordt een tool aangemaakt.
3. **Tools aanmaken**.

Daarna is het **Voortgangsbericht** het enige wat je aan een elementtool kunt bewerken: de regel die in de chat verschijnt terwijl hij draait. Al het andere komt uit het element.

## Een eigen tool aanmaken

**Aanmaken → Eigen tool** opent het formulier voor een API-tool. Dit is de technische variant. Zie [API-tools](/voor-beheerders/tools/api-tools.md) voor een uitleg veld voor veld.

## Kiezen welke tools je aanzet

* **Alleen wat de assistent nodig heeft.** Elke actieve tool is een extra optie die het model bij elk bericht moet afwegen. Een lange lijst maakt hem trager en minder voorspelbaar.
* **Let op overlap.** Twee tools die allebei dezelfde vraag zouden kunnen beantwoorden, leveren inconsistent gedrag op. Geef elke tool een eigen doel en een eigen beschrijving.
* **Test na het aanzetten.** Gebruik het tabblad **Voorbeeld** en stel een vraag die hem moet activeren, en één die dat niet moet doen.

## Verwant

* [API-tools](/voor-beheerders/tools/api-tools.md): je eigen API koppelen.
* [Connectors](/voor-beheerders/assistenten/connectors.md): acties op externe servers.
* [Zoektools](/voor-beheerders/kennisbank/zoektools.md): je documenten doorzoekbaar maken.