Rozwiązywanie problemów z API AI w systemie Windows

Requirements

Sprzęt

Funkcje Phi Silica wymagają użycia PC z Copilot+ (klawiatury laptopów mają dedykowany klawisz Copilot). Aby zapoznać się z listą zalecanych urządzeń, zobacz Przewodnik dla deweloperów aplikacji Copilot + PC .

Oprogramowanie

Windows 11, wersja 25H2 (kompilacja 10.0.26200.7309) lub nowsza musi być zainstalowana na komputerze Copilot+ PC. Można to zweryfikować, otwierając menu Start, wpisując "winver" i naciskając Enter (powinno zostać wyświetlone okno dialogowe ze szczegółami systemu operacyjnego, podobne do poniższego).

Upewnij się, że można używać funkcji krzemionki Phi:

1. Pobierz i zainstaluj aplikację AI Dev Gallery ze sklepu Microsoft Store.
2. Uruchom aplikację.
3. Wybierz pozycję Sztuczna inteligencja APIs w okienku po lewej stronie.
4. Kliknij Phi Silica>Generowanie Tekstu.
5. Upewnij się, że Phi Silica odpowiada na polecenie (przykładowa aplikacja rozpoczyna się od domyślnego polecenia).

Inne zalecenia

Włącz tryb dewelopera w Ustawieniach>System>dla deweloperów>Tryb dewelopera.

Zainstaluj program Visual Studio z obciążeniami i składnikami wymaganymi do programowania za pomocą interfejsu WinUI i zestawu SDK aplikacji systemu Windows. Aby uzyskać więcej informacji, zobacz Wymagane obciążenia i składniki.

Debugowanie

Jeśli Silica Phi nie wydaje się działać w systemie, istnieje kilka rzeczy, które można zrobić.

1. Sprawdź, czy masz zainstalowane wszystkie wymagane modele, przechodząc do pozycji Ustawienia > Systemowe > składniki sztucznej inteligencji, które pokazują modele sztucznej inteligencji dostępne w systemie. Jeśli wymagany model nie znajduje się na liście, przejdź do obszaru Ustawienia > Usługi Windows Update i kliknij pozycję "Sprawdź dostępność aktualizacji" (może być wymagane ponowne uruchomienie).

2. Sprawdź, czy aplikacja używa prawidłowej minimalnej wersji zestawu WinAppSDK.

   • Stabilny: 1.8.3
   • Eksperymentalny: 2.0-Exp3

3. Sprawdź aktualizacje ustawień>, aby upewnić się, że aktualizacje systemu Windows nie są wstrzymane.

4. Zbieranie śladów za pośrednictwem aplikacji Centrum opinii systemu Windows i udostępnianie ich zespołowi systemu Windows w celu przejrzenia.

   1. Otwórz aplikację Centrum opinii (klucz systemu Windows + F).
   2. Zaloguj się przy użyciu preferowanego konta.
   3. Wprowadź szczegóły usterki w sekcji 1 (prefiks tytułu usterki o nazwie "[Windows AI APIs]").
   4. W sekcji 2 kliknij pozycję Problem, wybierz pozycję Platforma deweloperów z pierwszej listy rozwijanej, a następnie wybierz pozycję Windows AI Foundry z drugiej listy rozwijanej.
   5. Sekcja 3 wyświetli wszelkie istniejące opinie podobne do Twoich. Jeśli nie znaleziono istniejącej opinii, wybierz pozycję Nowa opinia i kliknij przycisk Dalej.
   6. W sekcji 4 można wykonać następujące czynności:
      1. Kliknij przycisk Utwórz ponownie mój problem, a następnie kliknij przycisk Rozpocznij nagrywanie, uruchom galerię deweloperów sztucznej inteligencji, odtwórz problem, zatrzymaj nagrywanie.
      2. Dołącz dodatkowe informacje i załączniki (takie jak obrazy). Podaj jak najwięcej szczegółów, w tym kroki odtwarzania i komunikaty o błędach.
   7. Prześlij opinię.

Inne wskazówki

• Aplikacje, które używają Windows AI APIs, muszą mieć udzieloną tożsamość pakietu w czasie działania. Aby uzyskać szczegółowe informacje, zobacz Zalety i wady tworzenia pakietów aplikacji. Jeśli widzisz błąd UnauthorizedAccessException (lub masz inne problemy z dostępem), upewnij się, że aplikacja jest spakowana, a funkcja systemAIModels została dodana do pliku manifestu (zobacz Rozpoczynanie tworzenia aplikacji za pomocą polecenia Windows AI APIs).

• Wymagania dotyczące funkcji ograniczonego dostępu (LAF):

  • Sprawdź, czy zażądano i odebrano token LAF od firmy Microsoft
  • Następujące wartości stanu wskazują, że LAF zakończył się niepowodzeniem.
    • LimitedAccessFeatureStatus.Unavailable
    • LimitedAccessFeatureStatus.Unknown

• Aplikacje samodzielne nie mogą być uruchamiane z folderu Pobrane (lub z dowolnego miejsca w folderze C:\Users ). Aby uzyskać więcej informacji, zobacz Zalety i wady tworzenia pakietów aplikacji i przeglądu wdrażania zestawu SDK aplikacji systemu Windows.

• Eksperymentalny kanał zestawu SDK aplikacji systemu Windows obejmuje APIs oraz funkcje we wczesnych etapach rozwoju. Wszystkie APIs w kanale eksperymentalnym podlegają obszernym modyfikacjom i zmianom łamiącym zgodność i mogą zostać usunięte z kolejnych wydań w dowolnym momencie. Funkcje eksperymentalne nie są obsługiwane w środowiskach produkcyjnych i aplikacjach, które ich używają, nie mogą być publikowane w sklepie Microsoft Store.

• Prześlij opinię na temat tych APIs i ich funkcji, tworząc nowy problem w repozytorium GitHub zestawu SDK aplikacji systemu Windows (w tym Silica Phi w tytule) lub odpowiadając na istniejący problem.

Zobacz także

• Galeria deweloperów sztucznej inteligencji
• Przykłady interfejsu API sztucznej inteligencji systemu Windows