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 a WorkSpaces Aplicações
Para permitir que agentes de IA operem aplicativos de desktop por meio da Amazon WorkSpaces Em aplicativos, você cria uma pilha com acesso habilitado para agentes, gera uma URL de streaming e conecta seu agente ao servidor 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 — código de amostra para acesso de agentes a espaços de trabalho
Esse tutorial leva aproximadamente 15 minutos para ser concluído.
Os recursos que você cria neste tutorial podem resultar em cobranças para seu AWS conta. Exclua a pilha e interrompa a frota quando terminar para evitar cobranças contínuas.
Neste tutorial, você conclui as seguintes tarefas:
Etapa 1: criar uma pilha com o acesso do agente ativado
Etapa 2: gerar um URL de streaming
Etapa 3: conectar seu agente ao servidor MCP
Etapa 4: Verificar a atividade do agente
Etapa 5: Limpar os recursos do
Escreva o código do agente com o kit de ferramentas do agente para a AWS
Se você criar seu agente com um assistente de codificação de IA, poderá usar o Kit de ferramentas de agentes para a AWS
O kit de ferramentas usa o AWS Servidor MCP. Esse servidor gerenciado oferece aos agentes acesso seguro ao AWS por meio do Model Context Protocol (MCP). Os agentes podem executar AWS CLI comandos, pesquisa AWS documentos e siga as habilidades prontas. Eles se conectam por meio de um terminal seguro. Você também recebe CloudWatch métricas e controles de acesso do IAM.
Para começar, pergunte ao seu agente: “Ajude-me a concluir a introdução. WorkSpaces tutorial de acesso do agente”.
Pré-requisitos
Antes de começar, revise os requisitos de acesso do agente. Para ver os pré-requisitos de conta, frota, permissões e agentes, consulte Pré-requisitos.
Etapa 1: criar uma pilha com o acesso do agente ativado
Crie um WorkSpaces Os aplicativos são empilhados 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
Para criar uma pilha com acesso de agente
-
No painel de navegação esquerdo, escolha Pilhas, em seguida, escolha Criar pilha.
-
Na Detalhes da pilha página (etapa 1 de 4), abaixo Acesso a agentes de IA, selecione Habilitar o acesso do agente de IA. Escolha Próximo.
-
Na Ativar armazenamento página (etapa 2 de 4), habilite opcionalmente Pastas pessoais para permitir que seu agente salve arquivos em um bucket do Amazon S3 em seu AWS conta. A frota associada a essa pilha deve permitir o acesso ao Amazon S3 pela Internet ou por um endpoint Amazon VPC para o Amazon S3. Escolha Próximo.
-
Na Editar configurações do agente página (etapa 3 de 4), configure o seguinte:
-
Ativar entrada do computador — Permita que os agentes escolham botões, insiram texto e rolem na área de trabalho. Se você habilitar a entrada do computador, também deverá ativar a visão computacional.
-
Habilite a visão computacional — Permita que os agentes vejam o desktop.
-
Armazenamento de captura de tela — Configure onde as capturas de tela do agente são armazenadas durante as sessões de streaming. Se ativado, forneça um bucket do Amazon S3 no qual você tenha permissão para gravar.
-
Resolução da tela — Selecione a resolução de exibição para o ambiente de streaming do agente (1280x720).
-
Tipo de imagem da tela — Selecione o formato da imagem para as capturas de tela do agente (PNG ou JPEG).
-
Persistência das configurações do aplicativo — Opcionalmente, ative isso para salvar as personalizações de aplicativos e as configurações do Windows do seu agente entre as sessões. As configurações são salvas em um bucket do Amazon S3 em seu AWS conta. Essa configuração está disponível no Windows e não é suportada no Linux.
-
Habilitar o encaminhamento de ferramentas MCP — permita que os agentes interajam com os aplicativos e o sistema operacional do desktop por meio de chamadas diretas de MCP, em vez de usar ferramentas de uso do computador. Quando ativadas, as ferramentas MCP são configuradas no WorkSpaces as sessões do aplicativo são encaminhadas ao agente. O encaminhamento de ferramentas também exige um arquivo de configuração na imagem. Para saber o caminho específico da plataforma e as etapas de configuração, consulte Configurando o encaminhamento de ferramentas.
-
Ativar o modo de controle do usuário — Permita que os usuários observem as sessões do agente em tempo real por meio do navegador. Os observadores têm uma visão ao vivo da área de trabalho enquanto o agente trabalha. No modo VIEW_STOP, os observadores podem parar o agente usando um botão na parte superior da tela. Depois que o agente parar, ele deverá iniciar uma nova sessão para ser retomada.
notaVocê deve habilitar pelo menos uma das entradas de computador ou visão computacional.
Escolha Próximo.
-
-
Na Revise e crie página (etapa 4 de 4), revise suas configurações e escolha Criar pilha.
Usar o AWS CLI
Execute o comando a seguir para criar uma pilha com o acesso do agente ativado:
aws appstream create-stack \ --nameyour-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 o S3BucketArn e ScreenshotsUploadEnabled parâmetros:
aws appstream create-stack \ --nameyour-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-nameyour-stack-name\ --fleet-nameyour-fleet-name
Etapa 2: gerar um URL de streaming
Crie um URL de streaming usando o padrão WorkSpaces Aplicações CreateStreamingURL API. 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
Para gerar um URL de streaming usando o console
-
No painel de navegação esquerdo, escolha Pilhase escolha a pilha que você criou com o acesso do agente ativado.
-
Escolha o Ações botão e, no menu suspenso, selecione Criar URL de streaming. Sua pilha deve ser selecionada para que essa opção esteja disponível.
-
Na ID de usuário seção, insira um usuário. Você pode entrar
TestUserse você estiver testando. -
Na Expiração do URL seção, selecione a hora em que você deseja que o URL seja válido. Recomenda-se um tempo mais curto. O padrão é 30 minutos, o que é recomendado para testes.
-
Escolha Obter URL e copie o URL gerado.
Usar o AWS CLI
Execute o comando a seguir para gerar um URL de streaming:
aws appstream create-streaming-url \ --stack-nameyour-stack-name\ --fleet-nameyour-fleet-name\ --user-idyour-agent-id\ --validity 3600
A resposta inclui um StreamingURL que você passa para o seu agente na próxima etapa. O URL é válido pela duração especificada pelo --validity parâmetro.
A qualquer momento, somente um agente pode se conectar a uma sessão exclusiva. Usuários nomeados, especificados por meio do UserId parâmetro, pode ter somente uma sessão ativa por frota por vez. Para executar vários agentes simultaneamente, cada agente deve se conectar à sua própria sessão exclusiva.
Etapa 3: conectar seu agente ao servidor MCP
Seu agente se conecta ao servidor MCP gerenciado no seguinte endpoint fixo:
https://agentaccess-mcp.region.api.aws/mcp
Substituir region com seu código de região. Para as regiões suportadas e seus endpoints, consulte WorkSpaces Endpoints MCP de aplicativos.
A conexão usa a assinatura SigV4 com o nome do serviço agentaccess-mcp. Seu agente assina cada solicitação usando o AWS
credenciais configuradas nos pré-requisitos com o agentaccess-mcp:* permissões. 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 o seguinte AWS serviços:
-
AWS CloudTrail — AWS CloudTrail registra eventos da sessão do agente. Abra o AWS CloudTrail console para visualizar a atividade do agente. As chamadas de ferramentas são registradas como eventos de dados, o que requer uma trilha configurada para eventos de dados de registro.
-
CloudWatch — CloudWatch fornece métricas operacionais para sessões de agentes. Abra o CloudWatch console para visualizar métricas.
-
Amazon S3 — Se você habilitou o armazenamento de capturas de tela, o Amazon S3 armazena as capturas de tela no bucket que você especificou durante a configuração da pilha.
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
Para limpar os recursos
-
No painel de navegação à esquerda, escolha Fleets (Frotas).
-
Selecione a frota associada à pilha. Escolha Actions, Stop. Espere a frota parar.
-
No painel de navegação à esquerda, selecionePilhas.
-
Selecione a pilha que você criou e escolha Ações, Frota dissociada.
-
Com a pilha ainda selecionada, escolha Ações, Excluir.
-
(Opcional) Para excluir a frota, no painel de navegação esquerdo, escolha Frotas. Selecione a frota e escolha Ações, Excluir.
Usar o AWS CLI
Execute os seguintes comandos para limpar os recursos:
aws appstream stop-fleet \ --nameyour-fleet-nameaws appstream disassociate-fleet \ --stack-nameyour-stack-name\ --fleet-nameyour-fleet-nameaws appstream delete-stack \ --nameyour-stack-name
(Opcional) Para excluir também a frota depois que ela for interrompida:
aws appstream delete-fleet \ --nameyour-fleet-name