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 alle applicazioni WorkSpaces

Per consentire agli agenti di intelligenza artificiale di gestire le applicazioni desktop tramite Amazon WorkSpaces Applications, crei uno stack con accesso abilitato per gli agenti, generi un URL di streaming e connetti 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 degli agenti. L'esperienza di avvio rapido è disponibile nel GitHub repository: sample-code-for-workspaces-agent-access. https://github.com/aws-samples/sample-code-for-workspaces-agent-access

Il completamento di questo tutorial richiede circa 15 minuti.

In questo tutorial, completi le seguenti attività:

Prerequisiti

Prima di iniziare, assicurati di disporre di:

Passaggio 1: creare uno stack con l'accesso agli agenti 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

Utilizzo di AWS CLI

Esegui il comando seguente per creare uno stack con l'accesso agli agenti abilitato:

aws appstream create-stack \
    --name your-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, aggiungete i ScreenshotsUploadEnabled parametri S3BucketArn and:

aws appstream create-stack \
    --name your-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 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: Genera un URL di streaming

Crea un URL di streaming utilizzando l'CreateStreamingURLAPI standard WorkSpaces delle applicazioni. 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

Utilizzo di AWS CLI

Esegui il comando seguente 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 trasmetti al tuo agente nel passaggio successivo. L'URL è valido per la durata specificata dal --validity parametro.

Fase 3: Connetti il tuo agente al servizio MCP

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

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

La connessione utilizza la firma SIGv4 con il nome del servizio. agentaccess-mcp L'agente firma ogni richiesta utilizzando le AWS credenziali configurate nei prerequisiti con le autorizzazioni. agentaccess-mcp:* 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à degli agenti utilizzando i seguenti AWS servizi:

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

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 anche il parco veicoli dopo che è stato fermato:

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