Windows용 ScreenAgent

ScreenAgent NICE ScreenAgent는 화면 녹화가 필요한 상담원 데스크톱에서 운영하는 서비스입니다.는 CXone Recording 고급 및 화면 녹화 라이선스가 있을 경우에만 사용 가능합니다.

컴퓨터에 ScreenAgent을(를) 설치하여 상호작용 중에 상담원의 화면에서 일어나는 활동을 기록하고 모니터링합니다. ScreenAgent은(는) 백그라운드에서 실행되며 녹음/녹화 정책에 따라 자동으로 기록합니다(CXone Recording 참조). 수퍼바이저와 평가자는 또한 상호작용 중에 상담원의 활동을 모니터링할 수 있습니다.

CXone Recording Workforce Engagement (WEM)이 최신 기술을 활용해 원활한 고객 경험을 제공하도록 하려면 지원되는 ScreenAgent 버전을 사용해야 합니다.

Windows 버전 3.0.22 이상용 ScreenAgent
MAC 버전 3.0.1 이상용 ScreenAgent

ScreenAgent 이전 버전을 사용하고 있는 경우 모든 사용자를 ScreenAgent3.0.x 버전으로 업그레이드해야 합니다. 이전 버전은 지원되지 않으므로 상담원의 화면을 녹화하지 못할 수 있습니다.

다운로드 페이지에서 최신 버전의 ScreenAgent를 찾을 수 있습니다.

ScreenAgent 3.0.x 버전을 사용하려면 다음 FQDN을 허용했는지 확인합니다.

FedRamp의 경우: cxone-gov.niceincontact.com
기타 모든 지역의 경우: cxone.niceincontact.com

상담원의 컴퓨터나 가상 데스크톱 인프라(VDI) 환경에 ScreenAgent을(를) 설치할 수 있습니다. 지원되는 VDI는 다음과 같습니다.

VMware Horizon
Citrix Virtual Desktops(이전 명칭: XenDesktop)
Citrix Virtual Apps(이전 명칭: XenApp) - 온프레미스 환경에서만 지원됨
비지속적 VDI 환경
멀티 세션 환경
터미널-서버 유형 VDI 환경
AVD 원격 앱(VDI 원격 앱 해결 방법 필요)

VMware Horizon에는 특별 구성이 필요하지 않습니다. 기타 VDI 환경은 전제 조건을 참조하십시오.

설치 전 또는 후에 ScreenAgent 연결 검사할 수 있습니다.

100% 화면 녹화로 구성된 테넌트의 경우 상담원이 로그인한 후 최대 25초 후에 화면 녹화가 시작됩니다. 이 25초 동안에는 화면 녹화가 제대로 작동하지 않습니다.

상담원 컴퓨터에 ScreenAgent을(를) 설치하는 방법의 개요를 설명하는 비디오를 볼 수 있습니다. 비디오에서는 전제 조건과 설치 단계를 다룹니다.

자세한 내용은 ScreenAgent FAQ을(를) 참고하십시오.

이전 ScreenAgent 릴리스에 추가된 기능 목록은 ScreenAgent: 누적 릴리스 정보에서 확인하십시오.

전제 조건

ScreenAgent을(를) 설치하기 전에 다음을 확인하십시오.

연결 요구 사항을(를) 확인합니다. 방화벽이 자체 서명된 인증서를 생성하거나 HTTPS 패킷으로부터 요청 헤더를 제거한다면 ScreenAgent은(는) 기록하지 않습니다.
자신의 사이트에서 VDI를 사용한다면 다음을 확인하시기 바랍니다.
- ScreenAgent V3.x.x 이상을 사용하고 있습니다.
  - Citrix Virtual Apps 모드의 경우 다음을 실행합니다.
    
    Citrix는 클라우드 호스팅 머신에서 가상 IP 루프백 구성을 지원하지 않습니다. 이 기능은 ScreenAgent가 원격 애플리케이션으로 작동하는 데 필수적이므로 Citrix가 온프레미스 컴퓨터에서 작동하는 경우에만 지원됩니다.
    
    자세한 내용은 Citrix 설명서를 참조하십시오.
    - 가상 IP 루프백 정책을 활성화합니다. ScreenAgent.exe 및 Chrome.exe를 가상 IP 가상 루프백 프로그램 목록에 추가합니다. 각 프로그램은 다른 줄에 나열되어야 합니다.
    - Citrix Virtual Apps 서버에 ScreenAgent을(를) 설치합니다.
- 비지속적 VDI 환경:
  - ScreenAgent 버전 3.0.22 이상을 사용합니다.
  - VDI의 기본 이미지에 ScreenAgent을(를) 설치합니다.
  - 기본 이미지의 스냅샷 생성
  - 모든 VDI 인스턴스에 배포합니다.
- 다중 세션 환경 및 터미널 서버 유형 VDI 환경의 경우:
  - ScreenAgent 버전 3.0.22 이상을 사용합니다.
  - 로그인 모드에서 작동하도록 ScreenAgent을(를) 구성합니다.
  - 사용자는 OS 로그인 자격 증명을 사용하여 ScreenAgent에 로그인해야 합니다.
  각 직원 프로필의　OS 로그인 값은 고유해야 합니다. 일부 중복된 직원 프로필이 비활성화되어 있더라도 OS 로그인 값은 여러 직원 프로필에 사용할 수 없습니다. 여러 직원 프로필에 동일한 OS 로그인 값이 있는 경우, 해당 OS 로그인 값을 사용하는 모든 상담원에 대해 ScreenAgent가 실행되지 않습니다.
멀티 세션 환경 또는 비지속적 VDI 환경에서 작업 중인데 문제가 발생하면 NICE 지원 팀에 연락하여 현재 환경이 지원되는지 확인하십시오.

VMware Horizon 및 Citrix 가상 데스크톱 모드에는 특별 구성이 필요하지 않습니다.
상담원의 컴퓨터 구성을 확인하시기 바랍니다.
상담원 컴퓨터 요구 사항
- 상담원의 컴퓨터에 Microsoft .NET 4 이상 설치 완료.
- 상담원용 소프트폰 솔루션 중 하나:
  - CXone Agent.
  - ScreenAgent과(와) 동일한 컴퓨터에 설치된 Salesforce Agent 소프트폰.
  - MAX 소프트폰.
- 플랫폼 요구사항의 관련 컴퓨터 사양입니다.
  
  컴퓨터 구성은 풀 HD 또는 4K로 설정되어 있으며 CPU 사용량이 높습니다. 또한, 더 강력한 CPU(예: i5)가 필요할 수도 있습니다.
- 포트 31322가 열려 있습니다. 이 포트는 ScreenAgent와 상담원 컴퓨터의 MAX/CXone Agent/Salesforce Agent 소프트폰 간의 내부 통신에만 사용됩니다. OS 로그인을 사용할 때는 필요하지 않습니다.
ScreenAgent(예: 관리자)을(를) 설치하는 사용자에게는 상담원의 컴퓨터에서 관리자 권한이 있어야 합니다.
ScreenAgent(예: 관리자)을(를) 설치하는 사용자에게는 상담원의 컴퓨터에서 CXone 권한이 있어야 합니다.
- 지원 다운로드 액세스 가능: On. 이를 통해 지원 - 다운로드 페이지에 액세스할 수 있습니다.
- 액세스 키: 만들기. 이를 통해 조직의 액세스 키를 관리할 수 있습니다.
ScreenAgent의 액세스 키를 생성합니다.

테넌트의 모든 상담원 컴퓨터에 ScreenAgent을(를) 설치하기 위해 동일한 액세스 키를 사용할 수 있습니다.

액세스 키는 이를 생성하는 CXone 사용자의 모든 권한을 받습니다. 사용자가 관리자라면 액세스 키를 가진 모든 이는 관리자 권한을 가지게 됩니다. 따라서 보안상의 이유로 먼저 ScreenAgent을(를) 위한 CXone 사용자 및 역할을 생성한 뒤 ScreenAgent 사용자를 통해 키를 생성해야 합니다.
1. ScreenAgent 서비스를 위한 역할을 생성합니다.
  1. 앱 선택기 를 클릭하고 선택합니다.Admin.
  2. 보안 > 역할 및 권한으로 이동합니다.
  3. 새 역할을 클릭합니다.
  4. ScreenAgent 액세스 키와 같은 이름을 역할에 지정합니다.
  5. 액세스 키 및 내 액세스 키를 제외한 역할에 대한 모든 권한을 제거합니다.
  6. 프로필을 저장 및 활성화합니다.
2. ScreenAgent 서비스를 위해 직원을 생성합니다.
  1. 앱 선택기 를 클릭하고 선택합니다.Admin.
  2. 직원을 클릭합니다.
  3. 새 직원을 클릭합니다.
  4. ScreenAgent와 같은 이름을 직원에게 지정합니다.
  5. 기본 역할 드롭다운 목록에서 방금 생성한 ScreenAgent 액세스 키 역할을 선택합니다.
  6. 일반 탭에서 모든 속성을 지웁니다.
  7. ScreenAgent 직원을 생성합니다. 계정을 생성한 이후에만 액세스 키를 생성할 수 있습니다.
3. ScreenAgent 직원을 다시 열고 보안 탭으로 이동합니다. 액세스 키 추가를 클릭하여 액세스 키를 생성합니다.
4. 액세스 키 ID 및 비밀 액세스 키를 모두 복사하여 안전한 장소에 저장합니다. 비밀 액세스 키를 복사하지 않았거나 분실했다면 새로운 키를 생성해야 합니다. 모든 상담원의 컴퓨터에 ScreenAgent을(를) 설치할 때 이 액세스 키 ID 및 비밀 액세스 키를 사용합니다.
5. 계정 활성화 버튼을 활성화 이메일에서 클릭하여 ScreenAgent 직원 계정을 활성화합니다.
ScreenAgent MSI를 다운로드합니다.
1. CXone(으)로 이동하여 지원 다운로드 액세스 가능 권한을 가진 사용자로 로그인합니다.
2. 사용자 이름을 클릭하고 지원 및 다운로드를 클릭합니다.
3. 필요한 MSI를 다운로드합니다. 나중에 파일 위치가 필요하기에 어디에 MSI가 다운로드되었는지 확인해야 합니다.
ScreenAgent은(는) 기본, 다이제스트, Kerberos, NTLM 및 협상 등 5가지의 화면 녹화용 프록시 인증 방법을 지원합니다. 프록시 인증 방법을 사용하는 경우:
- 프록시 설정에서 운영 체제 수준의 프록시를 설정해야 합니다.
- Basic 및 Digest 인증 방법의 경우 Windows 자격 증명 관리자에서 자격 증명을 설정해야 합니다.
- 설치에는 다른 점이 없습니다. 단, 운영체제에서 프록시를 변경하지 않고 ScreenAgent에 프록시를 사용하고 싶다면 ScreenAgent 설치에서 직접 프록시를 사용하면 됩니다.
- 이러한 인증 방법은 화면 녹화에만 사용되며 화면 모니터링에는 사용되지 않습니다.

Windows용 ScreenAgent 설치

배포 도구를 사용하거나 수동으로 각 상담원의 컴퓨터에 ScreenAgent을(를) 설치할 수 있습니다.

배포 도구를 사용하는 경우에는 다음 중 하나로 설치를 구성하십시오.

사용자 권한으로 실행(사용자 모드/사용자 컨텍스트)—상담원의 컴퓨터를 다시 시작할 필요가 없습니다.
관리자 권한으로 실행—모든 상담원의 컴퓨터를 다시 시작해야 합니다.

다음과 같이 설치 위치를 지정할 수 있습니다.

기본적으로 ScreenAgent는 C 드라이브 아래 \NICE-InContact\ScreenAgent 폴더에 설치됩니다. 설치 명령에서 다른 설치 경로를 지정할 수 있습니다.
이후 버전으로 업그레이드하는 경우 설치 경로를 다르게 정의할 수 있습니다. 이전 버전이 제거되고 최신 버전이 지정된 위치에 설치됩니다.
동일한 ScreenAgent 버전을 다시 설치하면 동일한 위치에 있는 기존 설치를 덮어씁니다. 설치 경로를 변경하려면 기존 인스턴스를 제거하고 다시 설치할 때 필요한 위치를 지정합니다.

일부 ScreenAgent 매개 변수는 설치 후 변경할 수 있습니다. ScreenAgent 구성 변경을(를) 참조하십시오. 다른 설치 매개 변수를 업데이트하려면 ScreenAgent 클라이언트를 다시 설치합니다.

ScreenAgent을(를) 후속 버전으로 업그레이드하려면 ScreenAgent 클라이언트를 다시 설치합니다. 이전 버전을 제거할 필요는 없습니다.

ScreenAgent를 업그레이드하거나 다시 설치할 때 다른 매개 변수 설정을 지정하지 않으면 기존 구성을 자동으로 사용합니다. 현재 구성으로 다시 설치 또는 업그레이드을(를) 참조하십시오. ScreenAgent를 제거할 때 구성이 저장되지 않으므로 업그레이드하거나 다시 설치할 때 설치 매개 변수를 지정해야 합니다.

상담원이 녹음되지 않을 때 ScreenAgent을(를) 설치 또는 설치 제거합니다. 상담원이 설치 중에 통화하고 있다면 해당 통화에 대한 화면 녹화가 중지됩니다. 설치가 완료되면 통화는 녹음 정책 및 Studio 스크립트에 따라 기록됩니다.

ScreenAgent 설치 방법:

모든 전제 조건이 충족되었는지 확인하십시오.
명령 프롬프트를 관리자로 엽니다. 명령 줄에서 MSI를 다운로드한 위치를 찾고 관련 매개변수를 설치 명령에 입력합니다.
단계별 지침
1. MSI를 다운로드한 폴더로 이동하고 폴더로 가는 경로를 복사합니다. 이는 일반적으로 %UserProfile%\downloads 폴더입니다.
2. 명령 프롬프트를 관리자로 실행:
  1. Windows에서 Windows 버튼을 클릭하고 cmd를 입력합니다.
  2. 명령 프롬프트 타일을 오른쪽 클릭하고 관리자 권한으로 실행을 클릭합니다.
3. cd/를 입력하고 Enter 키를 누릅니다.
4. cd를 입력하고 자신의 파일 위치를 붙여넣습니다. 그 다음에 Enter 키를 누릅니다.
  
  예: cd %UserProfile%\downloads.
5. 명령을 복사하여 명령 프롬프트에 붙여넣고 설치 매개변수를 편집합니다.
  - 웹 프록시가 없거나 프록시가 OS 수준으로 정의된 경우 다음 명령을 사용하십시오.
    
    msiexec /i ScreenAgent-<32|64>bit-<MSI version>.msi INSTALL_PATH=<optional: installation path> ACCESS_KEY_ID=<access key ID> ACCESS_KEY_SECRET=<secret access key> REGION_TYPE=<subdomain (first 3 characters) of the CXone URL> RESOLVE_USER=<optional: auto|oslogin> FRAME_PER_SECOND=<optional: 1, 2, 3, 4, or 5> RESOLUTION_LEVEL=<optional: null, low, medium, or high> LOAD_CERTIFICATES=<optional: true|false> STATISTICS=<optional: true|false>/log install.log /quiet
  - 프록시 인증을 사용 중이고 프록시가 OS 수준에서 정의되지 않은 경우 아래 명령을 사용하십시오.
    
    msiexec /i ScreenAgent-<32|64>bit-<MSI version>.msi INSTALL_PATH=<optional: installation path> ACCESS_KEY_ID=<access key ID> ACCESS_KEY_SECRET=<the secret access key> REGION_TYPE=<subdomain (first 3 characters) of the CXone URL> WEB_PROXY=<only if using a proxy server to connect to the internet> RESOLVE_USER=<optional: auto|oslogin> FRAME_PER_SECOND=<optional: 1, 2, 3, 4, or 5> RESOLUTION_LEVEL=<optional: null, low, medium, or high> LOAD_CERTIFICATES=<optional: true|false> STATISTICS=<optional: true|false> /log install.log /quiet
  예시 설치 명령(웹 프록시가 없거나 프록시가 OS 수준에서 정의된 경우)
```
msiexec /i ScreenAgent-64bit-3.0.37.msi INSTALL_PATH=d:\newdir ACCESS_KEY_ID=ABCDEF12345==== ACCESS_KEY_SECRET=12345ABCDEF REGION_TYPE=na1 RESOLVE_USER=oslogin FRAME_PER_SECOND=5 RESOLUTION_LEVEL=high  LOAD_CERTIFICATES=true STATISTICS=true /log install.log /quiet
```
현재 구성으로 다시 설치 또는 업그레이드
다음 명령을 사용합니다.

msiexec /i ScreenAgent-<32|64>bit-<MSI version>.msi KEEP_CURRENT_CONFIG= true

이 매개 변수의 기본값은 true이기 때문에 KEEP_CURRENT_CONFIG= true는 선택 사항입니다.
- 이전 설치 시 모든 구성을 설정한 경우 ScreenAgent는 기존 구성을 모두 사용하여 설치됩니다.
- 일부 구성이 누락되었거나 이전 설치에서 설정되지 않은 경우 ScreenAgent는 기존 구성으로 설치되고 누락된 매개변수에 대해서는 기본값이 사용됩니다.
- 설치 경로는 설치 후 저장되지 않습니다. 설치 명령에서 설치 경로를 제공하지 않으면 KEEP_CURRENT_CONFIG= true이더라도 ScreenAgent는 기본 위치에 설치됩니다.
매개변수 설정을 일부는 유지하고 다른 설정은 변경하려는 경우 위 명령을 사용하여 다른 매개변수는 필요에 따라 추가합니다. 예를 들어 초당 프레임 수 및 해상도만 변경하려면 다음을 사용합니다(KEEP_CURRENT_CONFIG=true는 선택 사항임).
```
msiexec /i ScreenAgent-64bit-2.2.18.msi KEEP_CURRENT_CONFIG=true FRAME_PER_SECOND=5 RESOLUTION_LEVEL=high
```
로그 파일에서 설치 성공 여부를 확인합니다. install.log 파일은 MSI를 설치한 폴더에 있습니다. 이는 일반적으로 %UserProfile%\downloads 폴더입니다.
- 설치 프로그램에 관리자 권한이 있는지 확인합니다.
- 상담원의 컴퓨터에 Microsoft .NET Framework 4.0 이상이 없다면 이를 설치합니다.
구성 파일인 configFile.ini는 설치 후 자동으로 숨겨집니다. 파일을 보고 열려면 Windows 파일 탐색기에서 숨겨진 항목을 활성화합니다.
상담원에게 녹화 가능 속성이 있는지 확인하세요(CXone에서 관리자 > 직원으로 이동한 후 상담원을 클릭). 이 특성은 화면 녹화, 화면 모니터링 또는 둘 다를 하는 데 필요합니다.
통화를 기록하고 ScreenAgent 로그 파일을 확인합니다. ScreenAgent.log 파일은 %appdata%\ScreenAgent\logs\ScreenAgent.log에 있습니다.

ScreenAgent 로그는 또한 필요할 경우 NICE CXone 지원팀이 액세스할 수 있는 클라우드에 자동으로 업로드됩니다.

오류가 발생했다면 녹음 문제 해결을(를) 참조하십시오.

ScreenAgent을(를) 사용하여 실시간 화면 모니터링으로 상담원 상호작용을 개선하는 방법에 대한 개요를 설명하는 비디오를 시청할 수 있습니다.

거부 목록에 대한 Google Chrome 레지스트리 키 구성

상담원의 컴퓨터에서 Google Chrome 브라우저를 사용하는 경우 GoogleChrome 레지스트리 키에 UiAutomationProviderEnabled 값이 없으면 거부 목록에 지정된 URL이 기록에서 제외되지 않을 수 있습니다. 화면 녹화 거부 목록 관리를 참조하십시오.

레지스트리 키에 값을 추가하려면:

상담원의 컴퓨터에서 Chrome 브라우저 126 이상이 사용되고 있는지 확인합니다.
Windows 관리자 권한이 있는지 확인합니다.
HKLM:\SOFTWARE\Policies\Google\Chrome 레지스트리 경로가 있는지 확인합니다.
다음 PowerShell 스크립트 줄을 실행하여 Google Chrome 레지스트리에 값을 추가합니다.

Set-ItemProperty -Path "HKLM:\SOFTWARE\Policies\Google\Chrome" -Name "UiAutomationProviderEnabled" -Value 1 -Type DWord

잠재적인 VDI 원격 앱 해결 방법

상담원이 VDI 원격 앱을 사용하고 있고 ScreenAgentWatchDog.exe 프로세스가 시작되지 않는 경우:

RemoteApps에 ScreenAgent.exe를 게시합니다. 관리자(상담원 아님)만 액세스할 수 있도록 하십시오.
RemoteApps에 대한 바로가기를 생성하고 게시합니다. 아래에 표시된 것과 같은 스크립트를 사용하여 브라우저를 열고 ScreenAgentWatchDog.exe를 실행합니다. 상담원은 이 바로 가기를 사용하여 브라우저를 열어야 하며, 그렇지 않으면 ScreenAgent가 실행되지 않습니다.

Edge 브라우저용 일괄 스크립트 예시

다음 예시에서 <USER_ID>와 <TENANT_ID>를 관련 정보로 바꾸십시오. 또한, 이 예시에 표시된 URL은 원하는 다른 URL로 대체할 수 있습니다.

var(--codeSnippetCopyLabel)

@echo Off

cd " C:\Program Files (x86)\Microsoft\Edge\Application"
start msedge.exe https://account.activedirectory.windowsazure.com/applications/signin/<USER_ID>?tenantId=<TENANT_ID>

REM Check if ScreenAgentWatchDog is already running for the current user profile
tasklist /FI "USERNAME eq %USERNAME%" /FI "IMAGENAME eq ScreenAgentWatchDog.exe" | find /I "ScreenAgentWatchDog.exe" > nul
if "%errorlevel%" neq "0" (
    cd "%ProgramFiles%\NICE-InContact\ScreenAgent"
    start ScreenAgentWatchDog.exe
)

Exit

Chrome 브라우저용 일괄 스크립트 예시

다음 예시에서 <USER_ID>와 <TENANT_ID>를 관련 정보로 바꾸십시오. 또한, 이 예시에 표시된 URL은 원하는 다른 URL로 대체할 수 있습니다.

var(--codeSnippetCopyLabel)

WorkaroundChrome

@echo Off

cd "C:\Program Files (x86)\Google\Chrome\Application"
start chrome.exe https://account.activedirectory.windowsazure.com/applications/signin/<USER_ID>?tenantId=<TENANT_ID>

REM Check if ScreenAgentWatchDog is already running for the current user profile
tasklist /FI "USERNAME eq %USERNAME%" /FI "IMAGENAME eq ScreenAgentWatchDog.exe" | find /I "ScreenAgentWatchDog.exe" > nul
if "%errorlevel%" neq "0" (
    cd "%ProgramFiles%\NICE-InContact\ScreenAgent"
    start ScreenAgentWatchDog.exe
)

Exit

ScreenAgent 구성 변경

설치 후 일부 ScreenAgent 구성을 변경할 수 있습니다.

구성 파일인 configFile.ini는 설치 후 자동으로 숨겨집니다. 파일을 보고 열려면 Windows 파일 탐색기에서 숨겨진 항목을 활성화합니다.

ScreenAgent 설치 폴더에서 configFile.ini 파일을 엽니다. 일반적으로 C:\Program Files\NICE-InContact\ScreenAgent에 있습니다.

다음과 같이 매개변수를 편집합니다.

[recordingParameters] 섹션에서 framePerSecond 값을 변경합니다. 기본값으로 이 값은 5입니다.

1, 2, 3, 4, 5 값이 허용됩니다.

초당 프레임 수를 줄이면 파일 크기, CPU 및 RAM이 줄어듭니다.

초당 프레임(FPS)	프레임 수 감소	파일 크기/대역폭, CPU 및 RAM에 미치는 영향(예상)
5	기본(최대)	없음
4	20% 감소	~15% 감소
삼	40% 감소	~30% 감소
2	60% 감소	~45% 감소
1	80% 저조	~60% 감소

[recordingParameters] 섹션에서 resolutionLevel 값을 변경합니다. 기본적으로 이 값은 null(현재 화면 해상도)입니다.

허용된 값은 null, low, medium 또는 high입니다(대소문자 구분).

해상도를 낮추면 파일 크기, CPU 및 RAM이 줄어듭니다.

해상도 레벨	해상도 감소	파일 크기/대역폭, CPU 및 RAM에 미치는 영향(예상)
Null	기본값(현재 화면 해상도)	없음
높음	화면 해상도 / 1.5	~20% 감소
매체	화면 해상도 / 2	~40% 감소
낮음	화면 해상도 / 4	~60% 감소(4K 화면에만 권장)

모니터의 해상도를 다시 설정하려면 resolutionLevel 값을 null로 변경합니다.

[others] 섹션에서 loadCertificates 값을 변경합니다. 기본적으로 이 값은 true입니다.

허용되는 값은 true 또는 false입니다.

configFile.ini 파일을 저장합니다.
변경 사항을 적용하려면 ScreenAgent 애플리케이션을 다시 시작합니다.
1. Windows 작업 관리자에서 현재 ScreenAgentWatchDog.exe 태스크를 종료한 다음 ScreenAgent.exe 프로세스를 종료합니다.
2. ScreenAgent 설치 폴더에서 ScreenAgentWatchdog.exe를 실행합니다.

ScreenAgent 연결 검사

ScreenAgent 연결 확인 도구를 사용하여 일련의 테스트를 실행하여 네트워크 액세스를 확인하고 ScreenAgent가 올바르게 작동하는지 확인합니다.

ScreenAgent 설치 전이나 후에 이 도구를 사용할 수 있습니다.
다운로드 페이지에서 최신 버전의 연결 확인 도구를 다운로드할 수 있습니다.
상담원의 네트워크 구성이 변경되었거나 일반 구성과 다른 경우 이 도구를 사용하는 것이 좋습니다. 모든 상담원을 위해 도구를 실행할 필요는 없습니다.
동일한 명령을 사용하여 연결 확인 도구를 여러 번 실행할 수 있습니다.
각 테스트가 실행된 이후에 성공 또는 실패 알림이 표시됩니다. 실행이 끝나면 요약에 각 테스트의 상태가 표시됩니다.
테스트를 완료한 후 연결 확인 도구는 로그 파일을 생성합니다.
연결 확인 도구에는 현재 실시간 화면 모니터링을 위한 네트워킹을 확인하는 테스트가 포함되어 있지 않습니다.

연결 확인 도구 EXE 파일을 다운로드합니다.
1. CXone(으)로 이동하여 지원 다운로드 액세스 가능 권한을 가진 사용자로 로그인합니다.
2. 사용자 이름을 클릭하고 지원 및 다운로드를 클릭합니다.
3. 필요한 EXE 파일을 다운로드합니다. 나중에 파일 위치가 필요하므로 어디에 EXE가 다운로드되었는지 확인해야 합니다.

연결 확인 도구를 실행합니다.

명령 프롬프트를 관리자로 실행합니다.

명령 프롬프트에 명령을 복사하여 붙여넣고 테이블에 나열된 매개변수를 편집합니다.

<path to exe file> ACCESS_KEY_ID=<access key ID> ACCESS_KEY_SECRET=<secret access key> REGION_TYPE=<subdomain (first 3 characters) of the CXone URL> WEB_PROXY=<optional: URL of proxy server>

연결 도구 명령 매개변수

매개변수	설명	예시
exe 파일 경로	다운로드한 EXE 파일의 파일 위치입니다.	C:%UserProfile%\downloads
ACCESS_KEY_ID	직원 계정에서 생성된 액세스 키 ID를 붙여넣습니다. 액세스 키를, 생성하려면 ScreenAgent의 액세스 키를 생성합니다.의 내용을 참조하십시오.	ACCESS_KEY_ID=ABCDEF12345====
ACCESS_KEY_SECRET	직원 계정에서 생성된 비밀 액세스 키를 붙여넣습니다.	ACCESS_KEY_SECRET=12345ABCDEF
REGION_TYPE	자신의 CXone URL 하위 도메인(첫 3글자)(예: na1, na2, au1, eu1)을 입력합니다	REGION_TYPE=na1
WEB_PROXY	인터넷에 연결하기 위해 프록시 서버를 사용하는 경우에만 이 매개변수를 포함시키십시오. 호스트는 호스트 이름 또는 IP일 수 있습니다. 자신의 프록시 설정에 따라 http 또는 https를 사용합니다. 자신의 프록시 서버에 설정되어 있다면 사용자 이름 및 암호를 사용합니다.	WEB_PROXY=http://admin:pwd@168.63.76.32:3128 WEB_PROXY=https://proxyserver:8088

예시 명령:

C:%UserProfile%\downloads ACCESS_KEY_ID=ABCDEF12345==== ACCESS_KEY_SECRET=12345ABCDEF REGION_TYPE=na1 WEB_PROXY=https://proxyserver:8088

연결 확인 도구가 테스트를 실행하기 시작합니다. 각 테스트가 실행된 이후에 성공 또는 실패 알림이 표시됩니다. 테스트가 실패하면 실패 이유가 표시됩니다. 실행이 종료되면 각 테스트가 통과했는지, 실패했는지, 또는 실행할 필요가 없었는지(N/A)를 알려주는 요약이 표시됩니다. 예를 들어 연결 도구가 시작되었을 때 ScreenAgent가 백그라운드에서 실행되고 있지 않았다면 ScreenAgent를 닫고 재시작하는 테스트를 실행할 필요가 없습니다.

이미지 뷰

테스트 완료 후 연결 확인 도구가 로그 파일(SA_Connectivity_tool_log_<runUniqueUUID>)을 연결 확인 도구 설치 파일과 같은 폴더에 생성합니다. 로그 파일에는 명령 프롬프트에 표시되었던 정보가 모두 포함되어 있습니다.

연결 테스트

연결 확인 도구로 수행된 테스트

테스트	설명
ScreenAgent 닫기	ScreenAgent가 백그라운드에서 실행 중인 경우 ScreenAgent(ScreenAgent.exe 및 ScreenAgentWatchdog.exe)를 닫습니다. 이렇게 하면 연결 도구 테스트가 방해받지 않습니다.
31322 포트 검사	31322 포트와의 통신을 테스트합니다.
토큰 가져오기	토큰 가져오기를 테스트합니다.
새로 고침 토큰 가져오기	새로 고침 토큰 가져오기를 테스트합니다.
알림 서비스에서 로그 버킷에 대한 STS 자격 증명 수신	알림 서비스 웹 소켓에서 메시지를 송수신하는 테스트를 수행합니다.
알림 서비스에서 미디어 버킷에 대한 STS 자격 증명 수신	알림 서비스 웹 소켓에서 메시지를 송수신하는 테스트를 수행합니다.
S3 로그 버킷에 대한 연결 도구 실행 로그 업로드	S3 로그 버킷에 대한 업로드를 테스트합니다.
S3 미디어 버킷에 대한 파일 업로드	S3 미디어 버킷에 대한 업로드를 테스트합니다.
ScreenAgent 실행	이전에 닫혔던 경우 ScreenAgent(ScreenAgent.exe 및 ScreenAgentWatchdog.exe)를 재시작합니다.
31322 포트 서버 정지	31322 포트와의 통신을 테스트하는 데 사용한 테스트 서버를 중지합니다.

설치 명령 매개변수

매개변수	설명	예시
msiexec /i ScreenAgent-32bit-<MSI version>.msi	32비트 또는 64비트 다음을 포함한 컴퓨터에 설치 시: 32비트 Windows가 설치되어 있다면 32비트를 입력합니다 64비트 Windows가 설치된 경우, 64비트를 입력합니다. MSI 버전 지원 및 다운로드 페이지에서 다운로드한 설치 파일의 MSI 버전을 입력합니다. 예: 3.0.22.	msiexec /i ScreenAgent-64bit-3.0.22.msi msiexec /i ScreenAgent-32bit-3.0.22.msi
KEEP_CURRENT_CONFIG	(선택 사항) ScreenAgent 다시 설치 또는 업그레이드 시 설치에서는 기본적으로 현재 구성을 사용합니다. 현재 구성으로 다시 설치 또는 업그레이드을(를) 참조하십시오. false로 설정하면 ScreenAgent 설치에서 기존 구성을 사용하지 않습니다. 설치에서는 지정된 모든 매개변수를 사용하고 구성이 없는 매개변수에 대해서는 기본값을 사용합니다. 기본값은 true입니다. 클린 설치의 경우, 구성이 없는 매개변수에 대해 기본값이 사용됩니다.	KEEP_CURRENT_CONFIG=true
INSTALL_PATH	(선택 사항) 설치 경로를 지정할 수 있습니다. 설치 파일은 지정된 설치 경로 아래 \NICE-InContact\ScreenAgent 폴더에 저장됩니다. 이 매개 변수를 추가하지 않으면 KEEP_CURRENT_CONFIG= true라고 하더라도 ScreenAgent가 C의 기본 설치 경로에 설치됩니다.	INSTALL_PATH=d:\newdir
ACCESS_KEY_ID	직원 계정에서 생성된 액세스 키 ID를 붙여넣습니다. 액세스 키를, 생성하려면 ScreenAgent의 액세스 키를 생성합니다.의 내용을 참조하십시오.	ACCESS_KEY_ID=ABCDEF12345====
ACCESS_KEY_SECRET	직원 계정에서 생성된 비밀 액세스 키를 붙여넣습니다.	ACCESS_KEY_SECRET=12345ABCDEF
REGION_TYPE	자신의 CXone URL 하위 도메인(첫 3글자)(예: na1, na2, au1, eu1)을 입력합니다	REGION_TYPE=na1
STATISTICS	(옵션) 기본적으로 이 값은 true로 설정되어 ScreenAgent가 사용자 컴퓨터(RAM, CPU)에서 데이터를 수집할 수 있게 합니다. ScreenAgent가 데이터를 수집하지 않도록 하려면 이 값을 false로 변경할 수 있습니다. 허용되는 값은 true 또는 false입니다. 설치 후 이 구성을 변경할 수 있습니다.	STATISTICS=true
WEB_PROXY	인터넷에 연결하기 위해 프록시 서버를 사용하는 경우에만 이 매개변수를 포함시키십시오. 주의 사항 호스트는 호스트 이름 또는 IP일 수 있습니다. 자신의 프록시 설정에 따라 http 또는 https를 사용합니다. 자신의 프록시 서버에 설정되어 있다면 사용자 이름 및 암호를 사용합니다. 예: http://server_username:server_password@host:port https://server_username:server_password@host:port https://host:port 프록시 pac 파일에서 작동하는 프록시 URL을 사용하는 경우 URL 앞에 프리픽스 pac+를 추가합니다. 예를 들어, 프록시 URL이 https://<proxy server>.pac인 경우 다음과 같이 사용합니다. WEB_PROXY=pac+https://<proxy server>.pac	WEB_PROXY=http://admin:pwd@168.63.76.32:3128 WEB_PROXY=https://proxyserver:8088
RESOLVE_USER	(선택 사항) 상담원의 OS 로그인을 사용하도록 RESOLVE_USER=oslogin을 구성합니다. 이 모드에서 ScreenAgent는 상담원의 OS 로그인 정보를 사용하여 서버에 연결하고 CXone Multi-ACD (CXone Open), 멀티 세션 환경 등과 같은 고급 구성에서 작동합니다. OS 로그인을 사용하는 경우 ScreenAgent에서는 포트 31322를 사용하지 않습니다. 이 매개변수를 추가하지 않으면 ScreenAgent에서는 기본값인 auto를 사용하여 설치하고 CXone 클라이언트(MAX, CXone Agent 등)를 사용하여 서버에 연결합니다. 이 모드에서 ScreenAgent는 포트 31322를 사용하여 CXone 클라이언트에 연결합니다. 상담원의 OS 로그인은 직원 설정의 일반 탭에서 Domain\Username 형식으로 정의합니다.	RESOLVE_USER=oslogin
FRAME_PER_SECOND	(옵션) 출력 MP4 파일을 위해 초당 녹음되는 프레임 수를 설정할 수 있습니다. 이 매개 변수를 추가하지 않으면 ScreenAgent는 기본값인 초당 5프레임으로 설치됩니다. 1, 2, 3, 4, 5 값이 허용됩니다. 초당 프레임 수를 줄이면 파일 크기, 대역폭, CPU 및 RAM이 줄어듭니다. 설치 후 이 구성을 변경할 수 있습니다.	FRAME_PER_SECOND=3
RESOLUTION_LEVEL	(선택 사항) RAM 및 CPU 소비를 최적화하기 위해 녹음된 MP4 파일의 해상도를 설정할 수 있습니다. 이 매개 변수를 추가하지 않으면 기본 해상도 설정인 null(현재 화면 해상도)을 사용하여 ScreenAgent가 설치됩니다. 허용된 값은 null, low, medium 또는 high입니다(대소문자 구분). 해상도를 낮추면 파일 크기, CPU 및 RAM이 줄어듭니다. 설치 후 이 구성을 변경할 수 있습니다.	RESOLUTION_LEVEL=low
LOAD_CERTIFICATES	(선택 사항) ScreenAgent가 Windows 인증서 스토어에 액세스하여 자체 서명된 인증서를 로드해야 하지 않는 경우에는 이 매개 변수를 false로 설정하십시오. 허용되는 값은 true 또는 false입니다. 이 매개 변수를 추가하지 않으면 ScreenAgent는 Windows 인증서 스토어에서 자체 서명된 인증서에 액세스합니다. 설치 후 이 구성을 변경할 수 있습니다.	LOAD_CERTIFICATES=false
/log install.log	로그 파일에 설치 결과를 출력합니다.	/log install.log
/quiet	(옵션) 설치하는 동안 팝업 억제를 원한다면 포함시킵니다. 로그 파일에서 설치 결과를 볼 수 있도록 합니다.	/quiet