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 come gli agenti accedono alle WorkSpaces applicazioni e le funzionalità che puoi configurare.
Prerequisiti
Per utilizzare l'accesso tramite agente, è necessario quanto segue:
-
Una flotta di WorkSpaces applicazioni Amazon attiva (Always-On o On-Demand). Se non hai creato una flotta, consultaInizia a usare Amazon WorkSpaces Applications: Configurazione con applicazioni di esempio.
-
Uno stack associato a una flotta. Gli agenti non possono connettersi a uno stack senza una flotta associata.
-
Un AWS account con autorizzazioni per creare e gestire gli stack di Amazon WorkSpaces Applications.
-
Se prevedi di abilitare l'archiviazione degli screenshot, un bucket Amazon S3. La policy sui bucket deve concedere al AppStream servizio l'accesso principale ai bucket di elenco. L'agente che si connette al servizio MCP deve disporre dell'
s3:PutObjectautorizzazione sul bucket. -
Una flotta che esegue l'ultima versione di WorkSpaces Applications Agent. Per ulteriori informazioni sull'aggiornamento di WorkSpaces Applications Agent, consultaMantieni l'immagine WorkSpaces delle tue applicazioni Amazon Up-to-Date. Per informazioni sulla gestione delle versioni degli agenti, consulta Gestione delle versioni degli agenti.
Limitazioni
WorkSpaces le configurazioni di accesso agli 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.
Come funziona l'accesso agli agenti
L'accesso agli agenti viene abilitato quando si crea uno stack. Quando l'accesso agli agenti è abilitato, lo stack viene 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 dal computer: consente agli agenti di fare clic sui pulsanti, inserire testo e scorrere sul desktop durante una sessione di streaming.
-
Visione artificiale: consente agli agenti di visualizzare il desktop acquisendo schermate durante una sessione di streaming.
È necessario abilitare almeno una di queste funzionalità.
Archiviazione degli screenshot
Facoltativamente, puoi 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 dell'agente:
-
Risoluzione dello schermo: la risoluzione dello schermo per l'ambiente di streaming dell'agente. La risoluzione supportata è 1280x720.
-
Tipo di immagine dello schermo: il formato di immagine per le schermate degli agenti. Puoi scegliere PNG o JPEG.
Archiviazione nella cartella Home
Puoi abilitare le cartelle home in modo che i file dell'agente vengano salvati in un bucket Amazon S3 del tuo account. AWS La flotta di WorkSpaces applicazioni Amazon associata allo stack deve consentire l'accesso ad Amazon S3 tramite Internet o un endpoint VPC Amazon S3. Per ulteriori informazioni, consulta Abilita e amministra le home folder per i tuoi utenti.
Persistenza delle impostazioni dell'applicazione
Facoltativamente, è possibile abilitare la persistenza delle impostazioni dell'applicazione. Se abilitate, le personalizzazioni delle applicazioni dell'agente e le impostazioni di Windows 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 La flotta di WorkSpaces applicazioni Amazon associata allo stack deve consentire l'accesso ad Amazon S3 tramite Internet o un endpoint VPC Amazon S3. Per ulteriori informazioni, consulta Abilita la persistenza delle impostazioni delle applicazioni per i tuoi utenti.
Inoltro degli 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 per l'uso del computer. 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à, un pulsante di arresto appare nella parte superiore dello schermo dell'osservatore. 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 interromperlo 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. È possibile generare un URL di streaming utilizzando l'CreateStreamingURLAPI. Non sono richiesti parametri specifici per l'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 per ogni richiesta.
Per ulteriori informazioni sull'CreateStreamingURLAPI, consulta CreateStreamingl'URL nell'Amazon AppStream 2.0 API Reference.
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 state creando un agente in un'altra lingua, dovete scrivere voi stessi la logica di firma o trovare una libreria disponibile.
Per ulteriori informazioni, consulta 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 la configurazione di un percorso per registrare gli 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.
