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

WorkSpaces アプリケーションへのアクセス権をエージェントに付与する

AI エージェントが Amazon WorkSpaces アプリケーションを介してデスクトップアプリケーションを操作できるようにするには、エージェントのアクセスを有効にしたスタックを作成し、ストリーミング URL を生成して、エージェントをマネージド MCP サービスに接続します。

エージェントアクセスを初めて設定する場合は、Build Your First Agent クイックスタートエクスペリエンスを使用できます。このトピックの手順に従って、エージェントアクセスを手動で設定することもできます。クイックスタートエクスペリエンスは、GitHub リポジトリsample-code-for-workspaces-agent-access」で利用できます。

このチュートリアルの所要時間は約 15 分です。

このチュートリアルでは、以下のタスクを完了します。

前提条件

作業を開始する前に、次の項目があることを確認します。

ステップ 1: エージェントアクセスを有効にしてスタックを作成する

AI エージェントがデスクトップアプリケーションとやり取りできるように、エージェントアクセスを有効にして WorkSpaces アプリケーションスタックを作成します。

AWS マネジメントコンソールの使用

の使用 AWS CLI

次のコマンドを実行して、エージェントアクセスが有効になっているスタックを作成します。

aws appstream create-stack \
    --name your-stack-name \
    --agent-access-config '{
        "Settings": [
            {"AgentAction": "COMPUTER_VISION", "Permission": "ENABLED"},
            {"AgentAction": "COMPUTER_INPUT", "Permission": "ENABLED"},
            {"AgentAction": "FORWARD_MCP_TOOLS", "Permission": "ENABLED"}
        ],
        "ScreenResolution": "W_1280xH_720",
        "ScreenImageFormat": "PNG"
    }'

スクリーンショットストレージも有効にするには、 S3BucketArn および ScreenshotsUploadEnabledパラメータを追加します。

aws appstream create-stack \
    --name your-stack-name \
    --agent-access-config '{
        "Settings": [
            {"AgentAction": "COMPUTER_VISION", "Permission": "ENABLED"},
            {"AgentAction": "COMPUTER_INPUT", "Permission": "ENABLED"},
            {"AgentAction": "FORWARD_MCP_TOOLS", "Permission": "ENABLED"}
        ],
        "ScreenResolution": "W_1280xH_720",
        "ScreenImageFormat": "PNG",
        "S3BucketArn": "arn:aws:s3:::your-bucket-name",
        "ScreenshotsUploadEnabled": true
    }'

スタックを作成したら、フリートに関連付けます。エージェントは、関連付けられたフリートを持たないスタックに接続できません。

aws appstream associate-fleet \
    --stack-name your-stack-name \
    --fleet-name your-fleet-name

ステップ 2: ストリーミング URL を生成する

標準の WorkSpaces Applications CreateStreamingURL API を使用してストリーミング URL を作成します。エージェント固有のパラメータは必要ありません。スタックのエージェントアクセス設定によって、エージェント固有の動作が決まります。

AWS マネジメントコンソールの使用

の使用 AWS CLI

ストリーミング URL を生成するには、次のコマンドを実行します。

aws appstream create-streaming-url \
    --stack-name your-stack-name \
    --fleet-name your-fleet-name \
    --user-id your-agent-id \
    --validity 3600

レスポンスには、次のステップでエージェントにStreamingURL渡す が含まれます。URL は、 --validityパラメータで指定された期間有効です。

ステップ 3: エージェントを MCP サービスに接続する

エージェントは、次の固定エンドポイントでマネージド MCP サービスに接続します。

https://agentaccess-mcp.region.api.aws/mcp

接続では、サービス名 で SigV4 署名を使用しますagentaccess-mcp。エージェントは、 AWS のアクセスagentaccess-mcp:*許可を持つ前提条件で設定された認証情報を使用して各リクエストに署名します。ステップ 2 のストリーミング URL は、すべての MCP リクエストのヘッダーとして渡します。

次の例は、mcp-proxy-for-aws を使用して接続を確立する方法を示しています。

aws_iam_streamablehttp_client(
    endpoint="https://agentaccess-mcp.region.api.aws/mcp",
    aws_service="agentaccess-mcp",
    aws_region="region",
    headers={
        "X-Amzn-AgentAccess-Streaming-Session-Url": streaming_url,
    },
)

エージェントが接続したら、MCP ツールを使用してテキストの入力、ボタンの選択、デスクトップのスクリーンショットの撮影を行うことができます。

ステップ 4: エージェントアクティビティを検証する

次の AWS サービスを使用して、エージェントのアクティビティを確認できます。

ステップ 5: のリソースをクリーンアップする

継続的な課金を回避するには、このチュートリアルで作成したスタックを削除します。スタックを削除する前に、フリートを停止し、スタックとの関連付けを解除する必要があります。必要に応じて、フリートを削除することもできます。

AWS マネジメントコンソールの使用

の使用 AWS CLI

次のコマンドを実行して、リソースをクリーンアップします。

aws appstream stop-fleet \
    --name your-fleet-name

aws appstream disassociate-fleet \
    --stack-name your-stack-name \
    --fleet-name your-fleet-name

aws appstream delete-stack \
    --name your-stack-name

(オプション) 停止後にフリートも削除するには:

aws appstream delete-fleet \
    --name your-fleet-name