セッションの動作

スタックでエージェントアクセスを有効にする場合、エージェントのデスクトップセッションの動作を設定します。これには、エージェントのデスクトップの表示と制御、スクリーンショットとファイルの保存場所、画面レイアウト、ユーザーがエージェントを監視および停止できるかどうかが含まれます。これらのオプションはスタックレベルで設定します。

コンピュータの入力とビジョン

エージェントアクセスには、コンピュータ用に 2 つのオプションがあります。スタックレベルで設定します。その他のエージェントオプションについては、MCP ツールの転送「」および「」を参照してくださいユーザーコントロールモード。

• コンピュータ入力: ストリーミングセッション中に、エージェントはボタンをクリックし、テキストを入力し、デスクトップでスクロールします。

• コンピュータビジョン: ストリーミングセッション中に、エージェントはスクリーンショットを撮ってデスクトップを表示します。

これらのルールを使用して、何をオンにするかを選択します。

• エージェントがコンピュータ入力を使用するには、コンピュータビジョンをオンにする必要があります。キーボードとマウスを使用するには、エージェントにデスクトップが表示される必要があります。

• ツール転送のみを使用する場合は、コンピュータの入力とビジョンをオフにしておくことができます。詳細については、「MCP ツールの転送」を参照してください。

スクリーンショットストレージ

オプションでスクリーンショットストレージを設定できます。有効にすると、モデルコンテキストプロトコル (MCP) サーバーは、エージェントセッション中にキャプチャされたスクリーンショットを Amazon S3 バケットに保存します。MCP サーバーは接続エージェントの認証情報を使用してスクリーンショットをバケットにアップロードするため、エージェントにはバケットに対する s3:PutObject アクセス許可が必要です。バケット内のスクリーンショットを暗号化するには、Amazon S3バケットのデフォルトの暗号化の設定」を参照してください。

デスクトップ画面のレイアウト

エージェントのデスクトップセッションの画面解像度と画像形式を設定します。

• 画面解像度: エージェントのデスクトップセッションの表示解像度。サポートされている解像度は 1280x720 です。

• 画面イメージタイプ: エージェントの画面キャプチャのイメージ形式。PNG または JPEG を選択できます。

ホームフォルダストレージ

エージェントファイルが AWS アカウントの Amazon S3 バケットに保存されるように、ホームフォルダを有効にできます。スタックに関連付けられた Amazon WorkSpaces アプリケーションフリートは、インターネットまたは Amazon S3 VPC エンドポイントを介した Amazon S3 へのアクセスを許可する必要があります。詳細については、「ユーザーのホームフォルダの有効化と管理」を参照してください。

アプリケーション設定の永続性

オプションで、アプリケーション設定の永続化を有効にできます。この設定は Windows で使用でき、Linux ではサポートされていません。有効にすると、エージェントのアプリケーションのカスタマイズと Windows 設定は各ストリーミングセッションの後に保存され、次のセッション中に適用されます。これらの設定は、 AWS アカウントの Amazon S3 バケットに保存されます。スタックに関連付けられた Amazon WorkSpaces アプリケーションフリートは、インターネットまたは Amazon S3 VPC エンドポイントを介した Amazon S3 へのアクセスを許可する必要があります。詳細については、「ユーザーのアプリケーション設定の永続化を有効にする」を参照してください。

ユーザーコントロールモード

ユーザーコントロールモードを有効にして、ユーザーがエージェントセッションをリアルタイムで監視および操作できるようにします。ユーザーコントロールモードを有効にすると、オブザーバーはストリーミング URL を使用してブラウザを介してセッションに接続します。エージェントがデスクトップを操作すると、デスクトップのリアルタイムビューが表示されます。

VIEW_STOP モードでは、オブザーバーの画面の上部に停止ボタンが表示されます。オブザーバーはこのボタンを使用して、必要に応じてエージェントを停止できます。エージェントが停止したら、作業を再開するために新しいセッションを開始する必要があります。

の UserControlMode 属性AgentAccessConfigを次のいずれかの値に設定します。

• VIEW_ONLY: ユーザーはエージェントアクションを発生時に表示および監視できます。

• VIEW_STOP: ユーザーはエージェントアクションを表示し、必要に応じてエージェントを停止できます。

• DISABLED: ユーザーはエージェントセッションを表示または停止できません。