ドキュメントユーザーマニュアル

AIアシスタント

AI は、Studio で使えるのと同じツールを使ってツインを操作できます。段取りを設定し、プログラムを作成・検査して、シミュレーションで実行します。Studio 自身のアシスタントで AI と会話することも、Claude Desktop などの AIクライアントを接続することもできます。ウィンドウの機械を変更することになる操作は、許可を待ってから実行されます。AI は、どの安全機能にも含まれません。

AI をオンにする

新規インストールでは、AI はオフです。オンにするには、次のいずれかを行います。

トップバーの AI の状態（AIオフ）をクリックし、ウィンドウの AIスイッチ を選びます。
ツール > 設定… > AI と MCP で AIスイッチ をオンにし、OK をクリックします。
アシスタントでメッセージを送信します。これでスイッチがオンになります。

Studio は、スイッチを最後に設定した状態のまま、次回の起動に引き継ぎます。AI メニュー（AIアシスタント…、AIアクティビティ…、AIクライアントを接続…）は、オペレータレベル以上で表示されます。

スイッチがオフでも、AIクライアントは、バックグラウンドで練習用の機械を使えます。ただし、ウィンドウの機械は使えません。

AIサービスとそのキー

アシスタントは、ご自身のアカウントを使って、選択した AIサービスと通信します。選べるサービスは次のとおりです。

Anthropic (Claude)、OpenAI、DeepSeek、Qwen (Tongyi)、Kimi (Moonshot AI)、Zhipu (GLM)
LM Studio（ローカル） または Ollama（ローカル）：ご自身のコンピューター上のモデル。キーは不要です。
カスタム（OpenAI 互換）：入力したアドレスにある、OpenAI 互換のインターフェースを持つ任意のサービス。

設定するには、次のようにします。

AI > AIアシスタント… を開きます。
プロバイダー を選びます。Studio が ベース URL を入力します。
キーを APIキー に貼り付けて、キーを保存 をクリックします。結果：キーは暗号化されて、このコンピューターに保存されます。Windows では、お使いの Windows アカウントだけが読み取れます。Linux では、デスクトップのキーリング（Secret Service：GNOME Keyring、KWallet）に保存します。キーリングがない場合は、ご自分のユーザーアカウントだけが読めるファイル内のキーで暗号化し、キーの下の行にそのことが表示されます。
モデル一覧 をクリックして、モデル を選びます。

Studio は、キーを、設定、レジストリ、監査ログのいずれにも書き込みません。保存したキーを削除するには、欄を空にして キーを保存 をクリックします。

補足

AIサービスに送る内容は、そのサービスに、ご自身のアカウントのもとで、そのサービスの規約に従って送られます。送られるのは、メッセージです。ウィンドウのプログラム、段取り、検査結果を添付 をオンにしている場合は、プログラム、段取り、検査結果も送られます。AI が使うツールの結果も送られます。すべてをコンピューター上にとどめるには、ローカルモデルを使ってください。

クラウドサービスへの最初のメッセージの前に、アシスタントは、何がそこに送られるかを一度だけ伝えます。続けるには送信を、LM Studio に切り替えるには ローカルモデルを使う… をクリックします。メッセージは入力欄に残ります。ツール > 設定… > AI と MCP には、同意したサービスの一覧があります。もう一度確認する を押すと、アシスタントが再び確認します。

アシスタントパネル

AI > AIアシスタント… は、アシスタントを専用のウィンドウで開きます。

下部の入力欄に入力します。Enter で送信し、Shift+Enter で改行します。停止で応答を止めます。
ウィンドウのプログラム、段取り、検査結果を添付（変更があった場合） は、メッセージごとに、ウィンドウの内容を AI に渡します。既定でオンです。
会話には、AI が使った各ツールが表示されます。うまくいったときは ✓、いかなかったときは ✗ が付きます。
AI が作る画像（ワーク、ツールパス、部品からの偏差、比較）が、会話に表示されます。画像をダブルクリックすると、拡大したり保存したりできます。
新しい会話 は、会話を新しく始めます。Studio を閉じると、会話は保存されません。

ウィンドウを閉じても、非表示になるだけです。終了するまで、会話は残ります。

AI にできること、できないこと

スイッチがオンのとき、AI には次のことができます。

機械の状態の読み取り、原点復帰、ロック解除、ジョグ、G コードの行の送信
素材、工具、ワーク原点、部品の設定、プロービング、検査
プログラムの検査、シミュレーション、最適化、作成、編集、読み込み、および実行の開始または再開始
実行とその結果の読み取り、比較、画像の作成
監査ログとライセンスの状態の読み取り
説明しながら、ウィンドウで示すこと：ワークスペース、3Dビューの視点、軌跡、プログラムの経路、色分け、ドックのタブ、準備のステップ。変わるのはウィンドウの表示だけです。
このマニュアルの検索と、その内容に基づく回答
言語、地域、単位、通貨、機械の時間単価の変更。許可をクリックした後でのみ行い（後述）、ツール > 設定… で変更したときと同じように適用します。

有料エディションに属するツール（検査、レポート、ネスティング、最適化）は、そのエディションでのみ動作します。

AI は、Studio のその他の設定（ユーザーレベル、AIスイッチ、Studio の確認方法、プライバシー、ログ、外観）を変更できません。ライセンスと監査ログも変更できません。

機械を変更する前の確認

AI がウィンドウの機械を変更する前（トップバーの AI のメニューと、ツール > 設定… > AI と MCP にあります）には、2つの選択肢があります。

毎回確認する（既定）
確認しない（AI がウィンドウを直接操作）

AI がウィンドウの機械を変更しようとすると（動かす、電源を投入する、非常停止を解除する、プログラムを読み込むか実行する、段取りや工具を変更する）、または AI が変更できる設定のいずれかを変更しようとすると、機械バーの上にバーが開きます。このバーには、どの AI が何をしようとしているかが表示され、カウントダウンが行われます。

質問を読みます。
許可または拒否をクリックします。Enter では答えられません。マウスを使うか、Tab でボタンまで移動して Space を押してください。

60秒以内に答えがない場合は、拒否として扱われます。許可は、その操作に付随する後続の要求にも、2分間適用されます。

Studio は、AI が機械を停止する、フィードホールドする、リセットする、非常停止を押す、または読み取るだけの場合、事前に確認しません。練習用の機械と、AI がシミュレーションに使う非表示のコピーについても、確認しません。

実機では読み取り専用

ウィンドウのツインが実機に追従している場合（シャドーモード。1.0 ではプレビューです。実機を参照）、AI は読み取りと分析しか行いません。機械を動かすこと、段取りやワーク座標オフセットを変更すること、そこでプログラムを実行することはできず、確認も求めません。Studio がそれらの要求を拒否します。練習用の機械は、これまでどおり動作します。

AIアクティビティ

AI > AIアクティビティ… は、このコンピューター上で AIクライアントが行っていることを表示します。

バックグラウンドの機械：AI が使う練習用の機械で、ウィンドウには表示されません（ここでの「ウィンドウ」は、ウィンドウに表示されている機械を指します）。
実行履歴：直近 16件のシミュレーションと最適化。
接続中の AIクライアント：誰がどのように接続しているか、およびその最後の呼び出し。

ここから、実行の停止、実行の画像の表示、バックグラウンドの機械を閉じること、ツインホストの停止と起動ができます。ツインホストは、練習用の機械を保持するバックグラウンドのプログラムです。AIクライアントが接続すると起動し、使われないまま 30分たつと終了します。

ドックの AIアクティビティ タブには、ウィンドウの機械に対する AI の呼び出しが一覧されます。時刻、呼び出し、機械、呼び出し元、結果です。

他の AIクライアントを接続する（MCP）

MCP（Model Context Protocol）に対応する AIクライアントは、Studio のツールを使えます。

AI > AIクライアントを接続… を開きます。
使うクライアントをクリックします。Claude Desktop、ChatGPT desktop（Codex モードと Work モード）、Cursor、VS Code (GitHub Copilot)、LM Studio（ローカルのオープンモデル） のいずれかです。結果：Claude Desktop と ChatGPT desktop では、Studio がクライアントの設定に加える変更を表示し、OK をクリックするとその変更を行います。クライアントの元のファイルは、その隣に残されます。そのほかのクライアントでは、それぞれのインストールページが開きます。
クライアントを完全に終了し、もう一度開きます。
Studio で ウィンドウの AIスイッチ をオンにします。

ほかのクライアントでは、その他のクライアント：構成をコピー で、クライアントに貼り付ける設定がコピーされます。クライアントは、バックグラウンドで TwinwrightStudio.exe --mcp を起動します。コマンドと構成 に、実際のコマンドが表示されます。

アドレスだけを受け付けるクライアント

アドレスだけを受け付けるクライアントの場合は、AI のメニューで ローカル URL（HTTP、URL のみ受け付けるクライアント用） をオンにして、ローカル URL（HTTP）をコピー を使います。このアドレスは、このコンピューター上でのみ機能し、付属のトークンが必要です。新しいトークン を使うと、古いトークンは使えなくなります。

ツール、その引数、その結果については、MCP toolsを参照してください。

記録される内容

ツール > 監査ログ…（Ctrl+L）には、AI の操作が、実行者 列に AI の名前とともに記録されます。AI の記録だけを見るには、実行者 を AI で絞り込みます。呼び出しをダブルクリックすると、その呼び出しのすべての記録がまとめて表示されます。

既定の標準レベルでは、ログには次の内容が残ります。

AIスイッチのオンとオフ、および Studio の確認方法の変更
各質問とその答え、ウィンドウの機械に対する AI の各操作
各ツール呼び出しと、その引数の短縮形
クライアントの接続と切断
アシスタントのメッセージ：要約には先頭の 180バイト、記録には最大 2000バイト

キー、トークン、パスワードは *** として記録されます。