Ceci est le manuel de Studio 1.0.2, une version antérieure. Le manuel de la dernière version
Documentation 1.0.2 Manuel d’utilisation
L’assistant IA
Une IA peut travailler sur le jumeau avec les mêmes outils que vous : elle prépare, écrit et vérifie des programmes et les exécute dans la simulation. Vous pouvez parler à une IA dans l’assistant propre à Studio, ou connecter un client IA tel que Claude Desktop. Tout ce qui modifierait la machine de la fenêtre attend votre accord. L’IA ne fait partie d’aucune fonction de sécurité.
Activer l’IA
L’IA est désactivée dans une nouvelle installation. Pour l’activer, faites l’une de ces choses :
- cliquez sur l’état de l’IA dans la barre du haut (IA désactivée) et choisissez Interrupteur IA de la fenêtre ;
- Outils > Paramètres… > IA et MCP : Interrupteur IA, puis OK ;
- envoyez un message dans l’assistant : cela active l’interrupteur.
Studio conserve l’interrupteur tel que vous l’avez laissé pour le prochain démarrage. Le menu IA (Assistant IA…, Activité IA…, Connecter des clients IA…) apparaît à partir du niveau Opérateur.
Quand l’interrupteur est désactivé, les clients IA peuvent encore utiliser des machines d’entraînement en arrière-plan, mais pas la machine de votre fenêtre.
Le service d’IA et sa clé
L’assistant s’adresse à un service d’IA que vous choisissez, avec votre propre compte :
- Anthropic (Claude), OpenAI, DeepSeek, Qwen (Tongyi), Kimi (Moonshot AI), Zhipu (GLM) ;
- LM Studio (local) ou Ollama (local) : un modèle sur votre propre ordinateur, sans clé ;
- Personnalisé (compatible OpenAI) : tout service doté d’une interface compatible OpenAI, à l’adresse que vous saisissez.
Pour le configurer :
- Ouvrez IA > Assistant IA…
- Choisissez le Fournisseur. Studio renseigne son URL de base.
- Collez votre clé dans Clé API et cliquez sur Enregistrer la clé. Résultat : la clé est stockée sur cet ordinateur, chiffrée. Sous Windows, seul votre compte Windows peut la lire. Sous Linux, elle va dans le trousseau du bureau (Secret Service : GNOME Keyring, KWallet) ; sans trousseau, elle est chiffrée avec une clé contenue dans un fichier que seul votre compte utilisateur peut lire, et la ligne sous la clé le dit.
- Cliquez sur Lister les modèles et choisissez un Modèle.
Studio n’écrit pas la clé dans ses paramètres, dans le registre ni dans le journal d’audit. Pour supprimer une clé enregistrée, videz le champ et cliquez sur Enregistrer la clé.
Remarque
Ce que vous envoyez au service d’IA va à ce service, sous votre compte et selon ses conditions : vos messages et, lorsque Joindre le programme, le bridage et les résultats de vérification de la fenêtre est activé, le programme, le bridage et les résultats de vérification, ainsi que les résultats des outils que l’IA utilise. Pour que tout reste sur votre ordinateur, utilisez un modèle local.
Avant votre premier message à un service cloud, l’assistant dit une fois ce qui y part. Cliquez sur Envoyer pour continuer, ou sur Utiliser un modèle local… pour passer à LM Studio ; votre message reste dans la zone de saisie. Outils > Paramètres… > IA et MCP liste les services que vous avez acceptés ; Redemander oblige l’assistant à redemander.
Le panneau de l’assistant
IA > Assistant IA… ouvre l’assistant dans une fenêtre à part.
- Saisissez votre texte dans la zone en bas. Entrée envoie ; Maj+Entrée passe à une nouvelle ligne. Arrêter interrompt la réponse.
- Joindre le programme, le bridage et les résultats de vérification de la fenêtre (s’ils ont changé) donne à l’IA, avec chaque message, ce qui se trouve dans votre fenêtre. Cette option est activée par défaut.
- La conversation montre chaque outil que l’IA utilise, avec ✓ quand il a fonctionné et ✗ quand il n’a pas fonctionné.
- Les images que l’IA produit (la pièce, la trajectoire d’outil, l’écart par rapport au modèle, une comparaison) apparaissent dans la conversation. Double-cliquez sur l’une d’elles pour l’agrandir ou l’enregistrer.
- Nouvelle conversation repart de zéro. Les conversations ne sont pas enregistrées quand vous fermez Studio.
Fermer la fenêtre ne fait que la masquer ; la conversation reste jusqu’à ce que vous quittiez.
Ce que l’IA peut et ne peut pas faire
Quand l’interrupteur est activé, l’IA peut :
- lire l’état des machines, faire la prise d’origine, déverrouiller, déplacer manuellement et envoyer des lignes de G-code ;
- mettre en place le brut, les outils, l’origine pièce et la pièce, palper et contrôler ;
- vérifier, simuler, optimiser, générer, modifier et charger des programmes, et lancer ou relancer une exécution ;
- lire les exécutions et leurs résultats, les comparer et en faire des images ;
- lire le journal d’audit et l’état de la licence.
Les outils qui relèvent d’une édition payante (contrôle, rapports, imbrication, optimiseur) ne fonctionnent que dans cette édition.
L’IA ne peut pas modifier les paramètres de Studio, la langue, les unités, le niveau utilisateur, l’interrupteur IA, la manière dont Studio vous interroge, la licence ni le journal d’audit.
Demander avant de modifier la machine
Avant que l’IA modifie la machine de la fenêtre (dans le menu de l’IA de la barre du haut et dans Outils > Paramètres… > IA et MCP) propose deux choix :
- Me demander à chaque fois (le choix par défaut) ;
- Ne pas demander (l’IA agit directement sur la fenêtre).
Quand l’IA veut modifier la machine de la fenêtre (la déplacer, la mettre sous tension, relâcher l’arrêt d’urgence, charger ou exécuter un programme, modifier le bridage ou les outils), une barre s’ouvre au-dessus de la barre machine. Elle indique quelle IA demande et ce qu’elle veut faire, et affiche un compte à rebours.
- Lisez la question.
- Cliquez sur Autoriser ou Refuser. Entrée ne répond pas : utilisez la souris, ou passez avec Tab sur une touche et appuyez sur Espace.
Sans réponse en 60 s, la demande compte comme Refuser. Un accord couvre aussi, pendant deux minutes, les demandes de suite propres à cette action.
Studio ne demande jamais avant que l’IA arrête la machine, la mette en arrêt d’avance ou la réinitialise, appuie sur l’arrêt d’urgence ou se contente de lire. Les machines d’entraînement et les copies cachées sur lesquelles l’IA simule ne donnent lieu à aucune demande.
Lecture seule sur une machine réelle
Quand le jumeau de la fenêtre suit une machine réelle (mode ombre, un aperçu dans la version 1.0 ; voir Une machine réelle), l’IA ne fait que lire et analyser. Elle ne peut pas déplacer la machine, modifier son bridage ni ses décalages d’origine, ni y exécuter des programmes, et elle ne demande pas : Studio refuse ces demandes. Les machines d’entraînement fonctionnent comme avant.
Activité IA
IA > Activité IA… montre ce que font les clients IA sur cet ordinateur :
- Machines en arrière-plan : les machines d’entraînement que l’IA utilise, que vous ne voyez pas dans la fenêtre (« window » est la machine de votre fenêtre) ;
- Exécutions : les 16 dernières simulations et optimisations ;
- Clients IA connectés : qui est connecté, comment, et son dernier appel.
D’ici, vous pouvez arrêter une exécution, regarder l’image d’une exécution, fermer une machine en arrière-plan, et arrêter ou démarrer l’hôte des jumeaux. L’hôte des jumeaux est le programme d’arrière-plan qui contient les machines d’entraînement. Il démarre quand un client IA se connecte et s’arrête au bout de 30 minutes d’inactivité.
L’onglet Activité IA du panneau inférieur liste les appels de l’IA sur la machine de la fenêtre : heure, appel, machine, qui et résultat.
Connecter d’autres clients IA (MCP)
Les clients IA qui parlent MCP (Model Context Protocol) peuvent utiliser les outils de Studio.
- Ouvrez IA > Connecter des clients IA…
- Cliquez sur votre client : Claude Desktop, Application de bureau ChatGPT (modes Codex et Work), Cursor, VS Code (GitHub Copilot) ou LM Studio (modèles ouverts en local). Résultat : pour Claude Desktop et l’application de bureau ChatGPT, Studio montre la modification qu’il va apporter aux paramètres du client et l’effectue quand vous cliquez sur OK ; il conserve l’ancien fichier du client à côté. Les autres ouvrent leur propre page d’installation.
- Quittez complètement le client et rouvrez-le.
- Activez l’Interrupteur IA de la fenêtre dans Studio.
Pour tout autre client, Autres clients : copier la configuration copie les paramètres à y coller. Le client lance TwinwrightStudio.exe --mcp en arrière-plan ; La commande et la configuration montre la commande exacte.
Clients qui n’acceptent qu’une adresse
Pour les clients qui n’acceptent qu’une adresse, activez URL locale (HTTP, pour les clients qui n’acceptent qu’une URL) dans le menu de l’IA et utilisez Copier l’URL locale (HTTP). L’adresse ne fonctionne que sur cet ordinateur et demande le jeton qui l’accompagne. Nouveau jeton fait cesser de fonctionner l’ancien.
Les outils, leurs arguments et leurs résultats : Outils MCP.
Ce qui est enregistré
Outils > Journal d’audit… (Ctrl+L) enregistre ce que fait l’IA, avec le nom de l’IA dans la colonne Qui. Filtrez Qui sur IA pour ne voir que les enregistrements de l’IA ; double-cliquez sur un appel pour voir tous ses enregistrements ensemble.
Au niveau par défaut Standard, le journal conserve :
- l’activation et la désactivation de l’interrupteur IA, et les changements de la manière dont Studio demande ;
- chaque question, votre réponse et chaque action de l’IA sur la machine de la fenêtre ;
- chaque appel d’outil, avec une forme abrégée de ses arguments ;
- la connexion et la déconnexion des clients ;
- les messages de l’assistant : les 180 premiers octets dans le résumé, jusqu’à 2 000 octets dans l’enregistrement.
Les clés, les jetons et les mots de passe sont inscrits sous la forme ***.