Modos de conexión

Puede controlar el tiempo en que su agente espera a que la sesión de escritorio esté disponible configurando x-amzn-agentaccess-connect-mode el encabezado de sus solicitudes del Protocolo de contexto modelo (MCP).

nota

Los modos de conexión se aplican tanto a las flotas que no están unidas a un dominio como a las que están unidas a un dominio. Configure el x-amzn-agentaccess-connect-mode el encabezado junto con el mecanismo de autenticación que utilice su tipo de flota. En el caso de las flotas que no están unidas a un dominio, se trata de los encabezados de pila e ID de usuario o de un encabezado de URL de transmisión. En el caso de las flotas unidas a un dominio, son los metadatos de la aserción de SAML.

Están disponibles los siguientes modos:

• BLOQUEANDO (predeterminado): el servidor MCP espera hasta que la conexión al escritorio esté completamente establecida antes de responder. ¿Cuándo tools/list devoluciones, todas las herramientas están disponibles de inmediato.

• SONDEO: el servidor MCP responde inmediatamente sin esperar a que se conecte al escritorio. Inicialmente, solo el connection_status la herramienta está disponible. Su agente sondea esta herramienta hasta que se establezca la conexión, momento en el que estará disponible todo el conjunto de herramientas.

Utilice el modo POLLING cuando desee que su agente realice otras tareas mientras espera a que se establezca la conexión desde el escritorio o cuando necesite controlar mejor el comportamiento del tiempo de espera de la conexión.

El siguiente ejemplo muestra cómo usar el modo 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()

Limpiar: Para evitar los continuos cargos por streaming, finaliza el WorkSpaces Sesión de streaming de aplicaciones cuando su agente termine su trabajo. Desconecte el agente para que se cierre la sesión y no deje las sesiones inactivas en ejecución.