> 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/problemen-oplossen.md).

# Problemen oplossen

De problemen waar beheerders het vaakst tegenaan lopen, en wat de echte oorzaak is.

## De assistent weet iets niet dat hij zou moeten weten

Loop het in deze volgorde na. De oorzaak zit bijna altijd eerder in de keten dan het lijkt.

1. **Zit het document in een collectie?** Kijk bij [Collecties](/voor-beheerders/kennisbank/collecties.md).
2. **Is de status Geïndexeerd?** Alles daarbuiten betekent dat het nog niet doorzoekbaar is. Bij **Mislukt** zie je de reden als je erover zweeft.
3. **Dekt een zoektool die collectie?** Zonder zoektool zijn documenten niet doorzoekbaar. Zie [Zoektools](/voor-beheerders/kennisbank/zoektools.md).
4. **Staat de zoektool aan voor deze assistent?** Kijk op het tabblad **Tools**.
5. **Kan het ophalen het vinden?** Gebruik **Uitproberen** op de ophaaltool onder [Geavanceerd](/voor-beheerders/kennisbank/geavanceerd.md) en zoek op een zinsnede uit het document. Komt het daar niet terug, dan zit het probleem in het ophalen en niet in de assistent.
6. **Staan de instructies het toe?** Een assistent die alleen uit zijn eigen documenten mag antwoorden, weigert als het ophalen niets heeft opgeleverd.

## De assistent geeft verouderde of verkeerde informatie

Bijna altijd een oud document dat nog in de collectie staat. De assistent kan niet weten welke van twee versies actueel is. Hij citeert er zonder problemen uit allebei.

Verwijder achterhaalde documenten in plaats van er nieuwere naast te zetten. Moet je historie bewaren, gebruik dan een [label](/voor-beheerders/kennisbank/labels.md) als `gearchiveerd` en sluit dat uit met een contentfilter op de zoektool.

## De assistent verzint antwoorden

* Verlaag **Creativiteit** in de [instellingen](/voor-beheerders/assistenten/instellingen.md) van de assistent.
* Wees expliciet in de instructies: *"Antwoord alleen op basis van de documenten die je ter beschikking staan. Staat het antwoord er niet in, zeg dan dat je het niet weet."*
* Zet **Bronvermeldingen tonen** aan zodat gebruikers het kunnen nakijken.
* Voeg een controle **Geen hallucinatie** toe in [kwaliteitscontrole](/voor-beheerders/kwaliteitscontrole/scenarios.md).

## Een tool wordt nooit gebruikt

* **Staat hij aan** voor deze assistent?
* **Ondersteunt het model tools?** Het instellingenscherm waarschuwt als dat niet zo is.
* **Is de beschrijving goed genoeg?** Dit is meestal de oorzaak. De assistent kiest tools door **Beschrijving voor LLM** te lezen. Zie [API-tools](/voor-beheerders/tools/api-tools.md).
* **Zijn de beschrijvingen van de argumenten duidelijk?** De assistent moet uit het gesprek afleiden wat hij erin moet zetten.

## Iemand kan een scherm niet zien

Diegene zit niet in een groep waarvan de rol dat scherm geeft. Open de gebruiker, kijk bij **Gebruikersgroepen** en controleer daarna wat die groepen meebrengen. Zie [Rollen en rechten](/voor-beheerders/toegang/rollen.md).

Zie *jij* een scherm niet dat in deze documentatie staat beschreven, dan geldt hetzelfde voor jou, of je abonnement bevat het niet.

## Iemand kan niet inloggen

* Staat de methode die diegene gebruikt aan in de [organisatie-instellingen](/voor-beheerders/organisatie/instellingen.md)?
* Bestaat het account met precies dat e-mailadres?
* Heeft diegene de onboardinglink ooit afgerond? Het platform mailt die niet. Die verstuur je zelf.

## Er komt geen mail binnen in de Inbox

* Controleer de status van het kanaal onder [Communicatiekanalen](/voor-beheerders/gesprekken/communicatiekanalen.md). **Token ingetrokken** betekent dat de toegang is verlopen. Gebruik **Opnieuw verbinden**.
* Controleer of er een assistent aan het kanaal is gekoppeld.
* Stuur een testbericht vanaf een extern adres.

## Antwoorden zien er verkeerd uit als ze binnenkomen

De [mailtemplate](/voor-beheerders/gesprekken/mailtemplates.md) is het kader rond het antwoord. Controleer of `body` precies één keer voorkomt, en lees een testantwoord ook op een telefoon en niet alleen op een computer.

## De kosten zijn gestegen

Open het [Tokenrapport](/voor-beheerders/rapportages/tokens.md) en splits het uit per assistent en daarna per model. Veelvoorkomende oorzaken: er is een nieuwe assistent live gegaan, een zoektool is veel meer context gaan teruggeven, of een duur model handelt eenvoudige vragen in hoge aantallen af.

## Kwaliteitscontrole staat op rood

Lees het antwoord zelf voordat je aanneemt dat de assistent stuk is. Een te strenge controle is de meest voorkomende oorzaak. Vooral **Exacte match** gaat onderuit bij een onschuldige herformulering. Zie [Runs en resultaten](/voor-beheerders/kwaliteitscontrole/runs.md).

## Wanneer je je accountmanager belt

* Alles over hosting, gegevensverwerking, compliance of contracten.
* Een functie die lijkt te ontbreken of uitgeschakeld te zijn voor je organisatie.
* Limieten van je abonnement, facturatie of mogelijkheden waarvan je niet zeker weet of je ze hebt.
* Een probleem dat blijft bestaan nadat je bovenstaande hebt doorlopen.