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á.
# Saiba mais sobre o acesso dos agentes WorkSpaces
O Amazon WorkSpaces Applications permite que os agentes se conectem a sessões de streaming e interajam com aplicativos de desktop por meio de um serviço gerenciado de Model Context Protocol (MCP). Este tópico explica como os agentes acessam os WorkSpaces aplicativos e os recursos que você pode configurar.
## Pré-requisitos
Para usar o acesso de agente, você precisa do seguinte:
+ Uma frota ativa da Amazon WorkSpaces Applications (Always-On ou On-Demand). Se você ainda não criou uma frota, consulte[Comece a usar os WorkSpaces aplicativos da Amazon: configure com aplicativos de amostra](getting-started.md).
+ Uma pilha associada a uma frota. Os agentes não podem se conectar a uma pilha sem uma frota associada.
+ Uma AWS conta com permissões para criar e gerenciar pilhas de WorkSpaces aplicativos da Amazon.
+ Se você planeja habilitar o armazenamento de capturas de tela, um bucket Amazon S3. A política de bucket deve conceder ao principal do AppStream serviço acesso aos buckets da lista. O agente que se conecta ao serviço MCP deve ter a `s3:PutObject` permissão no bucket.
+ Se você planeja habilitar pastas pessoais, o mesmo requisito de acesso do Amazon S3 se aplica.
+ Uma frota que executa o Agente de WorkSpaces Aplicativos mais recente. Para ler mais sobre como atualizar seu WorkSpaces Applications Agent, consulte[Mantenha a imagem de seus WorkSpaces aplicativos da Amazon Up-to-Date](keep-image-updated.md).
**Limitações**
WorkSpaces as configurações de acesso do agente têm as seguintes limitações:
+ Somente imagens do Windows Server são suportadas.
+ Domain-joined frotas não são suportadas.
+ Os VPC endpoints não são compatíveis.
+ Multi-session frotas não são suportadas.
+ Não há suporte para frotas elásticas.
## Como funciona o acesso do agente
Você ativa o acesso do agente ao criar uma pilha. Quando o acesso do agente é ativado, a pilha é configurada com configurações específicas do agente, em vez da configuração padrão da Amazon WorkSpaces Applications para usuários humanos. Você pode habilitar o acesso do agente por meio do console ou da API do Amazon WorkSpaces Applications. AWS CLI
## Entrada e visão do computador
O acesso do agente fornece dois recursos de interação que você configura no nível da pilha:
+ **Entrada do computador** — permite que os agentes cliquem em botões, insiram texto e rolem pela área de trabalho durante uma sessão de streaming.
+ **Visão computacional** — permite que os agentes vejam a área de trabalho fazendo capturas de tela durante uma sessão de streaming.
Você deve habilitar pelo menos um desses recursos.
## Armazenamento de captura de tela
Opcionalmente, você pode configurar o armazenamento de capturas de tela para sessões do agente. Quando o armazenamento de capturas de tela está ativado, as capturas de tela capturadas durante as sessões do agente são armazenadas em um bucket do Amazon S3. O serviço MCP usa as credenciais do agente de conexão para carregar capturas de tela no bucket. O agente deve ter a `s3:PutObject` permissão no bucket.
## Layout da tela do desktop
Você configura a resolução da tela e o formato da imagem para o ambiente de streaming do agente:
+ **Resolução da tela** — A resolução da tela para o ambiente de streaming do agente. A resolução suportada é 1280x720.
+ **Tipo de imagem da tela** — O formato da imagem para as capturas de tela do agente. Você pode escolher PNG ou JPEG.
## Armazenamento de pastas pessoais
Você pode habilitar pastas iniciais para que os arquivos do agente sejam salvos em um bucket do Amazon S3 em sua AWS conta. A frota da Amazon WorkSpaces Applications associada à pilha deve permitir o acesso ao Amazon S3 pela Internet.
## Persistência das configurações do aplicativo
Opcionalmente, você pode ativar a persistência das configurações do aplicativo. Quando ativadas, as personalizações do aplicativo e as configurações do Windows do seu agente são salvas após cada sessão de streaming e aplicadas durante a próxima sessão. Essas configurações são salvas em um bucket do Amazon S3 em sua AWS conta. A frota da Amazon WorkSpaces Applications associada à pilha deve permitir o acesso ao Amazon S3 pela Internet.
## URLs de streaming
Os agentes se conectam aos WorkSpaces aplicativos por meio de uma URL de streaming. Você gera um URL de streaming usando a `CreateStreamingURL` API. Nenhum parâmetro específico do agente é necessário. O comportamento específico do agente é determinado pela configuração de acesso do agente da pilha. O URL de streaming é passado para o serviço MCP como um cabeçalho em cada solicitação.
Para obter mais informações sobre a `CreateStreamingURL` API, consulte o [CreateStreamingURL](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html) na *Amazon AppStream 2.0 API Reference*.
## Proxy MCP para AWS
Para conectar seu agente ao serviço MCP gerenciado, você pode usar o `mcp-proxy-for-aws` transporte para criar um cliente MCP que suporte a assinatura SigV4 de solicitações MCP em Python. Se você estiver criando um agente em outro idioma, precisará escrever você mesmo a lógica de assinatura ou encontrar uma biblioteca disponível.
Para obter mais informações, consulte [mcp-proxy-for-aws](https://github.com/aws/mcp-proxy-for-aws) on. GitHub
## Monitoramento
Você pode monitorar a atividade do agente por meio dos seguintes serviços:
+ **AWS CloudTrail**— Os eventos da sessão do agente são registrados. CloudTrail Você pode ver quando os agentes se conectam, quais ferramentas eles usam e quando as sessões terminam. As chamadas de ferramentas são eventos de dados e exigem que você configure uma trilha para registrar eventos de dados. Para obter mais informações, consulte [Registrar eventos de dados](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html), no *Guia do usuário do CloudTrail *.
+ **CloudWatch**— As seguintes métricas operacionais estão disponíveis CloudWatch para sessões de agentes:
+ `Invocations`
+ `Latency`
+ `ClientErrors`
+ `ServerErrors`
+ `SessionStart`
+ `SessionEnd`
+ **Amazon S3** — Se você configurar o armazenamento de capturas de tela, as capturas de tela capturadas durante as sessões do agente estarão disponíveis no bucket do Amazon S3 que você especificar.