AI & Intelligentie

BlockWerk beschikt over een krachtige AI-assistent die je helpt bij het bouwen, analyseren en oplossen van problemen in je simulatie-diagrammen. Standaard gebruikt de app een ingebouwde proxy om basis-AI-functionaliteit te bieden. Voor de beste en meest privacyvriendelijke ervaring raden we echter aan om je eigen AI-provider te gebruiken ("Bring Your Own AI").

Waarom "Bring Your Own AI" (BYOAI)?

• Volledige controle: Schakel moeiteloos tussen directe AI, Web AI (ChatGPT/Claude) of externe tools via MCP.
• Privacy: Wanneer je je eigen sleutel (BYOK) of een lokaal model gebruikt, worden je gegevens rechtstreeks van je browser naar de AI-provider verzonden. Er zijn geen tussenliggende servers betrokken.
• Betere Modellen: Gebruik de allernieuwste modellen zoals Gemini 1.5 Pro, GPT-4o, of Claude 3.5 Sonnet rechtstreeks in BlockWerk.

De Bridge Selector: Kies je Workflow

Bovenin het AI-paneel vind je de Bridge Selector. Hiermee bepaal je hoe BlockWerk communiceert met de AI:

1. Direct AI (Aanbevolen)

De AI spreekt rechtstreeks met de simulatie-engine. Dit is de snelste manier om diagrammen te bouwen of te wijzigen.

• Proxy Mode: Gebruik onze gratis Gemini-proxy (geen setup nodig).
• BYOK Mode: Gebruik je eigen API-key voor maximale snelheid en privacy.

2. Web AI (Blueprint Mode)

Gebruik je liever de webinterface van ChatGPT, Claude.ai of Gemini?

1. Klik op Copy Context for Web AI. Alle informatie over je huidige diagram staat nu op je klembord.
2. Plak dit in de chat van je favoriete AI en vraag om een wijziging.
3. Krijg je een JSON-codeblok terug? Kopieer dat, plak het in het veld bij de Web AI tab en klik op Apply Blueprint.

3. AI Bridge (MCP)

Laat een externe AI dit canvas besturen — een webchat zoals ChatGPT, Claude.ai of

Mistral, of een desktop-tool zoals Claude Desktop of Cursor.

1. Klik in het AI-paneel op Koppel AI.
2. Kies waar je AI draait: In a web chat of On my computer.
3. Klik op Copy link (webchat) of Copy config (desktop). Die klik opent meteen ook de

verbinding — er is geen aparte startknop.

1. Plak het:

- Webchat: als custom / remote MCP connector. Bij claude.ai is dat

Instellingen → Connectors → Add custom connector; laat de OAuth-velden leeg.

- Desktop: in het configuratiebestand dat het paneel noemt, en herstart de tool.

1. Het paneel toont "Waiting for your AI to connect…" en slaat om zodra de eerste

opdracht binnenkomt, met de laatste aanroepen erbij.

Belangrijk om te weten:

• De verbinding hangt aan deze tab. Sluit je hem, dan stopt de koppeling en moet je in de

nieuwe tab opnieuw koppelen (of "Already set up? Open the connection" gebruiken).

• De link bevat een device-token: dat geeft toegang tot je canvas zolang de tab openstaat.

Deel hem niet en zet hem niet in een screenshot. Kwijt of gelekt? De ⟳-knop naast Copy trekt

hem in en maakt een nieuwe aan.

• Het Session ID onder Advanced is géén koppelcode maar de encryptiesleutel van deze tab.

Plak dat nooit in een chat — koppelen gaat altijd via de link hierboven.

• Destructieve acties (canvas wissen, blok verwijderen) vragen eerst om je goedkeuring in de tab.

De AI wacht tot je klikt.

Een Gratis Gemini API Key Verkrijgen (Aanbevolen)

Google's Gemini biedt momenteel een royaal gratis pakket voor ontwikkelaars via AI Studio, wat perfect samengaat met BlockWerk.

1. Ga naar de Google AI Studio API Key Pagina.
2. Log in met je Google-account.
3. Klik op Create API key.
4. Kopieer de gegenereerde sleutel.
5. Ga in BlockWerk naar Instellingen > AI & Intelligentie.
6. Selecteer Gemini als provider en plak je sleutel.

AI Lokaal Draaien (Privé & Gratis)

Als je een krachtige computer hebt, kun je AI-modellen lokaal draaien. Dit is 100% privé en gratis.

Gebruik van Ollama

1. Download en installeer Ollama.
2. Draai een model in je terminal: ollama run llama3 (of mistral, gemma).
3. Selecteer in BlockWerk Ollama als je provider.
4. Zorg dat de Custom URL is ingesteld op http://localhost:11434.

Gebruik van LM Studio

1. Installeer LM Studio.
2. Download een model en start de Local Server.
3. Selecteer in BlockWerk LM Studio.
4. Stel de Custom URL in op http://localhost:1234.

Andere Gratis Providers (BYOAI)

Naast Gemini kun je ook andere providers gebruiken die een gratis instapniveau bieden voor ontwikkelaars.

Groq (Supersnel & Llama 3)

1. Ga naar de Groq Cloud Console.
2. Maak een gratis API-sleutel aan.
3. Selecteer Groq in BlockWerk.
4. Vul je sleutel in en kies een model-ID (bijv. llama3-70b-8192).

OpenRouter (Toegang tot alle modellen)

OpenRouter biedt een universele API voor honderden AI-modellen, waaronder vele gratis varianten.

1. Ga naar OpenRouter.
2. Maak een sleutel aan.
3. Selecteer OpenRouter in BlockWerk en vul je API-sleutel in.
4. Geef een Model ID op (bijv: google/gemini-pro-1.5 of meta-llama/llama-3-8b-instruct:free).

Hugging Face (Serverless Inference)

Hugging Face biedt duizenden gratis open-source modellen via hun Serverless API.

1. Ga naar je Hugging Face Settings.
2. Maak een Access Token (read) aan.
3. Selecteer Hugging Face in BlockWerk en plak je token.
4. Geef het Model ID op van het model dat je wilt gebruiken (bijv: mistralai/Mistral-7B-v0.1).

Probleemoplossing

• CORS Fouten: Sommige lokale configuraties kunnen browserverzoeken blokkeren. Voor Ollama moet je mogelijk de omgevingsvariabele OLLAMA_ORIGINS="*" instellen voordat je de service start.
• Ongeldige Sleutel: Zorg dat er geen extra spaties achter de API-key staan bij het plakken.
• Model niet Gevonden: Controleer of het model daadwerkelijk draait en of de server actief is.

Zie Ook

• AIAssistent: Leer hoe je de assistent gebruikt voor het bouwen van diagrammen.
• Sneltoetsen: Open het AI-paneel snel met Ctrl+Shift+A.