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à.

# Modalità di connessione
<a name="agent-access-mcp-server-connect-mode"></a>

Puoi controllare il modo in cui il tuo agente attende che la sessione desktop diventi disponibile impostando il `x-amzn-agentaccess-connect-mode` intestazione delle richieste Model Context Protocol (MCP).

**Nota**  
Le modalità di connessione si applicano sia alle flotte non aggiunte a un dominio che a quelle aggiunte a un dominio. Imposta il `x-amzn-agentaccess-connect-mode` intestazione insieme al meccanismo di autenticazione utilizzato dal tuo tipo di flotta. Per le flotte non appartenenti a un dominio, si tratta delle intestazioni dello stack e degli ID utente o di un'intestazione Streaming-URL. Per le flotte unite a un dominio, si tratta dei metadati delle asserzioni SAML.

Sono disponibili le seguenti modalità:
+ **BLOCCANDO** (impostazione predefinita): il server MCP attende che la connessione desktop sia completamente stabilita prima di rispondere. Quando `tools/list` ritorna, tutti gli strumenti sono immediatamente disponibili.
+ **SONDAGGI**: il server MCP risponde immediatamente senza attendere la connessione al desktop. Inizialmente, solo `connection_status` lo strumento è disponibile. L'agente esegue il polling di questo strumento fino a quando non viene stabilita la connessione, dopodiché il set completo di strumenti diventa disponibile.

Utilizzate la modalità POLLING quando desiderate che il vostro agente esegua altre operazioni in attesa della connessione al desktop o quando avete bisogno di un maggiore controllo sul comportamento di timeout della connessione.

L'esempio seguente mostra come utilizzare la modalità POLLING:

```
# Pass the header when creating the MCP connection
headers = {
    "x-amzn-agentaccess-streaming-session-url": streaming_url,  # non-domain-joined fleets
    "x-amzn-agentaccess-connect-mode": "POLLING",
}

# After initialize, tools/list returns immediately with connection_status
tools = await session.list_tools()
# tools = [connection_status]

# Poll connection_status until the desktop is ready
while True:
    result = await session.call_tool("connection_status", {})
    status = json.loads(result.content[0].text)
    if status["state"] == "CONNECTED":
        break
    time.sleep(2)

# Now tools/list returns the full set (screenshot, left_click, type_text, and so on)
tools = await session.list_tools()
```

**Pulisci**: per evitare costi di streaming continui, interrompi il WorkSpaces Sessione di streaming delle applicazioni quando l'agente termina il suo lavoro. Disconnetti l'agente in modo che la sessione si chiuda e non lasciare le sessioni inattive in esecuzione.