Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Ważne
Aplikacje korzystające z krzemionki APIs Phi mogą napotkać problemy z obsługą funkcji ograniczonego dostępu (zobacz FunkcjeOgraniczonegoDostępu).
W tej chwili zalecamy używanie wersji eksperymentalnych , ponieważ nie wymagają tokenów LAF.
Requirements
Sprzęt
Windows AI APIs obsługują różne urządzenia w zależności od API. Zobacz tabelę obsługiwanego sprzętu, aby uzyskać pełny przegląd.
| API | Obsługiwany sprzęt |
|---|---|
| Dwutlenek krzemu Phi | Copilot+ PC (NPU) lub urządzenie z systemem Windows 11 z obsługiwaną kartą graficzną (seria NVIDIA RTX 30 i nowsze z co najmniej 6 GB pamięci VRAM; AMD Radeon z najnowszym sterownikiem) |
| Text Recognition (OCR) | Copilot+ PC (NPU) |
| Rozpoznawanie mowy | Copilot+ PC (NPU) lub urządzenie spełniające zalecane wymagania dotyczące procesora |
| Super rozdzielczość wideo | Copilot+ PC (NPU) lub urządzenie spełniające zalecane wymagania dotyczące procesora |
| Obrazowanie APIs | Copilot+ PC (NPU) |
Informacje o funkcjach akcelerowanych przez NPU oraz listę zalecanych urządzeń znajdziesz w przewodniku dla deweloperów dotyczącym Copilot+ PCs.
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:
- Pobierz i zainstaluj aplikację AI Dev Gallery ze sklepu Microsoft Store.
- Uruchom aplikację.
- Wybierz pozycję Sztuczna inteligencja APIs w okienku po lewej stronie.
- Kliknij Phi Silica>Generowanie Tekstu.
- 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ć.
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).
Sprawdź, czy aplikacja używa prawidłowej Zestaw SDK do aplikacji systemu Windows minimalnej wersji.
- Kanał stabilny: 1.8.0 (1.8.250907003) lub nowszy
- Kanał eksperymentalny (wymagany dla Phi Silica na GPU): 2.2.2-experimental9 (wersja eksperymentalna z czerwca 2026) lub nowsza
Sprawdź aktualizacje ustawień>, aby upewnić się, że aktualizacje systemu Windows nie są wstrzymane.
Zbieranie śladów za pośrednictwem aplikacji Centrum opinii systemu Windows i udostępnianie ich zespołowi systemu Windows w celu przejrzenia.
- Otwórz aplikację Centrum opinii (klucz systemu Windows + F).
- Zaloguj się przy użyciu preferowanego konta.
- Wprowadź szczegóły usterki w sekcji 1 (prefiks tytułu usterki o nazwie "[Windows AI APIs]").
- 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.
- 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.
- W sekcji 4 można wykonać następujące czynności:
- 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.
- 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.
- Prześlij opinię.
Rozwiązywanie problemów z procesorem GPU (Silica Phi)
Phi Silica na GPU wymaga włączenia Trybu dewelopera (Ustawienia>System>Dla deweloperów>Tryb dewelopera).
Uruchamianie Phi Silica na GPU wymaga zainstalowania najnowszego sterownika bezpośrednio od producenta GPU (NVIDIA GeForce 615.21 beta, AMD Software: Adrenalin Edition 26.10.2). Domyślne sterowniki z instalacji Windows Update lub OEM mogą nie być wystarczające. Pamiętaj, że sterowniki OEM lub usługa Windows Update mogą nadpisać wcześniej zainstalowane sterowniki GPU — jeśli Phi Silica przestanie działać po aktualizacji, zainstaluj ponownie najnowszy sterownik bezpośrednio ze strony producenta GPU.
Obsługa GPU Phi Silica wymaga kart graficznych NVIDIA z serii RTX 30 lub nowszych, z co najmniej 6 GB pamięci VRAM, albo kart graficznych AMD Radeon z najnowszym sterownikiem. Jeśli działanie EnsureReadyAsync na urządzeniu GPU zakończy się niepowodzeniem, sprawdź, czy wersja sterownika GPU spełnia minimalne wymagania.
Rozwiązywanie problemów z procesorem CPU (Wideo Super Resolution, Rozpoznawanie mowy)
Te funkcje działają na dowolnym procesorze CPU, ale działają najlepiej na urządzeniach, które spełniają zalecane specyfikacje: co najmniej 4 rdzenie fizyczne, 3 GHz lub wyższy zegar podstawowy oraz 32 MB lub więcej pamięci podręcznej L3. Jeśli zauważysz niską wydajność, przycięcia lub spadek jakości, sprawdź, czy procesor hosta spełnia te zalecenia. Aby sprawdzić środowisko uruchomieniowe, które zwraca true , gdy urządzenie spełnia zalecane specyfikacje, zobacz MeetsRecommendedCpuSpecs przykład języka C# w dokumentacji dotyczącej superwydajniania wideo.
Model VSR jest dostarczany z Zestaw SDK do aplikacji systemu Windows i nie można go pobrać oddzielnie. Jeśli program VSR nie może zainicjować, sprawdź dokumentację VSR pod kątem obsługiwanych ograniczeń rozpoznawania i formatowania, a nie stanu modelu.
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.
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.