Dies ist das Handbuch zu Studio 1.1.0, einer früheren Version. Das Handbuch der neuesten Version

Dokumentation 1.1.0 Benutzerhandbuch

Der KI-Assistent

Eine KI kann mit denselben Tools am Zwilling arbeiten wie Sie: Sie richtet ein, schreibt und prüft Programme und lässt sie in der Simulation laufen. Sie können sich mit einer KI im eigenen Assistenten von Studio unterhalten oder einen KI-Client wie Claude Desktop verbinden. Alles, was die Maschine im Fenster verändern würde, wartet auf Ihr Ja. Die KI ist nicht Teil einer Sicherheitsfunktion.

Die KI einschalten

In einer neuen Installation ist die KI aus. Um sie einzuschalten, wählen Sie einen dieser Wege:

  • Klicken Sie in der oberen Leiste auf den Zustand der KI (KI aus) und wählen Sie KI-Schalter des Fensters;
  • Extras > Einstellungen… > KI und MCP: KI-Schalter, dann OK;
  • senden Sie eine Nachricht im Assistenten: Damit wird der Schalter eingeschaltet.

Studio behält den Schalter für den nächsten Start so bei, wie Sie ihn verlassen. Das Menü KI (KI-Assistent…, KI-Aktivität…, KI-Clients verbinden…) wird ab der Stufe Bediener angezeigt.

Bei ausgeschaltetem Schalter können KI-Clients weiterhin Übungsmaschinen im Hintergrund verwenden, aber nicht die Maschine in Ihrem Fenster.

Der KI-Dienst und sein Schlüssel

Der Assistent spricht mit einem KI-Dienst Ihrer Wahl, mit Ihrem eigenen Konto:

  • Anthropic (Claude), OpenAI, DeepSeek, Qwen (Tongyi), Kimi (Moonshot AI), Zhipu (GLM);
  • LM Studio (lokal) oder Ollama (lokal): ein Modell auf Ihrem eigenen Computer, kein Schlüssel nötig;
  • Benutzerdefiniert (OpenAI-kompatibel): jeder Dienst mit einer OpenAI-kompatiblen Schnittstelle, unter der Adresse, die Sie eingeben.

So richten Sie ihn ein:

  1. Öffnen Sie KI > KI-Assistent…
  2. Wählen Sie den Anbieter. Studio trägt dessen Basis-URL ein.
  3. Fügen Sie Ihren Schlüssel in API-Schlüssel ein und klicken Sie auf Schlüssel speichern. Ergebnis: Der Schlüssel wird verschlüsselt auf diesem Computer gespeichert. Unter Windows kann ihn nur Ihr Windows-Konto lesen. Unter Linux kommt er in den Schlüsselbund des Desktops (Secret Service: GNOME Keyring, KWallet); ohne ihn wird er mit einem Schlüssel in einer Datei verschlüsselt, die nur Ihr Benutzerkonto lesen kann, und die Zeile unter dem Schlüssel sagt das.
  4. Klicken Sie auf Modelle auflisten und wählen Sie ein Modell.

Studio schreibt den Schlüssel weder in seine Einstellungen noch in die Registrierungsdatenbank noch in das Prüfprotokoll. Um einen gespeicherten Schlüssel zu löschen, leeren Sie das Feld und klicken Sie auf Schlüssel speichern.

Hinweis

Was Sie an den KI-Dienst senden, geht unter Ihrem Konto und nach dessen Bedingungen an diesen Dienst: Ihre Nachrichten und, bei eingeschaltetem Programm, Aufspannung und Prüfergebnisse des Fensters anhängen, das Programm, die Aufspannung und die Prüfergebnisse sowie die Ergebnisse der Tools, die die KI verwendet. Um alles auf Ihrem Computer zu behalten, verwenden Sie ein lokales Modell.

Vor Ihrer ersten Nachricht an einen Cloud-Dienst sagt der Assistent einmal, was dorthin geht. Klicken Sie auf Senden, um fortzufahren, oder auf Lokales Modell verwenden…, um zu LM Studio zu wechseln; Ihre Nachricht bleibt im Feld. Extras > Einstellungen… > KI und MCP listet die Dienste auf, denen Sie zugestimmt haben; Erneut fragen lässt den Assistenten erneut fragen.

Das Assistenten-Panel

KI > KI-Assistent… öffnet den Assistenten in einem eigenen Fenster.

  • Tippen Sie in das Feld unten. Die Eingabetaste sendet; Umschalt+Eingabetaste beginnt eine neue Zeile. Stopp hält die Antwort an.
  • Programm, Aufspannung und Prüfergebnisse des Fensters anhängen (wenn geändert) gibt der KI mit jeder Nachricht, was in Ihrem Fenster ist. Es ist standardmäßig eingeschaltet.
  • Die Unterhaltung zeigt jedes Tool, das die KI verwendet, mit ✓, wenn es funktioniert hat, und ✗, wenn nicht.
  • Bilder, die die KI erzeugt (das Werkstück, die Werkzeugbahn, die Abweichung vom Teil, ein Vergleich), erscheinen in der Unterhaltung. Doppelklicken Sie auf eines, um es zu vergrößern oder zu speichern.
  • Neue Unterhaltung beginnt neu. Unterhaltungen werden nicht gespeichert, wenn Sie Studio schließen.

Das Schließen des Fensters blendet es nur aus; die Unterhaltung bleibt bestehen, bis Sie Studio beenden.

Was die KI kann und was nicht

Bei eingeschaltetem Schalter kann die KI:

  • den Zustand der Maschinen lesen sowie referenzieren, entsperren, im Tippbetrieb verfahren und G-Code-Sätze senden;
  • das Rohteil, die Werkzeuge, den Werkstücknullpunkt und das Teil einrichten, antasten und prüfen;
  • Programme prüfen, simulieren, optimieren, generieren, bearbeiten und laden sowie einen Lauf starten oder neu starten;
  • Läufe und ihre Ergebnisse lesen, vergleichen und Bilder davon erzeugen;
  • das Prüfprotokoll und den Zustand der Lizenz lesen.

Tools, die zu einer kostenpflichtigen Edition gehören (Prüfung, Berichte, Verschachtelung, der Optimierer), funktionieren nur in dieser Edition.

Die KI kann die Einstellungen von Studio, die Sprache, die Einheiten, die Benutzerstufe, den KI-Schalter, die Art, wie Studio Sie fragt, die Lizenz oder das Prüfprotokoll nicht ändern.

Nachfragen, bevor sie die Maschine ändert

Bevor die KI die Maschine im Fenster ändert (im Menü der KI in der oberen Leiste und in Extras > Einstellungen… > KI und MCP) hat zwei Möglichkeiten:

  • Jedes Mal fragen (die Standardeinstellung);
  • Nicht fragen (die KI bedient das Fenster direkt).

Wenn die KI die Maschine im Fenster ändern will (sie bewegen, einschalten, den Not-Halt entriegeln, ein Programm laden oder ausführen, die Aufspannung oder die Werkzeuge ändern), öffnet sich eine Leiste über der Maschinenleiste. Sie sagt, welche KI fragt und was sie tun will, und zählt herunter.

  1. Lesen Sie die Frage.
  2. Klicken Sie auf Erlauben oder Ablehnen. Die Eingabetaste antwortet nicht: Verwenden Sie die Maus oder wechseln Sie mit Tab zu einer Taste und drücken Sie die Leertaste.

Keine Antwort innerhalb von 60 s zählt als Ablehnen. Ein Ja gilt zwei Minuten lang auch für die eigenen Folgeanfragen dieser Aktion.

Studio fragt nie nach, wenn die KI die Maschine stoppt, anhält oder zurücksetzt, den Not-Halt drückt oder nur liest. Bei Übungsmaschinen und den verborgenen Kopien, auf denen die KI simuliert, wird nicht nachgefragt.

Nur lesen an einer realen Maschine

Wenn der Zwilling im Fenster einer realen Maschine folgt (Schattenmodus, in 1.0 eine Vorschau; siehe Eine reale Maschine), liest und analysiert die KI nur. Sie kann die Maschine dort nicht bewegen, weder ihre Aufspannung noch ihre Nullpunktverschiebungen ändern noch Programme ausführen, und sie fragt nicht: Studio lehnt diese Anfragen ab. Übungsmaschinen arbeiten wie zuvor.

KI-Aktivität

KI > KI-Aktivität… zeigt, was KI-Clients auf diesem Computer tun:

  • Hintergrundmaschinen: die Übungsmaschinen, die die KI verwendet und die Sie im Fenster nicht sehen („Fenster“ ist die Maschine in Ihrem Fenster);
  • Läufe: die letzten 16 Simulationen und Optimierungen;
  • Verbundene KI-Clients: wer verbunden ist, wie, und ihr letzter Aufruf.

Von hier aus können Sie einen Lauf stoppen, das Bild eines Laufs ansehen, eine Hintergrundmaschine schließen und den Zwillings-Host stoppen oder starten. Der Zwillings-Host ist das Hintergrundprogramm, das die Übungsmaschinen enthält. Er startet, wenn sich ein KI-Client verbindet, und beendet sich nach 30 Minuten ohne Nutzung.

Der Reiter KI-Aktivität des Docks listet die Aufrufe der KI an der Maschine im Fenster auf: Zeit, Aufruf, Maschine, Wer und Ergebnis.

Andere KI-Clients verbinden (MCP)

KI-Clients, die MCP (Model Context Protocol) sprechen, können die Tools von Studio verwenden.

  1. Öffnen Sie KI > KI-Clients verbinden…
  2. Klicken Sie auf Ihren Client: Claude Desktop, ChatGPT Desktop (Modi Codex und Work), Cursor, VS Code (GitHub Copilot) oder LM Studio (lokale offene Modelle). Ergebnis: Für Claude Desktop und ChatGPT Desktop zeigt Studio die Änderung, die es an den Einstellungen des Clients vornehmen wird, und führt sie aus, wenn Sie auf OK klicken; die alte Datei des Clients bleibt daneben erhalten. Die anderen öffnen ihre eigene Installationsseite.
  3. Beenden Sie den Client vollständig und öffnen Sie ihn erneut.
  4. Schalten Sie in Studio den KI-Schalter des Fensters ein.

Für jeden anderen Client kopiert Andere Clients: Konfiguration kopieren die Einstellungen zum Einfügen in den Client. Der Client startet TwinwrightStudio.exe --mcp im Hintergrund; Befehl und Konfiguration zeigt den genauen Befehl.

Clients, die nur eine Adresse annehmen

Für Clients, die nur eine Adresse annehmen, schalten Sie im Menü der KI Lokale URL (HTTP, für Clients, die nur eine URL annehmen) ein und verwenden Sie Lokale URL (HTTP) kopieren. Die Adresse funktioniert nur auf diesem Computer und braucht das Token, das dazugehört. Neues Token macht das alte Token ungültig.

Die Tools, ihre Argumente und ihre Ergebnisse: MCP-Tools.

Was aufgezeichnet wird

Extras > Prüfprotokoll… (Strg+L) zeichnet auf, was die KI tut, mit dem Namen der KI in der Spalte Wer. Filtern Sie Wer nach KI, um nur die Einträge der KI zu sehen; doppelklicken Sie auf einen Aufruf, um alle seine Einträge zusammen zu sehen.

Auf der voreingestellten Stufe Standard hält das Prüfprotokoll fest:

  • das Ein- und Ausschalten des KI-Schalters und das Ändern der Art, wie Studio fragt;
  • jede Frage, Ihre Antwort und jede Aktion der KI an der Maschine im Fenster;
  • jeden Tool-Aufruf mit einer Kurzform seiner Argumente;
  • das Verbinden und Trennen von Clients;
  • die Nachrichten des Assistenten: die ersten 180 Bytes in der Zusammenfassung, bis zu 2.000 Bytes im Eintrag.

Schlüssel, Token und Passwörter werden als *** geschrieben.