연결 모드

모델 컨텍스트 프로토콜(MCP) 요청에서 x-amzn-agentaccess-connect-mode 헤더를 설정하여 에이전트가 데스크톱 세션을 사용할 수 있을 때까지 기다리는 방법을 제어할 수 있습니다.

참고

연결 모드는 non-domain-joined 플릿과 도메인에 조인된 플릿 모두에 적용됩니다. 플릿 유형이 사용하는 인증 메커니즘과 함께 x-amzn-agentaccess-connect-mode 헤더를 설정합니다. non-domain-joined 플릿의 경우 스택 및 사용자 ID 헤더 또는 스트리밍 URL 헤더입니다. 도메인에 조인된 플릿의 경우 SAML 어설션 메타데이터입니다.

다음 모드를 사용할 수 있습니다.

• 차단(기본값): MCP 서버는 데스크톱 연결이 완전히 설정될 때까지 기다렸다가 응답합니다. 가 tools/list 반환되면 모든 도구를 즉시 사용할 수 있습니다.

• POLLING: MCP 서버는 데스크톱 연결을 기다리지 않고 즉시 응답합니다. 처음에는 connection_status 도구만 사용할 수 있습니다. 에이전트는 연결이 설정되고 전체 도구 세트를 사용할 수 있게 될 때까지이 도구를 폴링합니다.

데스크톱 연결을 기다리는 동안 에이전트가 다른 작업을 수행하도록 하거나 연결 제한 시간 동작을 더 잘 제어해야 하는 경우 POLLING 모드를 사용합니다.

다음 예제에서는 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()

정리: 지속적인 스트리밍 요금을 방지하려면 에이전트가 작업을 완료하면 WorkSpaces 애플리케이션 스트리밍 세션을 종료합니다. 세션이 닫히도록 에이전트를 연결 해제하고 유휴 세션을 실행 상태로 두지 마십시오.