本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

开始为代理提供 WorkSpaces 应用程序访问权限

要使 AI 代理能够通过 Amazon WorkSpaces 应用程序运行桌面应用程序，您需要创建一个为代理启用访问权限的堆栈，生成串流 URL，并将您的代理连接到托管 MCP 服务。

如果您是首次设置代理访问权限，则可以使用 “构建您的第一个代理” 快速入门体验。您也可以按照本主题中的步骤手动配置代理访问权限。 GitHub存储库中提供了快速入门体验——工作空间代理访问的示例代码。

本教程大约需要 15 分钟才能完成。

在本教程中，您将完成以下任务：

先决条件

在开始之前，请确保您具有以下各项：

第 1 步：创建启用代理访问权限的堆栈

创建启用代理访问权限的 WorkSpaces 应用程序堆栈，以允许 AI 代理与桌面应用程序交互。

使用 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 步：生成直播网址

使用标准 WorkSpaces 应用程序 CreateStreamingURL API 创建直播网址。您不需要代理特定的参数。堆栈的代理访问配置决定了代理特定的行为。

使用 AWS 管理控制台

使用 AWS CLI

运行以下命令生成直播网址：

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

该响应包括您在下一步中传递给代理的。StreamingURLURL 在--validity参数指定的持续时间内有效。

第 3 步：将您的代理连接到 MCP 服务

您的代理通过以下固定端点连接到托管 MCP 服务：

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

连接使用带有服务名称的 SigV4 签名。agentaccess-mcp您的代理使用先决条件中配置的 AWS 凭据对每个请求进行签名，并具有agentaccess-mcp:*权限。您在每个 MCP 请求中将第 2 步中的直播网址作为标头传递。

以下示例显示如何使用 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