기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
WorkSpaces에 액세스하는 에이전트에 대해 자세히 알아보기
Amazon WorkSpaces 애플리케이션을 사용하면 에이전트가 관리형 모델 컨텍스트 프로토콜(MCP) 서비스를 통해 스트리밍 세션에 연결하고 데스크톱 애플리케이션과 상호 작용할 수 있습니다. 이 주제에서는 에이전트가 WorkSpaces 애플리케이션에 액세스하는 방법과 구성할 수 있는 기능에 대해 설명합니다.
사전 조건
에이전트 액세스를 사용하려면 다음이 필요합니다.
-
활성 Amazon WorkSpaces 애플리케이션 플릿(항상 켜짐 또는 온디맨드). 플릿을 생성하지 않은 경우 단원을 참조하십시오Amazon WorkSpaces 애플리케이션 시작하기: 샘플 애플리케이션으로 설정.
-
플릿과 연결된 스택입니다. 에이전트는 연결된 플릿 없이 스택에 연결할 수 없습니다.
-
Amazon WorkSpaces 애플리케이션 스택을 생성하고 관리할 수 있는 권한이 있는 AWS 계정입니다.
-
스크린샷 스토리지를 활성화하려는 경우 Amazon S3 버킷입니다. 버킷 정책은 AppStream 서비스 보안 주체에게 버킷을 나열할 수 있는 액세스 권한을 부여해야 합니다. MCP 서비스에 연결하는 에이전트는 버킷에 대한
s3:PutObject권한이 있어야 합니다. -
최신 WorkSpaces Applications Agent를 실행하는 플릿입니다. WorkSpaces Applications Agent 업데이트에 대한 자세한 내용은 섹션을 참조하세요Amazon WorkSpaces 애플리케이션 이미지를 Up-to-Date 유지. 에이전트 버전 관리에 대한 자세한 내용은 에이전트 버전 관리를 참조하세요.
제한 사항
WorkSpaces 에이전트 액세스 구성에는 다음과 같은 제한 사항이 있습니다.
-
Windows Server 이미지만 지원됩니다.
-
VPC 엔드포인트는 지원되지 않습니다.
-
다중 세션 플릿은 지원되지 않습니다.
-
탄력적 플릿은 지원되지 않습니다.
에이전트 액세스 작동 방식
스택을 생성할 때 에이전트 액세스를 활성화합니다. 에이전트 액세스가 활성화되면 스택은 인간 사용자를 위한 Amazon WorkSpaces 애플리케이션 구성 대신 에이전트별 설정으로 구성됩니다. Amazon WorkSpaces 애플리케이션 콘솔 AWS CLI또는 API를 통해 에이전트 액세스를 활성화할 수 있습니다.
컴퓨터 입력 및 비전
에이전트 액세스는 스택 수준에서 구성하는 두 가지 상호 작용 기능을 제공합니다.
-
컴퓨터 입력 - 에이전트가 스트리밍 세션 중에 버튼을 클릭하고, 텍스트를 입력하고, 데스크톱에서 스크롤할 수 있습니다.
-
컴퓨터 비전 - 에이전트가 스트리밍 세션 중에 스크린샷을 찍어 데스크톱을 볼 수 있습니다.
이러한 기능 중 하나 이상을 활성화해야 합니다.
스크린샷 스토리지
선택적으로 에이전트 세션에 대한 스크린샷 스토리지를 구성할 수 있습니다. 스크린샷 스토리지가 활성화되면 에이전트 세션 중에 캡처된 스크린샷이 Amazon S3 버킷에 저장됩니다. MCP 서비스는 연결 에이전트의 자격 증명을 사용하여 버킷에 스크린샷을 업로드합니다. 에이전트는 버킷에 대한 s3:PutObject 권한이 있어야 합니다.
데스크톱 화면 레이아웃
에이전트 스트리밍 환경에 대한 화면 해상도 및 이미지 형식을 구성합니다.
-
화면 해상도 - 에이전트 스트리밍 환경의 디스플레이 해상도입니다. 지원되는 해상도는 1280x720입니다.
-
화면 이미지 유형 - 에이전트 화면 캡처의 이미지 형식입니다. PNG 또는 JPEG를 선택할 수 있습니다.
홈 폴더 스토리지
에이전트 파일이 AWS 계정의 Amazon S3 버킷에 저장되도록 홈 폴더를 활성화할 수 있습니다. 스택과 연결된 Amazon WorkSpaces 애플리케이션 플릿은 인터넷 또는 Amazon S3 VPC 엔드포인트를 통해 Amazon S3에 대한 액세스를 허용해야 합니다. 자세한 내용은 사용자에 대한 홈 폴더 활성화 및 관리를 참조하세요.
애플리케이션 설정 지속성
선택적으로 애플리케이션 설정 지속성을 활성화할 수 있습니다. 활성화하면 에이전트의 애플리케이션 사용자 지정 및 Windows 설정이 각 스트리밍 세션 후에 저장되고 다음 세션 중에 적용됩니다. 이러한 설정은 AWS 계정의 Amazon S3 버킷에 저장됩니다. 스택과 연결된 Amazon WorkSpaces 애플리케이션 플릿은 인터넷 또는 Amazon S3 VPC 엔드포인트를 통해 Amazon S3에 대한 액세스를 허용해야 합니다. 자세한 내용은 사용자에 대한 애플리케이션 설정 지속성 활성화를 참조하세요.
MCP 도구 전달
MCP 도구 전달을 활성화하면 에이전트가 컴퓨터 사용 도구를 사용하는 대신 직접 MCP 호출을 통해 애플리케이션 및 데스크톱 운영 체제와 상호 작용할 수 있습니다. 활성화하면 WorkSpaces 애플리케이션 세션에서 사용할 수 있는 MCP 도구가 에이전트에게 전달됩니다. 전달된 도구는 에이전트가 사용 가능한 도구를 나열할 때 나타납니다.
사용자 제어 모드
사용자 제어 모드를 활성화하면 사용자가 에이전트 세션을 실시간으로 관찰하고 상호 작용할 수 있습니다. 사용자 제어 모드가 활성화되면 관찰자는 스트리밍 URL을 사용하여 브라우저를 통해 세션에 연결합니다. 에이전트가 데스크톱과 상호 작용할 때 데스크톱을 실시간으로 볼 수 있습니다.
VIEW_STOP 모드에서는 관찰자 화면 상단에 중지 버튼이 나타납니다. 필요한 경우 관찰자는이 버튼을 사용하여 에이전트를 중지할 수 있습니다. 에이전트가 중지되면 작업을 재개하려면 새 세션을 시작해야 합니다.
의 UserControlMode 속성을 다음 값 중 AgentAccessConfig 하나로 설정합니다.
-
VIEW_ONLY- 사용자는 에이전트 작업이 발생할 때 이를 보고 관찰할 수 있습니다. -
VIEW_STOP- 사용자는 에이전트 작업을 보고 필요한 경우 에이전트를 중지할 수 있습니다. -
DISABLED- 사용자는 에이전트 세션을 보거나 중지할 수 없습니다.
스트리밍 URLs
에이전트는 스트리밍 URL을 통해 WorkSpaces 애플리케이션에 연결합니다. CreateStreamingURL API를 사용하여 스트리밍 URL을 생성합니다. 에이전트별 파라미터는 필요하지 않습니다. 에이전트별 동작은 스택의 에이전트 액세스 구성에 따라 결정됩니다. 스트리밍 URL은 각 요청에 대한 헤더로 MCP 서비스에 전달됩니다.
CreateStreamingURL API에 대한 자세한 내용은 Amazon AppStream 2.0 API 참조의 CreateStreamingURL을 참조하세요. Amazon AppStream 2.0
AWS용 MCP 프록시
에이전트를 관리형 MCP 서비스에 연결하려면 mcp-proxy-for-aws 전송을 사용하여 Python에서 MCP 요청의 SigV4 서명을 지원하는 MCP 클라이언트를 생성할 수 있습니다. 다른 언어로 에이전트를 구축하는 경우 서명 로직을 직접 작성하거나 사용 가능한 라이브러리를 찾아야 합니다.
자세한 내용은 GitHub의 mcp-proxy-for-aws
모니터링
다음 서비스를 통해 에이전트 활동을 모니터링할 수 있습니다.
-
AWS CloudTrail - 에이전트 세션 이벤트는 CloudTrail에 기록됩니다. 에이전트가 연결되는 시간, 에이전트가 사용하는 도구 및 세션이 종료되는 시간을 볼 수 있습니다. 도구 호출은 데이터 이벤트이며 데이터 이벤트를 로깅하도록 추적을 설정해야 합니다. 자세한 내용은 CloudTrail 사용 설명서의 데이터 이벤트 로깅을 참조하세요.
-
CloudWatch - CloudWatch에서 에이전트 세션에 사용할 수 있는 운영 지표는 다음과 같습니다.
InvocationsLatencyClientErrorsServerErrorsMcpSessionStartMcpSessionDuration
-
Amazon S3 - 스크린샷 스토리지를 구성하면 에이전트 세션 중에 캡처된 스크린샷을 지정한 Amazon S3 버킷에서 사용할 수 있습니다.
