Windows AI-API – Problembehandlung

Von Bedeutung

Apps, die die Phi-Silikate APIs verwenden, können Probleme mit der Unterstützung des Features für eingeschränkten Zugriff haben (siehe LimitedAccessFeatures).

Derzeit empfehlen wir die Verwendung experimenteller Versionen , da sie keine LAF-Token erfordern.

Anforderungen

Gerätetechnik

Windows AI APIs unterstützen je nach API unterschiedliche Hardware. Eine vollständige Übersicht finden Sie in der unterstützten Hardwaretabelle .

API Unterstützte Hardware
Phi-Silika Copilot+ PC (NPU) oder ein Windows 11 Gerät mit einer unterstützten GPU (NVIDIA RTX 30-Serie und höher mit 6+ GB vRAM; AMD GPU-Unterstützung in Kürze verfügbar)
Text Recognition (OCR) Copilot+ PC (NPU)
Spracherkennung Copilot+ PC (NPU) oder ein Gerät, das die empfohlenen CPU-Spezifikationen erfüllt
Video-Superauflösung Copilot+ PC (NPU) oder ein Gerät, das die empfohlenen CPU-Spezifikationen erfüllt
Bildgebung APIs Copilot+ PC (NPU)

Informationen zu NPU-beschleunigten Funktionen sowie eine Liste der empfohlenen Geräte finden Sie im Entwicklerhandbuch für Copilot+ PCs.

Software

Windows 11, Version 25H2 (Build 10.0.26200.7309) oder höher muss auf dem Copilot+ PC installiert werden. Dies kann überprüft werden, indem Sie das Startmenü öffnen, "winver" eingeben und die EINGABETASTE drücken (ein Dialogfeld mit den Betriebssystemdetails, ähnlich der folgenden, sollte angezeigt werden).

Screenshot des Windows-Versionsdialogfelds, das angezeigt wird, indem Sie

Stellen Sie sicher, dass Sie Phi-Silikate-Features verwenden können:

  1. Laden Sie die AI Dev Gallery-App aus dem Microsoft Store herunter, und installieren Sie sie.
  2. Führen Sie die App aus.
  3. Wählen Sie KI APIs im linken Bereich aus.
  4. Klicken Sie auf Phi Silica>Textgenerierung.
  5. Vergewissern Sie sich, dass Phi Silika auf eine Eingabeaufforderung antwortet (die Beispiel-App beginnt mit einer Standardaufforderung).

Screenshot der AI Dev Gallery-Beispiel-App mit einem einfachen Beispiel für das Feature

Weitere Empfehlungen

Aktivieren Sie den Entwicklermodus in den Einstellungen>System>für Entwickler>Entwicklermodus.

Installieren Sie Visual Studio mit den Workloads und Komponenten, die für die Entwicklung mit WinUI und dem Windows App SDK erforderlich sind. Weitere Informationen finden Sie unter "Erforderliche Workloads und Komponenten".

Fehlersuche

Wenn Phi Silika nicht an Ihrem System arbeitet, gibt es ein paar Dinge, die Sie tun können.

  1. Vergewissern Sie sich, dass alle erforderlichen Modelle installiert sind, indem Sie zu "Einstellungen > System > AI Components" wechseln, in dem die ki-Modelle angezeigt werden, die auf dem System verfügbar sind. Wenn das erforderliche Modell nicht aufgeführt ist, wechseln Sie zu "Einstellungen > ", und klicken Sie auf "Nach Updates suchen" (möglicherweise ist ein Neustart erforderlich).

  2. Stellen Sie sicher, dass Ihre App eine gültige Windows App SDK Mindestversion verwendet.

    • Stabiler Kanal: 1.8.0 (1.8.250907003) oder höher
    • Experimenteller Kanal (erforderlich für Phi Silica auf GPU): 2.2.2-experimental9 (Juni 2026 Experimental) oder höher

  3. Überprüfen Sie Einstellungen>Updates, um sicherzustellen, dass Windows-Updates nicht pausiert sind.

  4. Sammeln Sie Protokolle über die Windows Feedback Hub-Anwendung und teilen Sie sie mit dem Windows-Team, damit das Windows-Team sie überprüfen kann.

    1. Öffnen Sie die Feedback-Hub-App (Windows-TASTE+F).
    2. Melden Sie sich mit Ihrem bevorzugten Konto an.
    3. Geben Sie Fehlerdetails in Abschnitt 1 ein (präfixieren Sie den Fehlertitel mit "[Windows AI APIs]").
    4. Klicken Sie in Abschnitt 2 auf "Problem", wählen Sie " Entwicklerplattform " aus der ersten Dropdownliste aus, und wählen Sie dann im zweiten Dropdownmenü die Option "Windows AI Foundry " aus.
    5. In Abschnitt 3 wird vorhandenes Feedback angezeigt, das Ihrem ähnelt. Wenn vorhandenes Feedback nicht gefunden wird, wählen Sie "Neues Feedback " aus, und klicken Sie auf "Weiter".
    6. In Abschnitt 4 haben Sie folgende Möglichkeiten:
      1. Klicken Sie auf " Mein Problem neu erstellen", klicken Sie dann auf " Aufzeichnung starten", führen Sie AI Dev Gallery aus, reproduzieren Sie das Problem, beenden Sie die Aufzeichnung.
      2. Fügen Sie zusätzliche Informationen und Anlagen (z. B. Bilder) hinzu. Geben Sie so viele Details wie möglich an, einschließlich Der Wiedergabeschritte und Fehlermeldungen.
    7. Senden Sie das Feedback.

GPU-Problembehandlung (Phi-Silika)

Phi Silika auf GPU erfordert, dass der Entwicklermodus aktiviert ist (Einstellungssystem>>für Entwickler>entwicklermodus).

Das Ausführen von Phi-Silizium auf GPU erfordert den neuesten Treiber, der direkt vom GPU-Hersteller (NVIDIA GeForce 615.21 Beta) installiert ist. Amd GPU-Unterstützung wird in Kürze verfügbar sein. Standardtreiber von Windows Update- oder OEM-Installationen reichen möglicherweise nicht aus. Beachten Sie, dass OEM-Treiber oder Windows Update zuvor installierte GPU-Treiber überschreiben können – wenn Phi Silica nach einem Update nicht mehr funktioniert, installieren Sie den neuesten Treiber direkt vom GPU-Hersteller neu.

Die Phi-Silica-GPU-Unterstützung erfordert derzeit NVIDIA-GPUs (RTX-30-Serie oder neuer mit mindestens 6 GB VRAM). Amd GPU-Unterstützung wird in Kürze verfügbar sein. Wenn EnsureReadyAsync auf einem GPU-Gerät ein Fehler auftritt, überprüfen Sie, ob ihre GPU-Treiberversion die Mindestanforderungen erfüllt.

CPU-Problembehandlung (Video-Superauflösung, Spracherkennung)

Diese Features werden auf jeder CPU ausgeführt, funktionieren aber am besten auf Geräten, die die empfohlenen Spezifikationen erfüllen: mindestens 4 physische Kerne, 3 GHz oder höher Basisuhr und 32 MB oder mehr L3-Cache. Wenn langsame Leistung, Stotter oder reduzierte Qualität angezeigt werden, überprüfen Sie die Host-CPU anhand dieser Empfehlungen. Informationen zu einer Laufzeitüberprüfung, die true zurückgibt, wenn das Gerät die empfohlenen Spezifikationen erfüllt, finden Sie im MeetsRecommendedCpuSpecs C#-Beispiel in der Dokumentation zu Video Super Resolution.

Das VSR-Modell wird mit dem Windows App SDK ausgeliefert und kann nicht separat heruntergeladen werden. Wenn VSR nicht initialisiert werden kann, überprüfen Sie die Dokumentation VSR auf unterstützte Auflösungs- und Formateinschränkungen anstelle des Modellzustands.

Weitere Anleitungen

  • Apps, die Windows AI APIs verwenden, müssen zur Laufzeit die Paketidentität erhalten. Ausführliche Informationen finden Sie unter Vor- und Nachteile des Verpackens Ihrer App. Wenn der Fehler "UnauthorizedAccessException" (oder andere Zugriffsprobleme) angezeigt wird, stellen Sie sicher, dass Ihre App verpackt ist und die SystemAIModels-Funktion der Manifestdatei hinzugefügt wurde (siehe Erste Schritte beim Erstellen einer App mit Windows AI APIs).

  • Anforderungen für das Feature für eingeschränkten Zugriff (Limited Access Feature, LAF):

  • Eigenständige Apps können nicht aus dem Ordner "Downloads " (oder von einer beliebigen Stelle im C:\Users Ordner) ausgeführt werden. Weitere Informationen finden Sie unter Vor- und Nachteile der Verpackung Ihrer App und Übersicht über die Bereitstellung des Windows App SDK.

  • Der Berechtigungskanal für Windows Apps SDK enthält APIs und Features in frühen Stadien der Entwicklung. Alle APIs im Berechtigungskanal unterliegen umfangreichen Überarbeitungen und Breaking Changes und können jederzeit aus nachfolgenden Versionen entfernt werden. Experimentelle Features werden nicht für die Verwendung in Produktionsumgebungen und Apps unterstützt, die sie verwenden, können nicht im Microsoft Store veröffentlicht werden.

  • Geben Sie Feedback zu diesen APIs und ihren Funktionen, indem Sie ein neues Problem im GitHub-Repository des Windows App SDK erstellen (einschließlich Phi Silika im Titel) oder indem Sie auf ein vorhandenes Problem reagieren.

Siehe auch

  • Last updated on