Windows AI API 문제 해결

요구 사항

Hardware

Phi Silica 기능에는 코필로트+ PC가 필요합니다(노트북 키보드에는 전용 코필로트 키가 있습니다). 권장 디바이스 목록은 Copilot+ PC 개발자 가이드 를 참조하세요.

소프트웨어

Windows 11 버전 25H2(빌드 10.0.26200.7309) 이상은 Copilot+ PC에 설치해야 합니다. 시작 메뉴를 열고 "winver"를 입력하고 Enter 키를 눌러 확인할 수 있습니다(다음과 유사한 OS 세부 정보가 있는 대화 상자가 표시됨).

Phi Silica 기능을 사용할 수 있는지 확인합니다.

1. Microsoft Store에서 AI 개발자 갤러리 앱을 다운로드하고 설치합니다.
2. 앱을 실행하세요.
3. 왼쪽 창에서 AI APIs 를 선택합니다.
4. Phi Silica>텍스트 생성을 클릭합니다.
5. Phi Silica가 프롬프트에 응답하는지 확인합니다(샘플 앱은 기본 프롬프트로 시작).

기타 권장 사항

개발자용설정>시스템에서> 개발자모드> 사용하도록 설정합니다.

WinUI 및 Windows 앱 SDK를 사용하여 개발하는 데 필요한 워크로드 및 구성 요소를 사용하여 Visual Studio 를 설치합니다. 자세한 내용은 필수 워크로드 및 구성 요소를 참조하세요.

디버깅

Phi Silica가 시스템에서 작동하지 않는 것처럼 보이면 몇 가지 작업을 수행할 수 있습니다.

1. 시스템에서 사용할 수 있는 AI 모델을 보여 주는 설정 > 시스템 > AI 구성 요소로 이동하여 필요한 모든 모델이 설치되어 있는지 확인합니다. 필요한 모델이 나열되지 않은 경우 설정 > Windows 업데이트 로 이동하여 "업데이트 확인"을 클릭합니다(다시 시작이 필요할 수 있음).

2. 앱이 유효한 WinAppSDK 최소 버전을 사용하고 있는지 확인합니다.

   • 안정: 1.8.3
   • 실험적: 2.0-Exp3

3. 설정>업데이트를 확인하여 Windows 업데이트가 일시 중지되지 않았는지 확인합니다.

4. Windows 피드백 허브 앱을 통해 추적을 수집하고 검토할 Windows 팀과 공유합니다.

   1. 피드백 허브 앱(Windows 키 + F)을 엽니다.
   2. 기본 설정 계정으로 로그인합니다.
   3. 섹션 1에 버그 세부 정보를 입력합니다("[Windows AI APIs]"를 사용하여 버그 제목 접두사).
   4. 섹션 2에서 문제를 클릭하고 첫 번째 드롭다운에서 개발자 플랫폼을 선택한 다음 두 번째 드롭다운에서 Windows AI Foundry 를 선택합니다.
   5. 섹션 3에는 사용자와 유사한 기존 피드백이 표시됩니다. 기존 피드백을 찾을 수 없는 경우 새 피드백을 선택하고 다음을 클릭합니다.
   6. 섹션 4에서는 다음을 수행할 수 있습니다.
      1. 내 문제 다시 만들기를 클릭한 다음, 기록 시작을 클릭하고, AI 개발자 갤러리를 실행하고, 문제를 재현하고, 기록을 중지합니다.
      2. 추가 정보 및 첨부 파일(예: 이미지)을 포함합니다. 재현 단계 및 오류 메시지를 포함하여 가능한 한 많은 세부 정보를 제공합니다.
   7. 피드백을 제출합니다.

기타 지침

• 사용하는 Windows AI APIs 앱은 런타임에 패키지 ID를 부여해야 합니다. 자세한 내용은 앱 패키징의 장점 및 단점을 참조하세요. UnauthorizedAccessException 오류(또는 다른 액세스 문제가 있는 경우)가 표시되는 경우 앱이 패키지되고 systemAIModels 기능이 매니페스트 파일에 추가되었는지 확인합니다(앱 Windows AI APIs빌드 시작 참조).

• LAF(제한된 액세스 기능) 요구 사항:

  • Microsoft에서 LAF 토큰을 요청하고 받았는지 확인합니다.
  • 다음 상태 값은 LAF가 실패했음을 나타냅니다.
    • 제한된 액세스 기능 상태.사용 불가
    • 제한된액세스기능상태.알수없음

• 자체 포함 앱은 다운로드 폴더(또는 폴더 아래 C:\Users 의 어느 곳에서나)에서 실행할 수 없습니다. 자세한 내용은 앱 및 Windows 앱 SDK 배포 개요패키징의 장점과 단점을 참조하세요.

• Windows 앱 SDK 실험 채널에는 개발 초기 단계의 APIs 및 기능이 포함되어 있습니다. 실험 채널의 모든 APIs 항목은 광범위한 수정 및 호환성이 손상되는 변경이 적용되며 언제든지 후속 릴리스에서 제거될 수 있습니다. 실험적 기능은 프로덕션 환경에서 사용할 수 없으며 이를 사용하는 앱은 Microsoft Store에 게시할 수 없습니다.

• Windows 앱 SDK GitHub 리포지토리(타이틀에 APIs 포함)에서 새 문제를 만들거나 기존 문제에 응답하여 이러한 기능과 기능에 대한 피드백을 제공합니다.

참고하십시오

• AI 개발자 갤러리
• Windows AI API 샘플