翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# WorkSpaces にアクセスするエージェントの詳細
<a name="agent-access-setup"></a>

Amazon WorkSpaces アプリケーションを使用すると、エージェントはストリーミングセッションに接続し、マネージドモデルコンテキストプロトコル (MCP) サービスを介してデスクトップアプリケーションとやり取りできます。このトピックでは、エージェントが WorkSpaces アプリケーションにアクセスする方法と、設定できる機能について説明します。

## 前提条件
<a name="agent-access-before-you-begin"></a>

エージェントアクセスを使用するには、以下が必要です。
+ アクティブな Amazon WorkSpaces アプリケーションフリート (常時オンまたはオンデマンド）。フリートを作成していない場合は、「」を参照してください[Amazon WorkSpaces アプリケーションの開始方法: サンプルアプリケーションのセットアップ](getting-started.md)。
+ フリートに関連付けられたスタック。エージェントは、関連付けられたフリートがないスタックに接続できません。
+ Amazon WorkSpaces アプリケーションスタックを作成および管理するためのアクセス許可を持つ AWS アカウント。
+ スクリーンショットストレージを有効にする場合は、Amazon S3 バケット。バケットポリシーは、バケットを一覧表示するためのアクセス権を AppStream サービスプリンシパルに付与する必要があります。MCP サービスに接続するエージェントには、バケットに対する アクセス`s3:PutObject`許可が必要です。
+ ホームフォルダを有効にする場合は、同じ Amazon S3 アクセス要件が適用されます。
+ 最新の WorkSpaces アプリケーションエージェントを実行しているフリート。WorkSpaces Applications Agent の更新の詳細については、「」を参照してください[Amazon WorkSpaces アプリケーションイメージUp-to-Date状態に保つ](keep-image-updated.md)。

**制限事項**

WorkSpaces エージェントアクセス設定には、次の制限があります。
+ Windows Server イメージのみがサポートされています。
+ ドメイン結合フリートはサポートされていません。
+ VPC エンドポイントはサポートされていません。
+ マルチセッションフリートはサポートされていません。
+ Elastic フリートはサポートされていません。

## エージェントアクセスの仕組み
<a name="agent-access-how-it-works"></a>

スタックの作成時にエージェントアクセスを有効にします。エージェントアクセスが有効になっている場合、スタックは人間のユーザー向けの標準の Amazon WorkSpaces アプリケーション設定ではなく、エージェント固有の設定で設定されます。エージェントアクセスは、Amazon WorkSpaces アプリケーションコンソール AWS CLI、または API を使用して有効にできます。

## コンピュータの入力とビジョン
<a name="agent-access-input-vision"></a>

エージェントアクセスには、スタックレベルで設定する 2 つのインタラクション機能があります。
+ **コンピュータ入力** — エージェントがストリーミングセッション中にボタンをクリックし、テキストを入力し、デスクトップでスクロールできるようにします。
+ **コンピュータビジョン** — ストリーミングセッション中にスクリーンショットを作成して、エージェントがデスクトップを表示できるようにします。

これらの機能の少なくとも 1 つを有効にする必要があります。

## スクリーンショットストレージ
<a name="agent-access-screenshots"></a>

必要に応じて、エージェントセッションのスクリーンショットストレージを設定できます。スクリーンショットストレージが有効になっている場合、エージェントセッション中にキャプチャされたスクリーンショットは Amazon S3 バケットに保存されます。MCP サービスは、接続エージェントの認証情報を使用してスクリーンショットをバケットにアップロードします。エージェントには、バケットに対する アクセス`s3:PutObject`許可が必要です。

## デスクトップ画面のレイアウト
<a name="agent-access-screen-layout"></a>

エージェントストリーミング環境の画面解像度と画像形式を設定します。
+ **画面解像度** — エージェントストリーミング環境の表示解像度。サポートされている解像度は 1280x720 です。
+ **画面イメージタイプ** — エージェントの画面キャプチャのイメージ形式。PNG または JPEG を選択できます。

## ホームフォルダストレージ
<a name="agent-access-home-folders"></a>

ホームフォルダを有効にして、エージェントファイルを AWS アカウントの Amazon S3 バケットに保存できます。スタックに関連付けられた Amazon WorkSpaces アプリケーションフリートは、インターネット経由で Amazon S3 へのアクセスを許可する必要があります。

## アプリケーション設定の永続性
<a name="agent-access-app-persistence"></a>

オプションで、アプリケーション設定の永続化を有効にできます。有効にすると、エージェントのアプリケーションのカスタマイズと Windows 設定は各ストリーミングセッションの後に保存され、次のセッション中に適用されます。これらの設定は、 AWS アカウントの Amazon S3 バケットに保存されます。スタックに関連付けられた Amazon WorkSpaces アプリケーションフリートは、インターネット経由で Amazon S3 へのアクセスを許可する必要があります。

## ストリーミング URLs
<a name="agent-access-streaming-url"></a>

エージェントは、ストリーミング URL を介して WorkSpaces アプリケーションに接続します。`CreateStreamingURL` API を使用してストリーミング URL を生成します。エージェント固有のパラメータは必要ありません。エージェント固有の動作は、スタックのエージェントアクセス設定によって決まります。ストリーミング URL は、各リクエストのヘッダーとして MCP サービスに渡されます。

`CreateStreamingURL` API の詳細については、*Amazon AppStream 2.0 * [CreateStreamingURL](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html)」を参照してください。

## AWS の MCP プロキシ
<a name="agent-access-mcp-proxy"></a>

エージェントをマネージド MCP サービスに接続するには、 `mcp-proxy-for-aws`トランスポートを使用して、Python での MCP リクエストの SigV4 署名をサポートする MCP クライアントを作成できます。別の言語でエージェントを構築する場合は、署名ロジックを自分で記述するか、使用可能なライブラリを見つける必要があります。

詳細については、GitHub の[mcp-proxy-for-aws](https://github.com/aws/mcp-proxy-for-aws)」を参照してください。

## モニタリング
<a name="agent-access-monitoring"></a>

エージェントのアクティビティは、次のサービスを通じてモニタリングできます。
+ **AWS CloudTrail** — エージェントセッションイベントは CloudTrail に記録されます。エージェントが接続するタイミング、使用するツール、セッションが終了するタイミングを表示できます。ツール呼び出しはデータイベントであり、データイベントをログに記録する証跡を設定する必要があります。詳細については、*CloudTrail ユーザーガイド*」の[「データイベントのログ記録](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html)」を参照してください。
+ **CloudWatch** — エージェントセッションでは、CloudWatch で次の運用メトリクスを使用できます。
  + `Invocations`
  + `Latency`
  + `ClientErrors`
  + `ServerErrors`
  + `SessionStart`
  + `SessionEnd`
+ **Amazon S3** — スクリーンショットストレージを設定すると、エージェントセッション中にキャプチャされたスクリーンショットは、指定した Amazon S3 バケットで使用できます。