Windows의 Copilot

  • 아티클

이 문서에서는 현재 장치에서 Windows의 Copilot를 사용할 수 있는지 확인하는 방법과 기능을 사용할 수 있는 경우 Microsoft Edge 시작 URI 체계를 사용하여 Windows에서 Copilot를 시작하는 방법을 설명합니다. 이 문서에서 설명하는 기술은 단기적으로 사용하기 위한 것입니다. 이후 릴리스에서는 이 문서에 설명된 메서드가 더 이상 사용되지 않을 수 있으며 보다 공식적이고 강력한 API로 대체될 수 있습니다. Microsoft Copilot 사용에 대한 일반적인 정보 및 지침은 Microsoft Copilot 설명서 및 리소스 또는 상업용 데이터 보호가 포함된 코필로트 개요를 참조하세요.

Windows 11 버전 23H2에서 이 기능은 빌드 22631.3007 이상에서 사용할 수 있습니다. Windows 11 버전 22H2에서는 이 기능을 빌드 22621.3007 이상에서 사용할 수 있습니다. 이 기능을 사용하려면 Microsoft Edge 버전 120.0.2210.121 이상이 필요합니다.

디바이스의 Windows 가용성에서 Copilot 확인

Windows 디바이스에서 Windows의 Copilot를 사용할 수 있는지 여부를 확인하려면 다음 레지스트리 키의 값을 검사. 값이 0이면 Windows의 코필로트를 사용할 수 없습니다. 값이 1이면 Windows의 코필로트를 사용할 수 있습니다.

항목 값
레지스트리 경로 HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\Copilot
레지스트리 키 이름 IsCopilotAvailable
사용 가능한 값: 0 – 사용할 수 없음 또는 1 - 사용 가능

Microsoft Edge 시작 URI 체계를 사용하여 Windows에서 Copilot 시작

Windows의 Copilot를 현재 디바이스에서 사용할 수 있다고 확인되면 애플리케이션은 Microsoft Edge 시작 URI 체계 microsoft-edge://?ux=copilot&lcp=1를 사용하여 기능을 호출할 수 있습니다.

이 URI 체계는 Windows의 Copilot와 관련된 다음 쿼리 문자열 매개 변수를 지원합니다.

매개 변수 값 설명 필수
Ux 부조 Windows 컨텍스트의 Copilot에서 Microsoft Edge를 시작합니다. 예
Lcp 1 Windows 컨텍스트의 Copilot에서 Microsoft Edge를 시작합니다. 예
prompt 문자열 시작 시 Windows의 Copilot에 전달될 프롬프트를 나타내는 선택적 문자열입니다. 아니요
formcode 문자열 들어오는 트래픽을 식별하는 데 도움이 되도록 전달할 수 있는 선택적 6자리 식별자입니다. 아니요
cpfilepath 문자열 Copilot에 전달될 파일의 파일 경로를 포함하는 선택적 문자열입니다. 아니요
cpfilemime 문자열 Copilot에 전달될 파일의 MIME 형식을 포함하는 선택적 문자열입니다. 아니요

Windows의 Copilot에는 다음과 같은 구문 요구 사항이 있습니다.

  • 프로토콜에 추가하려면 각 키/값 쌍을 앰퍼샌드로 구분해야 합니다.
  • 프롬프트 문자열은 URI로 인코딩/URI 이스케이프되어야 합니다.
  • URI의 프롬프트 문자열 부분은 URI 인코딩 전에 2000자보다 작거나 같아야 합니다.

예제

다음은 Windows에서 Copilot를 시작하는 예제 URI입니다.

microsoft-edge://?ux=copilot&lcp=1

프롬프트 쿼리 문자열 매개 변수를 사용하여 프롬프트를 지정합니다.

microsoft-edge://?ux=copilot&lcp=1&prompt=Explain%20This%3A%2020%2F20%20Vision

formcode 매개 변수 123456 지정합니다.

microsoft-edge://?ux=copilot&lcp=1&prompt=Explain%20This%3A%2020%2F20%20Vision&formcode=123456

cpfilepath 및 cpfilemime을 사용하여 Copilot에 전달될 파일을 지정합니다.

microsoft-edge://?ux=copilot&lcp=1&prompt=What%20is%20this%20a%20picture%20of%3F&formcode=123456&cpfilepath=C%3A%5CUsers%5Cme%5CDownloads%5CCopilot.png&cpfilemime=image%2Fpng