AIアシスタント

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

AI をオンにする

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

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

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

AIサービスとそのキー

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

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

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

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

補足

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

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

アシスタントパネル

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

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

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

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

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

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

機械を変更する前の確認

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

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

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

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

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

実機では読み取り専用

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

AIアクティビティ

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

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

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

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

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

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

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

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

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

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

記録される内容

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

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

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