Inizia a fornire agli agenti l'accesso alle applicazioni WorkSpaces

Per consentire agli agenti AI di gestire le applicazioni desktop tramite Amazon WorkSpaces Applications, devi creare uno stack con accesso abilitato per gli agenti, generare un URL di streaming e connettere il tuo agente al servizio 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 dell'agente. L'esperienza di avvio rapido è disponibile nel GitHub repository: sample-code-for-workspaces-agent-access.

Il completamento di questo tutorial richiede circa 15 minuti.

Importante

Le risorse che crei in questo tutorial potrebbero comportare addebiti sul tuo AWS account. Elimina lo stack e ferma la flotta quando hai finito per evitare addebiti continui.

In questo tutorial, completerai le seguenti attività:

• Fase 1: Creare uno stack con l'accesso dell'agente abilitato

• Fase 2: Generazione di un URL di streaming

• Fase 3: Collega il tuo agente al servizio MCP

• Fase 4: Verifica l'attività dell'agente

• Fase 5: eliminazione delle risorse

Prerequisiti

Prima di iniziare, assicurati di disporre di:

• Una flotta di WorkSpaces applicazioni Amazon attiva. Se non ne hai ancora configurato uno, consultaInizia a usare Amazon WorkSpaces Applications: Configurazione con applicazioni di esempio.

• AWS credenziali (variabili di ambiente, AWS profilo, ruolo dell'istanza EC2 o ruolo di esecuzione Lambda) con le seguenti autorizzazioni IAM:

  {
      "Sid": "MCP",
      "Effect": "Allow",
      "Action": ["agentaccess-mcp:*"],
      "Resource": "*"
  },
  {
      "Sid": "AppStream",
      "Effect": "Allow",
      "Action": ["appstream:CreateStreamingURL", "appstream:DescribeFleets"],
      "Resource": "*"
  }

• Un framework di agenti. MCP-compatible L'agente deve essere in grado di effettuare richieste HTTP SigV4-signed Streamable all'endpoint MCP. L'SDK Strands Agents fornisce supporto client MCP nativo oppure puoi utilizzare qualsiasi framework con il trasporto mcp-proxy-for-aws.

• Python 3.10 o successivo. Non è richiesto alcun sistema operativo specifico.

Fase 1: Creare uno stack con l'accesso dell'agente abilitato

Crea uno stack di WorkSpaces applicazioni con accesso agli agenti abilitato per consentire agli agenti AI di interagire con le applicazioni desktop.

Utilizzo di AWS Console di gestione

Per creare uno stack con accesso da agente

1. Apri la console WorkSpaces Applicazioni.

2. Nel riquadro di navigazione a sinistra, scegli Stacks, quindi scegli Crea stack.

3. Nella pagina dei dettagli dello stack (passaggio 1 di 4), in Accesso all'agente AI, seleziona Abilita l'accesso all'agente AI. Scegli Next (Successivo).

4. Nella pagina Abilita lo storage (passaggio 2 di 4), abilita facoltativamente le cartelle Home per consentire al tuo agente di salvare i file in un bucket Amazon S3 del tuo account. AWS La flotta associata a questo stack deve consentire l'accesso ad Amazon S3 tramite Internet o un endpoint Amazon VPC per Amazon S3. Scegli Next (Successivo).

5. Nella pagina Modifica delle impostazioni dell'agente (passaggio 3 di 4), configura quanto segue:

   • Abilita l'input dal computer: consenti agli agenti di scegliere i pulsanti, inserire il testo e scorrere sul desktop. Se si abilita l'input da computer, è necessario abilitare anche la visione artificiale.

   • Abilita la visione artificiale: consenti agli agenti di vedere il desktop.

   • Archiviazione delle schermate: 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: seleziona la risoluzione dello schermo per l'ambiente di streaming dell'agente (1280x720).

   • Tipo di immagine dello schermo: seleziona il formato di immagine per le schermate dell'agente (PNG o JPEG).

   • Persistenza delle impostazioni dell'applicazione: abilita facoltativamente questa opzione per salvare le personalizzazioni delle applicazioni dell'agente e le impostazioni di Windows tra le sessioni. Le impostazioni vengono salvate in un bucket Amazon S3 nel tuo account. AWS

   Nota

   È necessario abilitare almeno uno degli input o della visione artificiale.

   Scegli Next (Successivo).

6. Nella pagina Revisione e creazione (passaggio 4 di 4), rivedi le impostazioni e scegli Create Stack.

Utilizzo di AWS CLI

Esegui il comando seguente per creare uno stack con accesso agente abilitato:

aws appstream create-stack \
    --name your-stack-name \
    --agent-access-config '{
        "Settings": [
            {"AgentAction": "COMPUTER_VISION", "Permission": "ENABLED"},
            {"AgentAction": "COMPUTER_INPUT", "Permission": "ENABLED"}
        ],
        "ScreenResolution": "W_1280xH_720",
        "ScreenImageFormat": "PNG"
    }'

Per abilitare anche l'archiviazione degli screenshot, aggiungi i parametri S3BucketArn andScreenshotsUploadEnabled:

aws appstream create-stack \
    --name your-stack-name \
    --agent-access-config '{
        "Settings": [
            {"AgentAction": "COMPUTER_VISION", "Permission": "ENABLED"},
            {"AgentAction": "COMPUTER_INPUT", "Permission": "ENABLED"}
        ],
        "ScreenResolution": "W_1280xH_720",
        "ScreenImageFormat": "PNG",
        "S3BucketArn": "arn:aws:s3:::your-bucket-name",
        "ScreenshotsUploadEnabled": true
    }'

Dopo aver creato lo stack, associalo a una flotta. Gli agenti non possono connettersi a uno stack a cui non è associata una flotta.

aws appstream associate-fleet \
    --stack-name your-stack-name \
    --fleet-name your-fleet-name

Fase 2: Generazione di un URL di streaming

Crea un URL di streaming utilizzando l'CreateStreamingURLAPI WorkSpaces Applications standard. Non sono necessari parametri specifici per l'agente. La configurazione di 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

1. Apri la console WorkSpaces Applicazioni.

2. Nel riquadro di navigazione a sinistra, scegli Stacks, quindi scegli lo stack che hai creato con l'accesso agente abilitato.

3. Scegli il pulsante Azioni e, nel menu a discesa, seleziona Crea URL di streaming. Il tuo stack deve essere selezionato affinché questa opzione sia disponibile.

4. Nella sezione UserID, inserisci un utente. Puoi entrare TestUser se stai testando.

5. Nella sezione Scadenza dell'URL, seleziona l'ora in cui desideri che l'URL sia valido. Si consiglia un periodo di tempo più breve. 30 minuti è l'impostazione predefinita e consigliata per il test.

6. Scegli getURL e copia l'URL generato.

Utilizzo di AWS CLI

Esegui il seguente comando per generare un URL di streaming:

aws appstream create-streaming-url \
    --stack-name your-stack-name \
    --fleet-name your-fleet-name \
    --user-id your-agent-id \
    --validity 3600

La risposta include un StreamingURL messaggio che trasmetterai al tuo agente nel passaggio successivo. L'URL è valido per la durata specificata dal --validity parametro.

Fase 3: Collega il tuo agente al servizio MCP

L'agente si connette al servizio MCP gestito al seguente endpoint fisso:

https://agentaccess-mcp.region.api.aws/mcp

La connessione utilizza la firma SigV4 con il nome del servizio. agentaccess-mcp L'URL di streaming dello Step 2 viene passato come intestazione per 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 dell'attività dell'agente

È possibile verificare l'attività dell'agente utilizzando i seguenti AWS servizi:

• AWS CloudTrail— AWS CloudTrail registra gli eventi della sessione dell'agente. Apri la AWS CloudTrail console per visualizzare l'attività dell'agente.

• CloudWatch— CloudWatch fornisce metriche operative per le sessioni degli agenti. Apri la CloudWatch console per visualizzare le metriche.

• Amazon S3: se hai abilitato l'archiviazione degli screenshot, Amazon S3 archivia 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

1. Apri la console WorkSpaces delle applicazioni.

2. Nel riquadro di navigazione a sinistra selezionare Fleets (Parchi istanze).

3. Seleziona la flotta associata allo stack. Scegliere Actions (Operazioni), Stop (Arresta). Attendi che la flotta si fermi.

4. Nel riquadro di navigazione a sinistra, selezionare Stacks (Stack).

5. Seleziona lo stack che hai creato e scegli Azioni, Dissocia flotta.

6. Con lo stack ancora selezionato, scegli Azioni, Elimina.

7. (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 \
    --name your-fleet-name

aws appstream disassociate-fleet \
    --stack-name your-stack-name \
    --fleet-name your-fleet-name

aws appstream delete-stack \
    --name your-stack-name

(Facoltativo) Per eliminare il parco veicoli anche dopo che si è fermato:

aws appstream delete-fleet \
    --name your-fleet-name