Naar hoofdinhoud gaan

Een AI-provider koppelen

Doel​

Het platform eenmalig, voor de hele organisatie, naar een AI-model laten wijzen — zodat de knop AI in elke ontwerper een ontwerp genereert uit één zin, en de assistent op het startscherm vragen kan beantwoorden en dingen voor je kan bouwen.

Vereisten​

  • Je bent als platformbeheerder aangemeld bij het Beheercentrum.
  • Je hebt een account bij een AI-provider en een API-sleutel daarvan — of een model dat op een eigen server draait (Ollama, LM Studio) en geen sleutel nodig heeft.

Stappen​

  1. Open Instellingen — het tandwiel in de bovenbalk, op elk scherm — en kies het tabblad AI. Als er nog niets is ingesteld, opent het tabblad op Anthropic met het model claude-opus-5 al ingevuld — koppelen met Claude is dan alleen stap 4 en 5.
  2. Kies de Provider:
    • Anthropic voor Claude. Er is één eindpunt, dus er wordt niet om een basisadres gevraagd, en het aanbevolen model wordt voor je ingevuld.
    • OpenAI-compatibel voor OpenAI zelf, OpenRouter, Ollama, LM Studio en alles wat hetzelfde /chat/completions-contract spreekt. Vul dan de API-basis-URL in — de basis, niet het volledige eindpunt: https://api.openai.com/v1 (voor je ingevuld), https://openrouter.ai/api/v1 of http://localhost:11434/v1.
  3. Controleer het Model — typ het precies zoals de provider het spelt: claude-opus-5, gpt-4o, llama3.1. Wisselen van provider vult het standaardmodel van die provider in, maar vervangt nooit een model dat je zelf hebt getypt. Laat je het leeg, dan staat AI voor je organisatie uit.
  4. Plak de API-sleutel. Laat het leeg voor een lokale server die er geen nodig heeft. Voor Claude: zie Een API-sleutel van Anthropic krijgen hieronder.
  5. Opslaan, daarna Verbinding testen. De test doet één kleine aanroep met wat je hebt opgeslagen en toont het eigen antwoord van het model, dus een groen resultaat betekent dat de provider echt heeft geantwoord.

Een API-sleutel van Anthropic krijgen (Claude)​

Een API-sleutel is niet hetzelfde als een claude.ai-abonnement. Aanmelden bij claude.ai geeft een persoon een chat; het platform heeft een sleutel nodig uit de Claude Console, een apart ontwikkelaarsaccount op basis van gebruik dat de organisatie factureert voor wat haar gebruikers genereren.

  1. Ga naar platform.claude.com en meld je aan, of maak een account aan. Heeft je bedrijf al een Console-organisatie, vraag dan de beheerder daarvan om je uit te nodigen in plaats van een tweede aan te maken — de sleutel moet horen bij de organisatie die betaalt.
  2. Voeg facturering toe onder Settings → Billing. Een nieuw account moet een betaalmethode of vooruitbetaald tegoed hebben voordat zijn sleutels antwoorden; een sleutel zonder tegoed laat de verbindingstest mislukken met een factureringsfout, niet met een authenticatiefout.
  3. Open Settings → API keys (platform.claude.com/settings/keys) en druk op Create key. Geef hem een naam die zegt waar hij wordt gebruikt — Parsware platform — kies een vervaldatum en stel het Linked account in: geef voor een gedeeld platform de voorkeur aan een service account key boven een persoonlijke sleutel, omdat een persoonlijke sleutel ophoudt te werken op de dag dat de eigenaar de organisatie verlaat.
  4. Kopieer de sleutel meteen. Hij begint met sk-ant- en de Console toont hem precies één keer volledig, bij het aanmaken; raak je hem kwijt, maak dan een nieuwe aan in plaats van hem te zoeken.
  5. Plak hem terug in het platform in API-sleutel, klik op Opslaan en op Verbinding testen.

Bewaar de sleutel op één plek. Het platform slaat hem op de server op en stuurt hem nooit terug naar een browser; bewaar hem niet ook nog in een document of een chat. Lekt hij ooit uit, trek hem dan in op dezelfde Console-pagina en plak hier een nieuwe — verder hoeft er niets te veranderen.

Wat er achter de schermen gebeurt​

De sleutel komt nooit terug in de browser. Na het opslaan toont het tabblad alleen dat er een sleutel is opgeslagen, en de laatste vier tekens ervan. Een leeg sleutelvak bij een latere opslag betekent behoud de opgeslagen sleutel; om hem te verwijderen gebruik je De opgeslagen sleutel verwijderen en sla je op.

De instellingen zijn van je organisatie, niet van ieder persoonlijk. Iedereen in de organisatie genereert met hetzelfde model, en de kosten komen op hetzelfde account terecht. Voordat dit tabblad bestond, werd de provider ingesteld door degene die het platform installeerde, in de configuratie ervan; die waarden zijn nog steeds de terugval en worden hier als uitgangspunt getoond tot je je eigen waarden opslaat — de regel bovenaan het tabblad zegt welke van kracht is.

De twee limieten zijn er voor op hol geslagen antwoorden. Langste antwoord begrenst één antwoord in tokens; Opgeven na is hoe lang één aanroep mag duren voordat het platform stopt met wachten. De standaardwaarden passen bij het genereren van een proces of een rapport; verhoog ze alleen als een test zegt dat een antwoord werd afgekapt.

Waar het wordt gebruikt​

  • De knop AI in de proces-, rapport-, dashboard- en Studio-ontwerpers — beschrijf wat je wilt en er wordt een ontwerp gegenereerd, gecontroleerd tegen het eigen schema van het ontwerp, en op het canvas geladen.
  • De assistent op het startscherm, die kan lezen wat er in de omgeving staat en, als je dat toestaat, tabellen, apps en complete oplossingen kan bouwen.