Agent の作業をリアルタイムで確認したり、マウスとキーボードを自分で操作したりできます。Yao Agents の UI に内蔵された VNC ビューアーを使うため、外部クライアントのインストールは不要です。
## リモートデスクトップセッションを開く
1. Yao Agents の **Tai Link** パネルを開きます。
2. 表示したいデバイスをクリックします。
3. **リモートデスクトップ**（またはデバイスカードの VNC アイコン）をクリックします。
VNC ビューアーが Yao Agents 内で直接開きます。
## 表示される内容
ビューアーにはリモートデバイスのフルデスクトップが表示されます（Agent が Docker サンドボックスで作業している場合はコンテナのデスクトップ）。できること：
- **観察** — Agent がウェブサイトをビルドしたり、データを分析したり、テストを実行する様子をリアルタイムで確認。
- **操作を引き継ぐ** — ビューアーをクリックして自分のマウスとキーボードで操作できます。操作中は Agent が一時停止します。
- **自動リサイズ** — ビューアーはブラウザウィンドウに合わせて自動的にスケールします。
## 仕組み
Tai Link には **VNC ルーター**が内蔵されており、WebSocket 接続（ブラウザから）とリモートデバイスやコンテナ内で動く TCP VNC サーバーをブリッジします。
URL パターンは `/vnc/{containerID}/ws` です。Agent がデスクトップ付きのコンテナ（ポート 5900）を起動すると、VNC ルーターが自動的に検出して接続します。
**ホスト VNC**（物理画面）にアクセスするには、起動時に有効にします：
```bash
tai server --host-vnc-port 5900 http://<YOUR_YAO_SERVER>:5099
```
または `config.yml` で：
```yaml
upstream:
host_vnc_port: 5900
```
## トラブルシューティング
**VNC ビューアーが真っ白な画面を表示する。**
コンテナまたはホスト上の VNC サーバーがまだ起動していない可能性があります。数秒待ってください——Agent がデスクトップ環境を起動するのに少し時間がかかります。
**「Failed to connect to VNC server」と表示される。**
Tai Link がターゲットのポート 5900 に到達できません。Docker の場合はコンテナがポート 5900 を公開しているか確認し、ホストへの接続の場合は VNC サーバー（x11vnc や TigerVNC など）が起動しているか確認してください。
**表示が遅い・ラグがある。**
VNC のパフォーマンスはブラウザから Yao サーバー、および Yao から Tai Link デバイスまでのネットワーク帯域に依存します。遅い回線では遅延が生じます。
## 次のステップ
- [ファイル同期](/docs/ja-jp/tai-link/file-sync) — リモートワークスペースへファイルを転送する
- [セキュリティとプライバシー](/docs/ja-jp/tai-link/security-and-privacy) — 接続の暗号化とアクセス制御
リモートデスクトップ
feedback
Feedback