Risoluzione dei problemi relativi all'API windows per intelligenza artificiale

Requisiti

Componenti fisici

Windows AI APIs supportano hardware diverso a seconda dell'API. Consulta la tabella dell'hardware supportato per una panoramica completa.

Per le funzionalità con accelerazione NPU, vedere Copilot+ PCs developer guide per un elenco dei dispositivi consigliati.

Programma informatico

Windows 11 versione 25H2 (build 10.0.26200.7309) o versioni successive deve essere installato nel PC Copilot+. È possibile verificarlo aprendo il menu Start, digitando "winver" e premendo INVIO (verrà visualizzata una finestra di dialogo con i dettagli del sistema operativo, simile al seguente).

Assicurarsi di poter usare le funzionalità Phi Silica:

1. Scaricare e installare l'app AI Dev Gallery da Microsoft Store.
2. Avvia l'app.
3. Selezionare Intelligenza artificiale APIs nel riquadro sinistro.
4. Fare clic su Phi Silica>Text Generation.
5. Verificare che Phi Silica risponda a un prompt (l'app di esempio inizia con un prompt predefinito).

Altre raccomandazioni

Abilitare la modalità sviluppatore in Impostazioni>sistema>per sviluppatori> modalitàsviluppatore.

Installare Visual Studio con i carichi di lavoro e i componenti necessari per lo sviluppo con WinUI e SDK per app di Windows. Per altri dettagli, vedere Carichi di lavoro e componenti necessari.

Risoluzione dei problemi

Se Phi Silica non sembra lavorare sul tuo sistema, ci sono alcune cose che puoi fare.

1. Verificare di avere installato tutti i modelli necessari passando a Impostazioni > Componenti > di intelligenza artificiale di sistema, che mostra i modelli di intelligenza artificiale disponibili nel sistema. Se il modello richiesto non è elencato, passare a Impostazioni > Windows Update e fare clic su "Controlla aggiornamenti" (potrebbe essere necessario un riavvio).

2. Verificare che l'app usi una versione minima SDK per app di Windows valida.

   • Canale stabile: 1.8.0 (1.8.250907003) o versione successiva
   • Canale sperimentale (obbligatorio per Phi Silica su GPU): 2.2.2-experimental9 (versione sperimentale di giugno 2026) o successiva

3. Selezionare Aggiornamenti delle impostazioni> per assicurarsi che gli aggiornamenti di Windows non siano sospesi.

4. Raccogliere tracce tramite l'app Hub Feedback di Windows e condividerle con il team di Windows per la revisione.

   1. Aprire l'app Hub di Feedback (tasto Windows + F).
   2. Accedere con l'account preferito.
   3. Immettere i dettagli del bug nella sezione 1 (anteporre il titolo del bug con "[Windows AI APIs]").
   4. Nella sezione 2 fare clic su Problema, selezionare Developer Platform dal primo elenco a discesa e quindi selezionare Windows AI Foundry nel secondo elenco a discesa.
   5. La sezione 3 visualizzerà qualsiasi feedback esistente simile al tuo. Se il feedback esistente non viene trovato, selezionare Nuovo feedback e fare clic su Avanti.
   6. Nella sezione 4 è possibile:
      1. Fare clic su Ricrea il problema, quindi fare clic su Avvia registrazione, eseguire AI Dev Gallery, riprodurre il problema, arrestare la registrazione.
      2. Includere informazioni aggiuntive e allegati (ad esempio immagini). Fornire il maggior numero di dettagli possibile, inclusi i passaggi di riproduzione e i messaggi di errore.
   7. Inviare il feedback.

Risoluzione dei problemi della GPU (Phi Silica)

Phi Silica in GPU richiede l'abilitazione della modalità sviluppatore (Impostazioni>sistema>per sviluppatori>modalità sviluppatore).

L'esecuzione di Phi Silica su GPU richiede l'installazione del driver più recente direttamente dal produttore della GPU (NVIDIA GeForce 615.21 beta). Il supporto GPU AMD sarà presto disponibile. I driver predefiniti di Windows Update o le installazioni OEM potrebbero non essere sufficienti. Si noti che i driver OEM o Windows Update possono sovrascrivere i driver GPU installati in precedenza, se Phi Silica smette di funzionare dopo un aggiornamento, reinstallare il driver più recente direttamente dal produttore della GPU.

Il supporto GPU Phi Silica richiede attualmente GPU NVIDIA (serie RTX 30 e versioni successive con vRAM da 6+ GB). Il supporto GPU AMD sarà presto disponibile. Se EnsureReadyAsync non riesce su un dispositivo GPU, verificare che la versione del driver della GPU soddisfi i requisiti minimi.

Risoluzione dei problemi relativi alla CPU (risoluzione con super risoluzione video, riconoscimento vocale)

Queste funzionalità vengono eseguite su qualsiasi CPU, ma funzionano meglio nei dispositivi che soddisfano le specifiche consigliate: almeno 4 core fisici, un clock di base di 3 GHz o superiore e 32 MB o più della cache L3. Se vengono visualizzate prestazioni lente, stutter o qualità ridotta, controllare la CPU host in base a queste raccomandazioni. Per un controllo in fase di esecuzione che restituisce true quando il dispositivo soddisfa le specifiche consigliate, consulta MeetsRecommendedCpuSpecs l'esempio C# nella documentazione di Video Super Resolution.

Il modello VSR viene fornito con il SDK per app di Windows e non è scaricabile separatamente. Se VSR non riesce a inizializzare, controllare la documentazione di VSR per i vincoli di risoluzione e formato supportati anziché lo stato del modello.

Altre indicazioni

• Le app che usano Windows AI APIs devono ricevere l'identità del pacchetto in fase di esecuzione. Per informazioni dettagliate, vedi Vantaggi e svantaggi della creazione di pacchetti dell'app. Se viene visualizzato un errore UnauthorizedAccessException (o si verificano altri problemi di accesso), assicurarsi che l'app sia inserita in un pacchetto e che la funzionalità systemAIModels sia stata aggiunta al file manifesto (vedere Introduzione alla creazione di un'app con Windows AI APIs).

• Requisiti della funzionalità di accesso limitato (LAF):

  • Verificare di aver richiesto e ricevuto un token LAF da Microsoft
  • I valori di stato seguenti indicano che LAF non è riuscito.
    • StatoFunzionalitàDiAccessoLimitato.NonDisponibile
    • LimitedAccessFeatureStatus.Unknown

• Le app autonome non possono essere eseguite dalla cartella Download (o da qualsiasi posizione nella C:\Users cartella). Per altri dettagli, vedi Vantaggi e svantaggi della creazione del pacchetto dell'app e panoramica della distribuzione di SDK per app di Windows.

• Il canale sperimentale di SDK per app di Windows include APIs e funzionalità nelle fasi iniziali dello sviluppo. Tutti APIs nel canale sperimentale sono soggetti a revisioni estese e modifiche sostanziali e potrebbero essere rimossi in qualsiasi momento dalle versioni future. Le funzionalità sperimentali non sono supportate per l'uso in ambienti di produzione e le app che le usano non possono essere pubblicate in Microsoft Store.

• Fornire commenti e suggerimenti su queste APIs funzionalità creando un nuovo problema nel repository GitHub di SDK per app di Windows (includere Phi Silica nel titolo) o rispondendo a un problema esistente.

Vedere anche

• AI Dev Gallery
• Esempi di API windows per intelligenza artificiale