AI Modelconfiguratie

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

Overzicht

Het AI-modelconfiguratiesysteem stelt je in staat om:

• mindzie Proxy-modellen te gebruiken: Toegang tot snelle en denkkrachtige modellen die standaard in mindzieStudio beschikbaar zijn
• Eigen Modellen te gebruiken: Verbinden met elke OpenAI-compatibele API met je eigen inloggegevens
• Cloudproviders: Gebruik OpenAI, OpenRouter, Grok, Gemini en andere grote AI-aanbieders
• On-Premise Inzet: Lokale modellen inzetten via LM Studio, Ollama of vergelijkbare platforms
• Automatische Detectie: Laat mindzieStudio automatisch de modelmogelijkheden, tokenlimieten en functies detecteren
• Meerdere Modellen: Configureer zoveel modellen als nodig zijn voor verschillende gebruikssituaties

Wanneer AI Modelconfiguratie te Gebruiken

Configureer AI-modellen wanneer je:

• Voor het eerst copilot-assistenten opzet
• Wisselt tussen verschillende AI-aanbieders op basis van kosten of prestaties
• On-premise modellen inzet voor gegevensprivacy en beveiliging
• Gespecialiseerde modellen gebruikt voor specifieke taken (snelle modellen voor snelle reacties, denkkrachtige modellen voor complexe analyse)
• API-sleutels roteert voor naleving van beveiligingsregels
• Nieuwe modellen test voordat je ze als standaard instelt

Vereisten

Voordat je AI-modellen configureert:

• Beheerdersrechten: Je moet beheerdersrechten hebben voor de instellingen van mindzieStudio
• API-sleutels: Verkrijg API-sleutels van je gekozen aanbieder (OpenAI, OpenRouter, enz.)
• Provideraccount: Maak een account aan bij je AI-aanbieder als je externe services gebruikt
• On-Premise Setup: Als je lokale modellen gebruikt, installeer en configureer LM Studio, Ollama of vergelijkbare software

Toegang tot Copilot Instellingen

Navigeer naar de copilot-instellingen via het administratiepaneel.

1. Klik op je profielicoon rechtsboven
2. Selecteer Instellingen in het dropdownmenu
3. Klik in de linker zijbalk op mindzie Copilot

Je ziet de pagina mindzie Copilot Instellingen met twee hoofdsecties:

• LLM Providers: Beheer je AI-dienstverleners
• 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 daartussen wisselen.

Stap 1: Open Dialoog Add Provider

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

Stap 2: Selecteer Type Provider

Kies uit het dropdownmenu Provider Type:

• OpenAI: Officiële OpenAI API (GPT-4, GPT-3.5, enz.)
• OpenRouter: Toegang tot meerdere modellen via OpenRouter
• Grok: xAI's Grok-modellen
• Gemini: Google's Gemini-modellen
• LM Studio: Lokale inzet via LM Studio
• Ollama: Lokale inzet via Ollama
• Other: Elke andere OpenAI-compatibele API

Opmerking: Voor bekende providers weet mindzieStudio automatisch de basis-URL. Voor lokale inzet of aangepaste providers moet je de basis-URL opgeven.

Stap 3: Configureer Provider Details

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 haal je deze uit het dashboard van je provider
• Voor lokale inzet is dit mogelijk niet vereist of kan leeg blijven

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

Base URL (optioneel): Voor aangepaste of lokale inzet

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

Stap 4: Stel de Providerstatus In

Active: Vink dit aan om de provider te activeren

• Uitschakelen zonder verwijderen kan door het vakje uit te vinken
• Handig als je tijdelijk gebruik wilt pauzeren maar je API-sleutels wilt bewaren

Set as Default Provider: Kies dit 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 ingesteld.

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

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

Stap 6: Sla de Provider Op

Klik op Create om de providerconfiguratie op te slaan.

De provider verschijnt nu in de tabel LLM Providers.

Bestaande Providers Beheren

Een Provider Bewerken

Om instellingen van een provider te wijzigen (bijvoorbeeld voor het roteren van een API-sleutel):

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

Veelvoorkomende situatie: API-sleutels moeten regelmatig worden aangepast volgens de beveiligingsregels van je IT-afdeling. Gebruik deze bewerkfunctie om sleutels bij te werken zonder de hele configuratie opnieuw te maken.

Een Provider Verwijderen

Om een provider te verwijderen:

1. Klik op het verwijdericoon (prullenbak) in de kolom Acties
2. Bevestig de verwijdering

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

Een Model Toevoegen

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

Stap 1: Open Dialoog Add Model

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

Het dialoogvenster heeft twee hoofdsecties:

• Model Configuration (links): Basisinstellingen 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 geconfigureerd.

Stap 3: Selecteer of Voer de Modelnaam In

Je hebt twee opties om het model te specificeren:

Optie A: Selecteren uit Lijst (Aanbevolen)

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

4. Na het laden zie je een lijst met beschikbare modellen

5. Klik op een model om dit 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 embedmodellen die niet werken met mindzieStudio copilots. Een ongeschikt model kiezen leidt tot fouten tijdens gebruik.

Optie B: Handmatige Invoer

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

Voorbeelden:

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

Stap 4: Configureer Model Weergavenaam

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

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

Stap 5: Stel Standaard Temperatuur In

Default Temperature: Instelbaar tussen 0 en 2

• Lage waarden (0-0.3): Meer deterministisch, gefocuste antwoorden
• Middelwaarden (0.7-1.0): Balans tussen creativiteit en consistentie
• Hoge waarden (1.0-2.0): Creatievere en meer gevarieerde antwoorden

Standaard: 1 is een goede startwaarde voor de meeste toepassingen

Stap 6: Capabilities Automatisch Detecteren

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 het systeem en configureert:
   • Tokenlimieten: Maximale context- en outputtokens
   • Modelmogelijkheden: Ondersteunde functies
   • Temperatuurondersteuning: Of 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 info:

• Max Context Tokens: 128.000 (in dit voorbeeld)
• Max Output Tokens: 16.000 (in dit voorbeeld)
• Model Capabilities: Systeemberichten (aangevinkt), Temperatuur (in dit voorbeeld niet aangevinkt)

Stap 7: Handmatige Overschrijving (Optioneel)

Je kunt de automatisch gedetecteerde capabilities handmatig aanpassen indien gewenst.

Waarschuwing: Overschrijf alleen als je zeker weet dat de automatische detectie onjuist is. Foute instellingen leiden tot fouten tijdens gebruik.

Voorbeeld:

• Temperatuur onjuist aanzetten voor een model dat dit niet ondersteunt veroorzaakt API-fouten
• Te hoge tokenlimieten instellen kan resulteren in geweigerde verzoeken

Stap 8: Stel Modelstatus In

Active: Vink aan om het model beschikbaar te maken

• Uitzetten zonder verwijderen door uitvinken

Set as Tenant Default Model: Vink aan om dit het standaardmodel te maken voor alle copilot-assistenten

• Er kan slechts één model tenant-standaard zijn
• De provider van dit model wordt dan ook standaardprovider

Stap 9: Maak het Model aan

1. Klik op Create
2. Een informatievenster bevestigt dat het model succesvol is toegevoegd

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

Inzicht in de Models Tabel

De tabel LLM Models toont:

Kolom	Beschrijving
Model Name	Door jou ingestelde weergavenaam
Provider	Welke provider dit model host
Provider Model Name	Technische modelidentificatie gebruikt door de API
Family	Modelfamilie (bijv. GPT4o, GPT5) indien van toepassing
Status	Actief of Inactief
Tenant Default	Toont "DEFAULT" als dit het tenantbrede standaardmodel is
Actions	Bewerken of verwijderen van het model

Modellen Beheren

Een Model Bewerken

1. Klik op het bewerkicoon in de kolom Acties
2. Pas de instellingen aan in het dialoogvenster Edit Model
3. Klik op Update om op te slaan

Een Ander Standaardmodel Instellen

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

De vorige standaard wordt automatisch uitgezet.

Een Model Verwijderen

1. Klik op het verwijdericoon in de kolom Acties
2. Bevestig de verwijdering

Opmerking: Je kunt geen model verwijderen dat momenteel als tenant-standaard is ingesteld. Maak eerst een ander model standaard.

Je Configuratie Testen

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

1. Ga naar een functie met copilot-ondersteuning (zoals Investigations, AI Teammate)
2. Open de copilot-interface
3. Controleer of je standaardmodel zichtbaar is in de modelkiezer
4. Verstuur een testvraag om te zien of het model correct reageert

Ondersteunde Providers

Cloudproviders

mindzieStudio ondersteunt elke OpenAI-compatibele API, waaronder:

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

On-Premise Oplossingen

Voor gegevensprivacy en beveiliging kun je modellen lokaal inzetten:

• LM Studio: Gebruiksvriendelijke lokale modelinzet
• Ollama: Lichtgewicht lokale modelserver
• vLLM: Hoge-prestatie inferentieserver
• Text Generation Inference: Hugging Face inferentieserver
• LocalAI: OpenAI-compatibele lokale inferentie

Vereisten voor On-Premise Setup:

1. Installeer de gekozen lokale inferentiesoftware
2. Download en laad het gewenste model
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

Beste Praktijken

Beveiliging API-sleutels

• Roteer Sleutels Regelmatig: Verander API-sleutels periodiek volgens je beveiligingsbeleid
• Gebruik Organisatie-ID’s: Als beschikbaar, gebruik deze om gebruik en kosten te volgen
• Beperk Sleutelrechten: Gebruik API-sleutels met alleen de minimaal vereiste rechten
• Deel Sleutels Niet: Elke gebruiker of team moet eigen credentials hebben

Modelselectie

• Snelle Modellen voor Real-time: Gebruik modellen als gpt-4o-mini voor snelle copilot-reacties
• Denkkrachtige Modellen voor Analyse: Gebruik grotere modellen zoals gpt-5-search-api voor complexe analyses
• Test Nieuwe Modellen: Test grondig voordat je ze als tenant-standaard instelt
• Volg Kosten: Houd gebruik en kosten per model bij, zeker bij dure modellen

Providerbeheer

• Houd Providers Actief: Schakel alleen uit als het echt nodig is om verwarring te voorkomen
• Beschrijvende Namen: Gebruik duidelijke namen zoals "OpenAI Production" of "Local LM Studio Dev"
• Test Verbindingen: Test altijd na toevoegen of wijzigen van providers
• Meerdere Providers: Configureer back-upproviders voor het geval je primaire provider uitvalt

Capaciteiten Configuratie

• Vertrouw op Automatische Detectie: Gebruik auto-configuratie waar mogelijk
• Raadpleeg Documentatie bij Fouten: Bij mislukte detectie, raadpleeg de modeldocumentatie in plaats van te gokken
• Controleer Tokenlimieten: Foute limieten leiden tot onverwachte afkappingen of fouten
• Werk Regelmatig Bij: Modelmogelijkheden kunnen veranderen met API-updates

Problemen Oplossen

Verbindings Test Mislukt

Als testen van de providerverbinding mislukt:

1. Controleer API-sleutel: Kopieer de sleutel direct uit je providerdashboard
2. Controleer Base URL: Zorg dat de base URL correct is en het protocol bevat (http:// of https://)
3. Netwerktoegang: Controleer of je netwerk verbinding toestaat met de provider
4. Providerstatus: Kijk of de API van provider niet down is
5. Organization ID: Verwijder deze als niet verplicht

Model Verschijnt Niet in Copilot

Als een model niet zichtbaar is bij copilots:

1. Controleer Actieve Status: Provider en model moeten op Actief staan
2. Verifieer Provider: Controleer of de provider actief is
3. Ververs Interface: Herlaad de copilot-interface
4. Controleer Toegang: Zorg dat je toegangsrechten hebt voor AI-functies

Automatische Detectie Mislukt

Als auto-configuratie niet werkt:

1. Test Eerst Provider: Zorg dat de providerverbinding geldig is
2. Controleer Modelnaam: Verifieer of de modelnaam correct is
3. API Rechten: Sommige API's vereisen speciale rechten voor capability queries
4. Handmatige Configuratie: Configureer anders handmatig volgens de documentatie

Modelfouten Tijdens Gebruik

Als een model fouten geeft:

1. Controleer Capabilities: Zorg dat de capaciteiten overeenkomen met wat het model ondersteunt
2. Check Tokenlimieten: Max context en output tokens niet te hoog instellen
3. Temperatuurinstelling: Zet uit als het model temperatuur niet ondersteunt
4. API Quota: Controleer of je limieten of quota niet hebt overschreden

Voorbeeldconfiguraties

Voorbeeld 1: OpenAI met Meerdere Modellen

Provider Configuratie:

• Provider Type: OpenAI
• Provider Naam: "OpenAI Production"
• API Key: sk-... (je echte sleutel)
• Actief: Ja
• Standaard Provider: Ja

Modellen:

1. Snel Model voor Snelle Reacties

   • Modelnaam: "GPT-4o Mini (Snel & Goedkoop)"
   • Provider Model Name: gpt-4o-mini
   • Standaard Temperatuur: 0.7
   • Tenant Standaard: Ja

2. Denkkrachtig Model voor Complexe Analyse

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

Voorbeeld 2: On-Premise met LM Studio

Provider Configuratie:

• Provider Type: LM Studio
• Provider Naam: "Local LM Studio"
• API Key: (leeg laten of dummy waarde)
• Base URL: http://localhost:1234/v1
• Actief: Ja
• Standaard Provider: Ja

Model:

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

Voorbeeld 3: Gemengd Cloud en On-Premise

Gebruik meerdere providers voor flexibiliteit:

Providers:

1. OpenAI (cloud) - voor productie workloads
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

• Copilots gebruiken in Investigations - Leer AI-assistenten gebruiken voor procesanalyse
• AI Teammate - Configureer en werk samen met je AI collega
• Beheerinstellingen - Andere tenantbrede configuratieopties

Ondersteuning

Als je problemen hebt met 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 voordat je ze als standaard instelt