Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Scopri di più sull'accesso degli agenti WorkSpaces
Amazon WorkSpaces Applications consente agli agenti di connettersi a sessioni di streaming e interagire con le applicazioni desktop tramite un servizio Model Context Protocol (MCP) gestito. Questo argomento spiega in che modo gli agenti accedono alle WorkSpaces applicazioni e le funzionalità che è possibile configurare.
Prerequisiti
Per utilizzare l'accesso agli agenti, è necessario quanto segue:
-
Una flotta di Amazon WorkSpaces Applications attiva (Always-On o On-Demand). Se non hai creato una flotta, consultaInizia a usare Amazon WorkSpaces Applications: configura con applicazioni di esempio.
-
Una pila associata a una flotta. Gli agenti non possono connettersi a uno stack senza una flotta associata.
-
Un AWS account con autorizzazioni per creare e gestire stack di Amazon WorkSpaces Applications.
-
Se prevedi di abilitare l'archiviazione degli screenshot, un bucket Amazon S3. La politica dei bucket deve concedere al AppStream servizio principale l'accesso ai bucket degli elenchi. L'agente che si connette al servizio MCP deve disporre dell'
s3:PutObjectautorizzazione sul bucket. -
Una flotta che esegue l' WorkSpaces Applications Agent più recente. Per saperne di più sull'aggiornamento dell' WorkSpaces Applications Agent, consultaMantieni l'immagine WorkSpaces delle tue applicazioni Amazon Up-to-Date. Per informazioni sulla gestione delle versioni degli agenti, vedere Gestione delle versioni degli agenti.
Limitazioni
WorkSpaces le configurazioni di accesso degli agenti presentano le seguenti limitazioni:
-
Sono supportate solo le immagini di Windows Server.
-
Gli endpoint VPC non sono supportati.
-
Multi-session le flotte non sono supportate.
-
Le flotte elastiche non sono supportate.
-
Una singola sessione supporta solo una connessione con un singolo agente.
Come funziona l'accesso agli agenti
Si abilita l'accesso agli agenti quando si crea uno stack. Quando l'accesso agli agenti è abilitato, lo stack è configurato con impostazioni specifiche dell'agente anziché con la configurazione di Amazon WorkSpaces Applications per utenti umani. Puoi abilitare l'accesso degli agenti tramite la console o l'API di Amazon WorkSpaces Applications. AWS CLI
Input e visione computerizzati
L'accesso agli agenti offre due funzionalità di interazione configurabili a livello di stack:
-
Input da computer: consente agli agenti di fare clic sui pulsanti, immettere testo e scorrere sul desktop durante una sessione di streaming.
-
Visione artificiale: consente agli agenti di vedere il desktop acquisendo schermate durante una sessione di streaming.
È necessario abilitare almeno una di queste funzionalità.
Memorizzazione degli screenshot
Facoltativamente, è possibile configurare l'archiviazione degli screenshot per le sessioni degli agenti. Quando l'archiviazione degli screenshot è abilitata, le schermate acquisite durante le sessioni degli agenti vengono archiviate in un bucket Amazon S3. Il servizio MCP utilizza le credenziali dell'agente di connessione per caricare schermate nel bucket. L'agente deve disporre dell's3:PutObjectautorizzazione per il bucket.
Layout dello schermo del desktop
È possibile configurare la risoluzione dello schermo e il formato dell'immagine per l'ambiente di streaming degli agenti:
-
Risoluzione dello schermo: la risoluzione dello schermo per l'ambiente di streaming degli agenti. La risoluzione supportata è 1280x720.
-
Tipo di immagine dello schermo: il formato dell'immagine per le schermate degli agenti. Puoi scegliere PNG o JPEG.
Archiviazione della cartella Home
Puoi abilitare le cartelle home in modo che i file degli agenti vengano salvati in un bucket Amazon S3 nel tuo AWS account. Il parco Amazon WorkSpaces Applications associato allo stack deve consentire l'accesso ad Amazon S3 tramite Internet o un endpoint Amazon S3 VPC. Per ulteriori informazioni, consulta Abilitare e amministrare le home folder per i tuoi utenti.
Persistenza delle impostazioni dell'applicazione
Facoltativamente, è possibile abilitare la persistenza delle impostazioni dell'applicazione. Se abilitata, le personalizzazioni dell'applicazione e le impostazioni di Windows dell'agente vengono salvate dopo ogni sessione di streaming e applicate durante la sessione successiva. Queste impostazioni vengono salvate in un bucket Amazon S3 nel tuo account. AWS Il parco WorkSpaces applicazioni Amazon associato allo stack deve consentire l'accesso ad Amazon S3 tramite Internet o un endpoint Amazon S3 VPC. Per ulteriori informazioni, consulta Abilita la persistenza delle impostazioni delle applicazioni per i tuoi utenti.
Inoltro tramite strumenti MCP
È possibile abilitare l'inoltro degli strumenti MCP per consentire agli agenti di interagire con le applicazioni e il sistema operativo desktop tramite chiamate MCP dirette anziché utilizzare strumenti informatici. Se abilitati, gli strumenti MCP disponibili nella sessione WorkSpaces dell'applicazione vengono inoltrati all'agente. Gli strumenti inoltrati vengono visualizzati quando l'agente elenca gli strumenti disponibili.
Modalità di controllo utente
È possibile abilitare la modalità di controllo utente per consentire agli utenti di osservare e interagire con le sessioni degli agenti in tempo reale. Quando la modalità di controllo utente è abilitata, gli osservatori si connettono alla sessione tramite il browser utilizzando un URL di streaming. Vedono una visualizzazione in tempo reale del desktop mentre l'agente interagisce con esso.
In VIEW_STOP modalità, nella parte superiore dello schermo dell'osservatore viene visualizzato un pulsante di arresto. L'osservatore può utilizzare questo pulsante per fermare l'agente, se necessario. Una volta fermato, un agente deve iniziare una nuova sessione per riprendere il lavoro.
Imposta l'UserControlModeattributo AgentAccessConfig su uno dei seguenti valori:
-
VIEW_ONLY— Gli utenti possono visualizzare e osservare le azioni degli agenti in tempo reale. -
VIEW_STOP— Gli utenti possono visualizzare le azioni dell'agente e arrestare l'agente se necessario. -
DISABLED— Gli utenti non possono visualizzare o interrompere la sessione dell'agente.
URL di streaming
Gli agenti si connettono alle WorkSpaces applicazioni tramite un URL di streaming. Si genera un URL di streaming utilizzando l'CreateStreamingURLAPI. Non sono richiesti parametri specifici dell'agente. Il comportamento specifico dell'agente è determinato dalla configurazione di accesso dell'agente dello stack. L'URL di streaming viene passato al servizio MCP come intestazione su ogni richiesta.
Per ulteriori informazioni sull'CreateStreamingURLAPI, consulta CreateStreaming l'URL nell'API Reference di Amazon AppStream 2.0.
Proxy MCP per AWS
Per connettere il tuo agente al servizio MCP gestito, puoi utilizzare il mcp-proxy-for-aws trasporto per creare un client MCP che supporti la firma SIGv4 delle richieste MCP in Python. Se stai creando un agente in un'altra lingua, devi scrivere tu stesso la logica di firma o trovare una libreria disponibile.
Per ulteriori informazioni, consulta https://github.com/aws/mcp-proxy-for-aws
Monitoraggio
È possibile monitorare l'attività degli agenti tramite i seguenti servizi:
-
AWS CloudTrail— Gli eventi della sessione dell'agente vengono registrati. CloudTrail È possibile visualizzare quando gli agenti si connettono, quali strumenti utilizzano e quando terminano le sessioni. Le chiamate agli strumenti sono eventi relativi ai dati e richiedono l'impostazione di un percorso per la registrazione degli eventi relativi ai dati. Per ulteriori informazioni, consultare Registrazione di eventi di dati nella Guida per l'utente di CloudTrail .
-
CloudWatch— Le seguenti metriche operative sono disponibili nelle sessioni CloudWatch degli agenti:
InvocationsLatencyClientErrorsServerErrorsMcpSessionStartMcpSessionDuration
-
Amazon S3 — Se configuri l'archiviazione degli screenshot, gli screenshot acquisiti durante le sessioni degli agenti sono disponibili nel bucket Amazon S3 specificato.
