AI Modelconfiguratie

mindzieStudio biedt nu sterk verbeterde integratie van grote taalmodellen (LLM), waardoor je flexibele opties hebt om je AI-copiloten en assistenten aan te drijven. Je kunt mindzie's ingebouwde proxy-modellen gebruiken, verbinding maken met populaire cloudproviders met je eigen API-sleutels, of on-premise modellen inzetten voor volledige controle.

Overzicht

Het AI-modelconfiguratiesysteem stelt je in staat om:

• Gebruik mindzie Proxy-modellen: Toegang tot snelle en denkmodellen direct beschikbaar in mindzieStudio
• Breng je eigen modellen: Verbind met elke OpenAI-compatibele API met je eigen inloggegevens
• Cloudproviders: Gebruik OpenAI, OpenRouter, Grok, Gemini en andere grote AI-providers
• On-Premise Implementatie: Zet lokale modellen in met LM Studio, Ollama of vergelijkbare platformen
• Automatische Detectie: Laat mindzieStudio automatisch modelmogelijkheden, tokenlimieten en functies detecteren
• Meerdere Modellen: Configureer zoveel modellen als nodig voor verschillende toepassingen

Wanneer AI Modelconfiguratie te gebruiken

Configureer AI-modellen wanneer je:

• Voor het eerst copilot-assistenten wilt instellen
• Wilt wisselen tussen verschillende AI-providers op basis van kosten of prestaties
• On-premise modellen wilt inzetten voor dataprivacy en beveiliging
• Gespecialiseerde modellen wilt gebruiken voor specifieke taken (snelle modellen voor snelle reacties, denkmodellen voor complexe analyses)
• API-sleutels wilt rouleren voor naleving van beveiligingsbeleid
• Nieuwe modellen wilt testen voordat je ze standaard maakt

Voorwaarden

Voordat je AI-modellen configureert:

• Administratieve Toegang: Je moet administratieve toegang hebben tot mindzieStudio-instellingen
• API-sleutels: Verkrijg API-sleutels van je geselecteerde provider (OpenAI, OpenRouter, enz.)
• Provideraccount: Maak een account aan bij je AI-provider als je externe diensten gebruikt
• On-Premise Setup: Als je lokale modellen gebruikt, installeer en configureer LM Studio, Ollama of gelijkwaardige software

Toegang tot Copilot-instellingen

Navigeer naar de copilot-instellingen via het administratiepaneel.

1. Klik op je profielfoto rechtsboven
2. Selecteer Instellingen in het dropdownmenu
3. Klik in de linkerzijbalk op Copilot

Je ziet de pagina mindzie Copilot Instellingen met twee hoofdsecties:

• LLM Providers: Beheer je AI-dienstenproviders
• LLM Models: Configureer specifieke modellen van je providers

Een AI-provider toevoegen

Providers zijn de AI-diensten die de modellen hosten. Je kunt meerdere providers toevoegen en wisselen.

Stap 1: Open de dialoog Add Provider

1. Klik op de knop Add Provider in de sectie LLM Providers
2. Het dialoogvenster Add Provider opent

Stap 2: Kies het type Provider

Selecteer in de dropdown Provider Type:

• OpenAI: Officiële OpenAI API (GPT-4, GPT-3.5, enz.)
• AzureOpenAI: OpenAI-modellen gehost op Microsoft Azure
• Anthropic: Claude-modellen van Anthropic
• Google: Google's Gemini-modellen
• OpenRouter: Toegang tot meerdere modellen via OpenRouter
• LMStudio: Lokale implementatie met LM Studio
• Other: Elke andere OpenAI-compatibele API (gebruik dit voor Ollama, xAI Grok, enz. — geef de basis-URL op)

Opmerking: Voor bekende providers kent mindzieStudio automatisch de basis-URL. Voor lokale implementaties of aangepaste providers kies je Other en voer je de basis-URL in.

Stap 3: Configureer Providergegevens

Provider Name: Voer een beschrijvende naam in voor deze provider (bijv. "OpenAI Production", "Local LM Studio")

API Key: Voer je API-sleutel van de provider in

• Voor cloudproviders verkrijg je deze uit het dashboard van je provider
• Voor lokale implementaties is dit mogelijk niet vereist of kan het leeg worden gelaten

Organization ID (optioneel): Sommige providers zoals OpenAI ondersteunen organisatie-ID's voor facturering en toegangsbeheer

Base URL (optioneel): Voor aangepaste of lokale implementaties

• LM Studio voorbeeld: http://localhost:1234/v1
• Ollama voorbeeld: http://localhost:11434/v1
• Aangepaste API: De API-eindpunt van je server

Stap 4: Stel de Provider Status in

Active: Vink dit aan om de provider in te schakelen

• Uitvinken om tijdelijk uit te schakelen zonder de configuratie te verwijderen
• Handig als je het gebruik wilt pauzeren maar je API-sleutels wilt bewaren

Set as Default Provider: Vink dit aan om deze provider als standaard in te stellen

• De standaardprovider wordt gebruikt bij het toevoegen van nieuwe modellen
• Vereenvoudigt de configuratie als je vooral één provider gebruikt

Stap 5: Test de Verbinding

Test vóór het opslaan of je provider correct is geconfigureerd.

1. Klik op de knop Test Connection
2. mindzieStudio probeert verbinding te maken met de provider met je gegevens
3. Er verschijnt een succes- of foutmelding

Opmerking: Als je "Authentication failed: Invalid API key" ziet, controleer dan of je API-sleutel correct is en niet is verlopen.

Stap 6: Sla de Provider op

Klik op Create om de providerconfiguratie op te slaan.

Je provider verschijnt nu in de tabel LLM Providers.

Bestaande Providers beheren

Een Provider bewerken

Om providerinstellingen bij te werken (bijv. een API-sleutel roteren):

1. Klik op het bewerkpictogram (potlood) in de kolom Actions
2. Het dialoogvenster Edit Provider opent met de huidige instellingen
3. Pas je wijzigingen aan (bijv. update de API-sleutel)
4. Klik op Test Connection om de nieuwe gegevens te verifiëren
5. Klik op Update om op te slaan

Veelvoorkomend gebruikscenario: API-sleutels moeten mogelijk worden geroteerd volgens het beveiligingsbeleid van je IT-afdeling. Gebruik functies voor provider bewerken om sleutels bij te werken zonder de hele configuratie opnieuw te maken.

Een Provider verwijderen

Om een provider te verwijderen:

1. Klik op het verwijderpictogram (prullenbak) in de kolom Actions
2. Bevestig de verwijdering

Waarschuwing: Het verwijderen van een provider verwijdert niet de gekoppelde modellen, maar die modellen werken niet meer zonder een geldige provider.

Een Model toevoegen

Zodra je ten minste één provider hebt geconfigureerd, kun je AI-modellen toevoegen.

Stap 1: Open de dialoog Add Model

1. Klik op de knop Add Model in de sectie LLM Models
2. Het dialoogvenster Add Model opent

Het dialoogvenster bevat twee hoofdsecties:

• Model Configuration (links): Basisinstellingen van het model
• Testing & Validation (rechts): Automatische detectie van mogelijkheden

Stap 2: Selecteer Provider

Kies de Provider uit het dropdownmenu.

Deze dropdown toont alle actieve providers die je hebt toegevoegd.

Stap 3: Selecteer of voer de modelnaam in

Je hebt twee opties om het model op te geven:

Optie A: Selecteren uit lijst (Aanbevolen)

1. Klik op de knop Select Model naast het veld Provider Model Name
2. Er verschijnt een dialoog Select Model met een zoekveld
3. mindzieStudio vraagt de API van de provider om beschikbare modellen op te halen

4. Een lijst met beschikbare modellen verschijnt

5. Klik op een model om het te selecteren (bijv. gpt-5-search-api-2025-10-14)

Opmerking: Niet alle modellen van een provider zijn geschikt voor chat. Bijvoorbeeld, OpenAI biedt audio- en embeddingsmodellen die niet werken met mindzieStudio copiloten. Het selecteren van een incompatibel model leidt tot fouten bij gebruik.

Optie B: Handmatige invoer

Als je de exacte modelnaam kent, typ deze dan direct in het veld Provider Model Name.

Voorbeelden:

• gpt-4-turbo
• gpt-4o-mini
• claude-3-opus-20240229

Stap 4: Configureer de Modelweergavenaam

Model Display Name: Voer een gebruiksvriendelijke naam in die gebruikers zien

• Voorbeeld: GPT-4 Turbo (snel, kostenefficiënt)
• Deze naam verschijnt in de copilot-interface bij het selecteren van modellen

Stap 5: Stel de Standaard Temperatuur in

Default Temperature: Stel in tussen 0 en 2

• Lagere waarden (0-0.3): Meer deterministische, gefocuste reacties
• Middelwaarden (0.7-1.0): Balans tussen creativiteit en consistentie
• Hogere waarden (1.0-2.0): Creatievere en gevarieerdere reacties

Standaard: 1 is een goed startpunt voor de meeste toepassingen

Stap 6: Auto-detecteer mogelijkheden

mindzieStudio kan automatisch detecteren welke functies het model ondersteunt.

1. Klik op de knop Auto-Configure Capabilities in de sectie Testing & Validation
2. mindzieStudio maakt verbinding met de provider en test het model

3. Binnen enkele seconden detecteert en configureert het systeem:
   • Tokenlimieten: Maximale context- en outputtokens
   • Modelmogelijkheden: Ondersteunde functies
   • Temperatuurondersteuning: Of de temperatuurparameter beschikbaar is
   • Systeemberichten: Of het model systeemberichten ondersteunt
   • Tool Calling: Of het model externe tools kan aanroepen

4. Klik op Close in het succesvenster
5. De mogelijkheden worden automatisch ingevuld in het formulier

Automatisch ingevulde informatie:

• Max Context Tokens: 128.000 (in dit voorbeeld)
• Max Output Tokens: 16.000 (in dit voorbeeld)
• Gedetecteerde Tier: Voorgestelde tier voor dit model (Small, Agent, of Thinking)
• Modelmogelijkheden: Systeemberichten (aangevinkt), Temperatuur (in dit voorbeeld niet aangevinkt)

Stap 7: Handmatige Aanpassing (optioneel)

Je kunt de automatisch gedetecteerde mogelijkheden handmatig aanpassen indien nodig.

Waarschuwing: Pas alleen aan als je zeker weet dat de autodetectie onjuist is. Onjuiste instelling van mogelijkheden veroorzaakt fouten bij het gebruik van het model.

Bijvoorbeeld:

• Als je temperatuur inschakelt voor een model dat dit niet ondersteunt, zullen API-aanroepen mislukken
• Als je tokenlimieten te hoog zet, worden verzoeken mogelijk afgewezen

Stap 8: Stel de Modelstatus in

Active: Vink aan om het model in gebruik te stellen

• Uitvinken om tijdelijk uit te schakelen zonder te verwijderen

Set as Tenant Default Model: Vink aan om dit model als standaardmodel voor alle copilot-assistenten te gebruiken

• Er kan slechts één tenant-standaardmodel zijn
• Het instellen van een nieuw standaardmodel stelt ook de provider van dat model in als standaardprovider

Stap 9: Maak het Model aan

1. Klik op de knop Create
2. Er verschijnt een informatiedialoog ter bevestiging dat het model is toegevoegd

3. Klik op Close
4. Het model verschijnt nu in de tabel LLM Models

Begrijpen van de modellen tabel

De tabel LLM Models toont:

Kolom	Beschrijving
Model Name	De door jou geconfigureerde weergavenaam
Provider	Welke provider dit model host
Provider Model Name	Technische modelidentificatie gebruikt door de API
Tier	Modelltier: Small (snelle routeringstaken), Agent (complex redeneren), Thinking (uitgebreid redeneren), of Disabled
Status	Actief of Inactief
Tenant Default	Toont "DEFAULT" als dit het tenant-brede standaardmodel is
Actions	Bewerken of verwijderen van het model

Modellen beheren

Een model bewerken

Om de configuratie van een model aan te passen:

1. Klik op het bewerkpictogram in de kolom Actions
2. Werk de instellingen bij in de dialoog Edit Model
3. Klik op Update om wijzigingen op te slaan

Een ander standaardmodel instellen

Om te wijzigen welk model standaard wordt gebruikt:

1. Bewerk het model dat je als standaard wilt instellen
2. Vink Set as Tenant Default Model aan
3. Klik op Update

Het vorige standaardmodel wordt automatisch uitgezet.

Een model verwijderen

Om een model te verwijderen:

1. Klik op het verwijderpictogram in de kolom Actions
2. Bevestig de verwijdering

Opmerking: Je kunt een model dat momenteel als tenant-standaard is ingesteld niet verwijderen. Stel eerst een ander standaardmodel in.

Je configuratie testen

Na het configureren van providers en modellen, test je setup:

1. Navigeer naar een copilot-mogelijkheid (bijvoorbeeld Investigations, AI Teammate)
2. Open de copilot-interface
3. Controleer of je standaardmodel verschijnt in de modelselector
4. Verstuur een testvraag om te controleren of het model correct reageert

Ondersteunde providers

Cloudproviders

mindzieStudio ondersteunt elke OpenAI-compatibele API, onder andere:

• OpenAI: GPT-4, GPT-4 Turbo, GPT-3.5, GPT-5 (wanneer beschikbaar)
• OpenRouter: Multi-provider toegang tot honderden modellen
• Anthropic Claude (via OpenRouter of compatibele proxy)
• Grok (xAI)
• Google Gemini (via compatibele API)
• Azure OpenAI Service
• Aangepaste API's: Elke dienst die de OpenAI API-specificatie implementeert

On-Premise oplossingen

Voor dataprivacy en beveiliging kun je modellen lokaal inzetten:

• LM Studio: Gebruiksvriendelijke lokale modelimplementatie
• Ollama: Lichtgewicht lokale modelservice
• vLLM: High-performance inference server
• Text Generation Inference: Hugging Face's inference server
• LocalAI: OpenAI-compatibele lokale inference

Vereisten voor On-Premise setup:

1. Installeer de gekozen lokale inference-software
2. Download en laad je voorkeurmodel
3. Start de lokale server (meestal op localhost:1234 of localhost:11434)
4. Voeg in mindzieStudio een provider toe met de lokale basis-URL
5. Voeg modellen toe via de lokale provider

Best practices

Beveiliging van API-sleutels

• Roteer regelmatig sleutels: Verander API-sleutels periodiek volgens je beveiligingsbeleid
• Gebruik organisatie-ID's: Gebruik organisatie-ID's waar mogelijk om gebruik en kosten te monitoren
• Beperk sleutelrechten: Gebruik API-sleutels met minimale benodigde rechten
• Deel geen sleutels: Iedere gebruiker of team moet eigen API-inloggegevens hebben

Modelkeuze

• Snelle modellen voor realtime: Gebruik modellen zoals gpt-4o-mini voor snelle copilot-reacties
• Denkmodellen voor analyse: Gebruik grotere modellen zoals gpt-5-search-api voor complexe analysetaken
• Test voor standaard: Test nieuwe modellen goed voordat je ze als tenant-standaard instelt
• Monitor kosten: Houd gebruik en kosten per model bij, vooral bij dure modellen

Providerbeheer

• Houd providers actief: Schakel providers alleen uit wanneer nodig om verwarring te voorkomen
• Beschrijvende namen: Gebruik duidelijke provider-namen zoals "OpenAI Production" of "Local LM Studio Dev"
• Test verbindingen: Test altijd verbindingen na toevoegen of bewerken van providers
• Meerdere providers: Configureer reserveproviders voor het geval je hoofdprovider problemen heeft

Mogelijkheidsconfiguratie

• Vertrouw op autodetectie: Gebruik auto-configuratie voor mogelijkheden wanneer mogelijk
• Niet gokken: Raadpleeg de documentatie van het model als autodetectie faalt, gok niet
• Verifieer tokenlimieten: Onjuiste tokenlimieten kunnen onverwachte afkapping of fouten veroorzaken
• Regelmatig bijwerken: Modelmogelijkheden kunnen veranderen bij API-updates

Problemen oplossen

Verbindings test mislukt

Als het testen van een provider-verbinding mislukt:

1. Controleer API-sleutel: Kopieer de sleutel rechtstreeks vanuit het provider dashboard
2. Controleer basis-URL: Zorg dat de basis-URL correct is en het protocol bevat (http:// of https://)
3. Netwerktoegang: Controleer of je netwerk verbindingen naar de provider toestaat
4. Providerstatus: Controleer of de API van de provider niet offline is
5. Organization ID: Verwijder organisatie-ID als deze niet nodig is

Model verschijnt niet in Copilot

Als een model niet verschijnt bij gebruik van copiloten:

1. Controleer actieve status: Zorg dat zowel provider als model als Actief zijn gemarkeerd
2. Verifieer provider: Controleer of de provider van het model actief is
3. Ververs interface: Herlaad de copilot-interface
4. Controleer permissies: Verifieer dat je toegang hebt tot AI-functionaliteiten

Autodetectie faalt

Als auto-configuratie van mogelijkheden niet werkt:

1. Test de provider eerst: Zorg dat de providerverbinding geldig is
2. Controleer modelnaam: Controleer of de modelnaam correct is
3. API-machtigingen: Sommige API's vereisen speciale permissies voor mogelijkhedenqueries
4. Handmatige configuratie: Configureer mogelijkheden handmatig via de modeldocumentatie als fallback

Modelfouten tijdens gebruik

Als een model fouten retourneert bij gebruik:

1. Controleer mogelijkheden: Zorg dat de mogelijkheden overeenkomen met wat het model ondersteunt
2. Controleer tokenlimieten: Controleer dat maximale context- en outputtokens niet te hoog zijn ingesteld
3. Temperatuurinstelling: Sommige modellen ondersteunen geen temperatuur - schakel het indien nodig uit
4. API-quota: Controleer of je provider-limieten of quota niet zijn overschreden

Voorbeeldconfiguraties

Voorbeeld 1: OpenAI met meerdere modellen

Providerconfiguratie:

• Provider Type: OpenAI
• Provider Name: "OpenAI Production"
• API Key: sk-... (jouw sleutel)
• Active: Ja
• Default Provider: Ja

Modellen:

1. Snel model voor snelle reacties

   • Modelnaam: "GPT-4o Mini (Snel & Betaalbaar)"
   • Provider Model Name: gpt-4o-mini
   • Default Temperature: 0.7
   • Tenant Default: Ja

2. Denkmodel voor complexe analyse

   • Modelnaam: "GPT-5 Search API (Geavanceerd)"
   • Provider Model Name: gpt-5-search-api-2025-10-14
   • Default Temperature: 1.0
   • Tenant Default: Nee

Voorbeeld 2: On-Premise met LM Studio

Providerconfiguratie:

• Provider Type: LM Studio
• Provider Name: "Local LM Studio"
• API Key: (leeg laten of dummywaarde gebruiken)
• Base URL: http://localhost:1234/v1
• Active: Ja
• Default Provider: Ja

Model:

• Modelnaam: "Llama 3.1 70B (Lokaal)"
• Provider Model Name: llama-3.1-70b-instruct
• Default Temperature: 0.8
• Tenant Default: Ja

Voorbeeld 3: Gemengd cloud en on-premise

Gebruik meerdere providers voor flexibiliteit:

Providers:

1. OpenAI (cloud) - voor productieomgevingen
2. LM Studio (lokaal) - voor ontwikkeling en gevoelige data

Modellen:

• Standaard: OpenAI GPT-4o Mini (productie)
• Secundair: Lokale Llama 3.1 (ontwikkeling/testen)

Gerelateerde documentatie

• Copiloten gebruiken in Investigations - Leer hoe je AI-assistenten gebruikt voor procesanalyse
• AI Teammate - Configureer en werk met je AI-teamgenoot
• Administratie-instellingen - Andere tenant-brede configuratieopties

Ondersteuning

Als je problemen ondervindt bij het configureren van AI-modellen:

• E-mail: support@mindzie.com
• Documentatie: Raadpleeg de API-documentatie van je AI-provider voor modelnamen en mogelijkheden
• Testen: Test altijd providerverbindingen en modelreacties vóór het instellen als standaard