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à.
Inizia a fornire agli agenti l'accesso a WorkSpaces Applicazioni
Per consentire agli agenti di intelligenza artificiale di gestire applicazioni desktop tramite Amazon WorkSpaces Applicazioni, crei uno stack con accesso abilitato per gli agenti, generi un URL di streaming e connetti il tuo agente al server MCP gestito.
Se stai configurando l'accesso degli agenti per la prima volta, puoi utilizzare l'esperienza di avvio rapido Build Your First Agent. Puoi anche seguire i passaggi descritti in questo argomento per configurare manualmente l'accesso degli agenti. L'esperienza di avvio rapido è disponibile in GitHub archivio — codice di esempio per l'accesso agli agenti degli spazi di lavoro
Il completamento di questo tutorial richiede circa 15 minuti.
Le risorse che crei in questo tutorial potrebbero comportare costi per il tuo AWS account. Elimina la pila e ferma la flotta quando hai finito per evitare addebiti continui.
In questo tutorial, completi le seguenti attività:
Passaggio 1: creare uno stack con l'accesso agli agenti abilitato
Passaggio 2: generare un URL di streaming
Fase 3: Connetti il tuo agente al server MCP
Fase 4: Verifica l'attività dell'agente
Fase 5: eliminazione delle risorse
Scrivi il codice dell'agente con l'Agent Toolkit for AWS
Se crei il tuo agente con un assistente di codifica AI, puoi usare Agent Toolkit per AWS
Il toolkit utilizza AWS Server MCP. Questo server gestito offre agli agenti un accesso sicuro a AWS tramite il Model Context Protocol (MCP). Gli agenti possono eseguire AWS CLI comandi, ricerca AWS documenti e segui competenze già pronte. Si connettono tramite un unico endpoint sicuro. Ottieni anche CloudWatch metriche e controlli di accesso IAM.
Per iniziare, chiedi al tuo agente: «Aiutami a completare la guida introduttiva WorkSpaces tutorial sull'accesso degli agenti».
Prerequisiti
Prima di iniziare, consulta i requisiti di accesso degli agenti. Per i prerequisiti relativi all'account, alla flotta, alle autorizzazioni e agli agenti, consulta Prerequisiti.
Fase 1: Creare uno stack con accesso agli agenti abilitato
Crea un WorkSpaces Stack di applicazioni con accesso agli agenti abilitato per consentire agli agenti di intelligenza artificiale di interagire con le applicazioni desktop.
Utilizzo di AWS Console di gestione
Per creare uno stack con accesso da agente
-
Aprire il WorkSpaces Console delle applicazioni
. -
Nel riquadro di navigazione a sinistra, scegli Pile, quindi scegli Crea una pila.
-
Sul Dettagli dello stack pagina (passaggio 1 di 4), sotto accesso agli agenti AI, seleziona Abilita l'accesso agli agenti AI. Scegli Avanti.
-
Sul Abilita l'archiviazione pagina (passaggio 2 di 4), abilita facoltativamente Cartelle Home per consentire al tuo agente di salvare i file in un bucket Amazon S3 nel tuo AWS account. La flotta associata a questo stack deve consentire l'accesso ad Amazon S3 tramite Internet o un endpoint Amazon VPC per Amazon S3. Scegli Avanti.
-
Sul Modifica le impostazioni dell'agente pagina (passaggio 3 di 4), configura quanto segue:
-
Abilita l'input del computer — Consenti agli agenti di scegliere i pulsanti, inserire testo e scorrere sul desktop. Se abiliti l'input dal computer, devi abilitare anche la visione artificiale.
-
Abilita la visione artificiale — Consenti agli agenti di vedere il desktop.
-
- Archiviazione — Configura dove vengono archiviate le schermate degli agenti durante le sessioni di streaming. Se abilitato, fornisci un bucket Amazon S3 su cui disponi delle autorizzazioni di scrittura.
-
Risoluzione dello schermo — Selezionare la risoluzione dello schermo per l'ambiente di streaming dell'agente (1280x720).
-
Tipo di immagine sullo schermo — Seleziona il formato dell'immagine per le schermate degli agenti (PNG o JPEG).
-
- Persistenza delle impostazioni dell'applicazione — Facoltativamente, abilita questa opzione per salvare le personalizzazioni dell'applicazione dell'agente e le impostazioni di Windows tra una sessione e l'altra. Le impostazioni vengono salvate in un bucket Amazon S3 nel tuo AWS account. Questa impostazione è disponibile su Windows e non è supportata su Linux.
-
Abilita l'inoltro degli strumenti MCP — Consenti 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 configurati su WorkSpaces la sessione dell'applicazione viene inoltrata all'agente. L'inoltro degli strumenti richiede anche un file di configurazione sull'immagine. Per il percorso e le fasi di configurazione specifici della piattaforma, vedi Impostazione dell'inoltro degli strumenti.
-
Abilita la modalità di controllo utente — Consenti agli utenti di osservare le sessioni degli agenti in tempo reale tramite il proprio browser. Gli osservatori vedono una visualizzazione in tempo reale del desktop mentre l'agente lavora. In modalità VIEW_STOP, gli osservatori possono fermare l'agente utilizzando un pulsante nella parte superiore dello schermo. Dopo l'arresto, l'agente deve iniziare una nuova sessione per riprenderla.
NotaÈ necessario abilitare almeno uno degli input del computer o della visione artificiale.
Scegli Avanti.
-
-
Sul Rivedi e crea pagina (passaggio 4 di 4), rivedi le impostazioni e scegli Crea una pila.
Utilizzo di AWS CLI
Esegui il comando seguente per creare uno stack con l'accesso agli agenti abilitato:
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" }'
Per abilitare anche l'archiviazione delle schermate, aggiungi S3BucketArn e ScreenshotsUploadEnabled parametri:
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 }'
Dopo aver creato la pila, associala a una flotta. Gli agenti non possono connettersi a uno stack a cui non è associata una flotta.
aws appstream associate-fleet \ --stack-nameyour-stack-name\ --fleet-nameyour-fleet-name
Fase 2: Genera un URL di streaming
Crea un URL di streaming utilizzando lo standard WorkSpaces Applicazioni CreateStreamingURL API. Non sono necessari parametri specifici dell'agente. La configurazione dell'accesso agli agenti dello stack determina il comportamento specifico dell'agente.
Utilizzo di AWS Console di gestione
Per generare un URL di streaming utilizzando la console
-
Aprire il WorkSpaces Console delle applicazioni
. -
Nel riquadro di navigazione a sinistra, scegli Pile, quindi scegli lo stack che hai creato con l'accesso agli agenti abilitato.
-
Scegli il Azioni pulsante e, nel menu a discesa, seleziona Crea un URL di streaming. Il tuo stack deve essere selezionato perché questa opzione sia disponibile.
-
Nel ID utente sezione, inserisci un utente. Puoi entrare
TestUserse stai testando. -
Nel Scadenza dell'URL sezione, seleziona l'ora in cui desideri che l'URL sia valido. Si consiglia un tempo più breve. L'impostazione predefinita è 30 minuti, che è consigliata per i test.
-
Scegli Ottieni URL e copia l'URL generato.
Utilizzo di AWS CLI
Esegui il comando seguente per generare un URL di streaming:
aws appstream create-streaming-url \ --stack-nameyour-stack-name\ --fleet-nameyour-fleet-name\ --user-idyour-agent-id\ --validity 3600
La risposta include un StreamingURL che trasmetti al tuo agente nella fase successiva. L'URL è valido per la durata specificata dal --validity parametro.
In qualsiasi momento, solo un agente può connettersi a una sessione unica. Utenti denominati, specificati tramite UserId parametro, può avere una sola sessione attiva per flotta alla volta. Per eseguire più agenti contemporaneamente, ogni agente deve connettersi alla propria sessione univoca.
Fase 3: Connetti il tuo agente al server MCP
L'agente si connette al server MCP gestito al seguente endpoint fisso:
https://agentaccess-mcp.region.api.aws/mcp
Sostituisci region con il tuo codice regionale. Per le regioni supportate e i relativi endpoint, consulta WorkSpaces Applicazioni: endpoint MCP.
La connessione utilizza la firma SIGv4 con il nome del servizio agentaccess-mcp. Il tuo agente firma ogni richiesta utilizzando AWS
credenziali configurate nei prerequisiti con agentaccess-mcp:* autorizzazioni. L'URL di streaming del passaggio 2 viene passato come intestazione su ogni richiesta MCP.
L'esempio seguente mostra come stabilire la connessione utilizzando 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, }, )
Dopo la connessione, l'agente può utilizzare gli strumenti MCP per inserire testo, scegliere i pulsanti e acquisire schermate del desktop.
Fase 4: Verifica l'attività dell'agente
È possibile verificare l'attività dell'agente utilizzando quanto segue AWS servizi:
-
AWS CloudTrail — AWS CloudTrail registra gli eventi della sessione dell'agente. Aprire il AWS CloudTrail console per visualizzare l'attività degli agenti. Le chiamate agli strumenti vengono registrate come eventi di dati, il che richiede un percorso configurato per registrare gli eventi relativi ai dati.
-
CloudWatch — CloudWatch fornisce metriche operative per le sessioni degli agenti. Aprire il CloudWatch console per visualizzare le metriche.
-
Amazon S3 — Se hai abilitato l'archiviazione degli screenshot, Amazon S3 memorizza gli screenshot nel bucket specificato durante la configurazione dello stack.
Fase 5: eliminazione delle risorse
Per evitare addebiti continui, elimina lo stack che hai creato in questo tutorial. Devi fermare la flotta e dissociarla dalla pila prima di poter eliminare la pila. Facoltativamente, puoi anche eliminare la flotta.
Utilizzo di AWS Console di gestione
Per eliminare le risorse
-
Aprire il WorkSpaces Console delle applicazioni
. -
Nel riquadro di navigazione a sinistra selezionare Fleets (Parchi istanze).
-
Seleziona la flotta associata alla pila. Scegliere Actions (Operazioni), Stop (Arresta). Attendi che la flotta si fermi.
-
Nel riquadro di navigazione a sinistra, selezionare Stacks (Stack).
-
Seleziona lo stack che hai creato e scegli Azioni, Flotta dissociata.
-
Con la pila ancora selezionata, scegli Azioni, Elimina.
-
(Facoltativo) Per eliminare la flotta, nel riquadro di navigazione a sinistra, scegli Flotte. Seleziona la flotta e scegli Azioni, Elimina.
Utilizzo di AWS CLI
Esegui i seguenti comandi per ripulire le risorse:
aws appstream stop-fleet \ --nameyour-fleet-nameaws appstream disassociate-fleet \ --stack-nameyour-stack-name\ --fleet-nameyour-fleet-nameaws appstream delete-stack \ --nameyour-stack-name
(Facoltativo) Per eliminare anche il parco veicoli dopo che è stato fermato:
aws appstream delete-fleet \ --nameyour-fleet-name