As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Comece a fornecer aos agentes acesso aos WorkSpaces aplicativos

Para permitir que agentes de IA operem aplicativos de desktop por meio do Amazon WorkSpaces Applications, você cria uma pilha com acesso habilitado para agentes, gera uma URL de streaming e conecta seu agente ao serviço MCP gerenciado.

Se você estiver configurando o acesso do agente pela primeira vez, poderá usar a experiência de início rápido do Build Your First Agent. Você também pode seguir as etapas deste tópico para configurar o acesso do agente manualmente. A experiência de início rápido está disponível no GitHub repositório — sample-code-for-workspaces-agent-access. https://github.com/aws-samples/sample-code-for-workspaces-agent-access

Esse tutorial leva aproximadamente 15 minutos para ser concluído.

Neste tutorial, você conclui as seguintes tarefas:

Pré-requisitos

Antes de começar, você deve ter o seguinte:

Etapa 1: criar uma pilha com o acesso do agente ativado

Crie uma pilha de WorkSpaces aplicativos com o acesso do agente ativado para permitir que os agentes de IA interajam com os aplicativos de desktop.

Usar o AWS Console de Gerenciamento

Usar o AWS CLI

Execute o comando a seguir para criar uma pilha com o acesso do agente ativado:

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"
    }'

Para ativar também o armazenamento de capturas de tela, adicione os ScreenshotsUploadEnabled parâmetros S3BucketArn e.

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
    }'

Depois de criar a pilha, associe-a a uma frota. Os agentes não podem se conectar a uma pilha que não tenha uma frota associada.

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

Etapa 2: gerar um URL de streaming

Crie um URL de streaming usando a CreateStreamingURL API de WorkSpaces aplicativos padrão. Você não precisa de parâmetros específicos do agente. A configuração de acesso do agente da pilha determina o comportamento específico do agente.

Usar o AWS Console de Gerenciamento

Usar o AWS CLI

Execute o comando a seguir para gerar um URL de streaming:

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

A resposta inclui uma StreamingURL que você passa para seu agente na próxima etapa. O URL é válido pela duração especificada pelo --validity parâmetro.

Etapa 3: conectar seu agente ao serviço MCP

Seu agente se conecta ao serviço MCP gerenciado no seguinte endpoint fixo:

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

A conexão usa a assinatura SigV4 com o nome do serviço. agentaccess-mcp Seu agente assina cada solicitação usando as AWS credenciais configuradas nos pré-requisitos com as permissões. agentaccess-mcp:* Você passa o URL de streaming da Etapa 2 como cabeçalho em cada solicitação de MCP.

O exemplo a seguir mostra como estabelecer a conexão usando 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,
    },
)

Depois que o agente se conecta, ele pode usar as ferramentas MCP para inserir texto, escolher botões e fazer capturas de tela da área de trabalho.

Etapa 4: Verificar a atividade do agente

Você pode verificar a atividade do agente usando os seguintes AWS serviços:

Etapa 5: Limpar os recursos do

Para evitar cobranças contínuas, exclua a pilha que você criou neste tutorial. Você deve parar a frota e desassociá-la da pilha antes de excluir a pilha. Opcionalmente, você também pode excluir a frota.

Usar o AWS Console de Gerenciamento

Usar o AWS CLI

Execute os seguintes comandos para limpar os recursos:

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

(Opcional) Para excluir também a frota depois que ela for interrompida:

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