KI & Intelligenz

BlockWerk verfügt über einen leistungsfähigen KI-Assistenten, der Sie beim Erstellen, Analysieren und Beheben von Fehlern in Ihren Simulationsdiagrammen unterstützt. Standardmäßig verwendet die Anwendung einen integrierten Proxy, um grundlegende KI-Funktionen bereitzustellen. Für die beste Leistung und höchste Privatsphäre empfehlen wir jedoch die Nutzung Ihres eigenen KI-Anbieters („Bring Your Own AI“).

Warum „Bring Your Own AI“ (BYOAI)?

• Vollständige Kontrolle: Wechseln Sie nahtlos zwischen direkter KI-Interaktion, Web-KI (ChatGPT/Claude) und externen MCP-Tools.
• Datenschutz: Bei Verwendung eines eigenen API-Schlüssels (BYOK) oder eines lokalen Modells werden Ihre Daten direkt vom Browser an den KI-Anbieter übertragen. Es sind keine Zwischenserver beteiligt.
• Bessere Modelle: Nutzen Sie Spitzenmodelle wie Gemini 1.5 Pro, GPT-4o oder Claude 3.5 Sonnet direkt.

Der Bridge Selector: Wählen Sie Ihren Workflow

Oben im KI-Assistenten-Bedienfeld befindet sich der Bridge Selector. Dieser legt fest, wie BlockWerk mit KI-Modellen kommuniziert:

1. Direct AI (Empfohlen)

Die KI interagiert direkt mit der Simulations-Engine. Dies ist der schnellste Weg zum Erstellen oder Ändern von Diagrammen.

• Proxy Mode: Nutzen Sie unseren kostenlosen Gemini-Proxy (keine Einrichtung erforderlich).
• BYOK Mode: Fügen Sie Ihren eigenen API-Schlüssel für maximale Geschwindigkeit und Privatsphäre hinzu.

2. Web AI (Blueprint Mode)

Wenn Sie die Weboberfläche von ChatGPT, Claude.ai oder Gemini bevorzugen:

1. Klicken Sie auf Copy Context for Web AI. Alle aktuellen Diagramminformationen werden in Ihre Zwischenablage kopiert.
2. Fügen Sie diesen Text in den Chat Ihrer KI ein und fordern Sie eine Änderung an.
3. Wenn die KI einen JSON-Codeblock liefert, kopieren Sie ihn, fügen Sie ihn in den Reiter „Web AI“ ein und klicken Sie auf Apply Blueprint.

3. AI Bridge (MCP)

Lassen Sie eine externe KI dieses Canvas steuern — sei es ein Web-Chat wie ChatGPT, Claude.ai oder Mistral, oder ein Desktop-Tool wie Claude Desktop oder Cursor.

1. Klicken Sie im KI-Bedienfeld auf Connect AI.
2. Wählen Sie, wo Ihre KI läuft: In a web chat oder On my computer.
3. Klicken Sie auf Copy link (Web-Chat) oder Copy config (Desktop). Dieser Klick öffnet auch direkt die Verbindung — es gibt keine separate Start-Schaltfläche.
4. Fügen Sie die Konfiguration ein:

- Web-Chat: Als benutzerdefinierten/Remote-MCP-Connector. Bei claude.ai unter Einstellungen → Connectors → Add custom connector; lassen Sie die OAuth-Felder leer.

- Desktop: In die Konfigurationsdatei, die im Bedienfeld angegeben ist, und starten Sie das Tool neu.

1. Das Bedienfeld zeigt „Waiting for your AI to connect…“ an und wechselt, sobald der erste Befehl eingeht, wobei die letzten Aufrufe aufgelistet werden.

Wissenswertes:

• Die Verbindung ist an diesen Tab gebunden. Schließen Sie den Tab, geht die Verbindung verloren; verbinden Sie sich im neuen Tab erneut (oder nutzen Sie „Already set up? Open the connection“).
• Der Link enthält ein Device Token, das Zugriff auf Ihr Canvas gewährt, solange der Tab geöffnet ist. Teilen Sie ihn nicht und zeigen Sie ihn nicht auf Screenshots. Falls er kompromittiert wird, widerruft die ⟳-Schaltfläche neben „Copy“ das Token und erzeugt ein neues.
• Die Session ID unter Advanced ist kein Kopplungscode — sie ist der Verschlüsselungsschlüssel dieses Tabs. Fügen Sie sie niemals in einen Chat ein; die Kopplung erfolgt immer über den obigen Link.
• Destruktive Aktionen (Canvas leeren, Blöcke löschen) erfordern zunächst Ihre Bestätigung im Tab. Die KI wartet, bis Sie zustimmen.

Kostenlosen Gemini-API-Schlüssel erhalten (Empfohlen)

Googles Gemini bietet derzeit ein großzügiges kostenloses Kontingent für Entwickler über Google AI Studio, das sich ideal für BlockWerk eignet.

1. Besuchen Sie die Google AI Studio API Key Seite.
2. Melden Sie sich mit Ihrem Google-Konto an.
3. Klicken Sie auf Create API key.
4. Kopieren Sie den generierten Schlüssel.
5. Gehen Sie in BlockWerk zu Einstellungen > KI & Intelligenz.
6. Wählen Sie Gemini als Anbieter aus und fügen Sie Ihren Schlüssel ein.

KI lokal ausführen (Privat & kostenlos)

Wenn Sie über einen leistungsstarken Rechner verfügen, können Sie KI-Modelle lokal ausführen. Dies ist 100 % privat und kostenlos.

Mit Ollama

1. Laden Sie Ollama herunter und installieren Sie es.
2. Starten Sie ein Modell im Terminal: ollama run llama3 (oder mistral, gemma).
3. Wählen Sie in BlockWerk Ollama als Anbieter aus.
4. Stellen Sie sicher, dass die Custom URL auf http://localhost:11434 gesetzt ist.

Mit LM Studio

1. Laden Sie LM Studio herunter und installieren Sie es.
2. Laden Sie ein Modell herunter und starten Sie den Local Server.
3. Wählen Sie in BlockWerk LM Studio aus.
4. Setzen Sie die Custom URL auf http://localhost:1234.

Weitere kostenlose Anbieter (BYOAI)

Neben Gemini können Sie auch andere Anbieter nutzen, die kostenlose Tarife für Entwickler anbieten.

Groq (Superschnell & Llama 3)

1. Rufen Sie die Groq Cloud Console auf.
2. Erstellen Sie einen kostenlosen API-Schlüssel.
3. Wählen Sie in BlockWerk Groq aus.
4. Geben Sie Ihren Schlüssel ein und wählen Sie eine Modell-ID (z. B. llama3-70b-8192).

OpenRouter (Universeller Zugriff)

OpenRouter bietet eine universelle API für Hunderte von KI-Modellen, darunter viele kostenlose Varianten.

1. Rufen Sie OpenRouter auf.
2. Erstellen Sie einen API-Schlüssel.
3. Wählen Sie in BlockWerk OpenRouter aus und geben Sie Ihren Schlüssel ein.
4. Geben Sie eine Modell-ID an (z. B. google/gemini-pro-1.5 oder meta-llama/llama-3-8b-instruct:free).

Hugging Face (Serverless Inference)

Hugging Face bietet Tausende kostenloser Open-Source-Modelle über seine Serverless-API an.

1. Rufen Sie Ihre Hugging Face Einstellungen auf.
2. Erstellen Sie ein Access Token (Leseberechtigung / read).
3. Wählen Sie in BlockWerk Hugging Face aus und fügen Sie Ihr Token ein.
4. Geben Sie die Modell-ID des gewünschten Modells an (z. B. mistralai/Mistral-7B-v0.1).

Fehlerbehebung

• CORS-Fehler: Manche lokalen Konfigurationen blockieren Browser-Anfragen. Bei Ollama müssen Sie eventuell die Umgebungsvariable OLLAMA_ORIGINS="*" vor dem Start des Dienstes setzen.
• Ungültiger Schlüssel: Achten Sie darauf, dass beim Einfügen Ihres API-Schlüssels keine überflüssigen Leerzeichen vorhanden sind.
• Modell nicht gefunden: Stellen Sie bei lokalen Modellen sicher, dass das Modell tatsächlich geladen und der lokale Server aktiv ist.

Siehe auch

• AIAssistant: Erfahren Sie, wie Sie den Assistenten zum Erstellen von Diagrammen einsetzen.
• Tastenkombinationen: Öffnen Sie das KI-Bedienfeld schnell mit Strg+Umschalt+A.