Verificare la disponibilità del modello prima di implementare una funzionalità di intelligenza artificiale
Importante
Disponibile nella versione più recente canale sperimentale di Windows App SDK.
Il canale sperimentale di Windows App SDK include API e funzionalità nelle fasi iniziali dello sviluppo. Tutte le API nel canale sperimentale sono soggette a revisioni estese e modifiche di rilievo e possono essere rimosse dalle versioni successive in qualsiasi momento. 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.
Quando si implementa una funzionalità di intelligenza artificiale usando le API di Runtime di Windows Copilot, l'app deve prima verificare la disponibilità del modello di intelligenza artificiale che supporta tale funzionalità. A differenza delle API tipiche di Windows App SDK in cui uno sviluppatore può chiamare su un'API per fornire immediatamente funzionalità o contenuti, le API di Windows Copilot Runtime si basano sul modello per essere disponibili nel computer degli utenti dell'app.
Verifica della disponibilità del modello
Per verificare se il modello richiesto da una funzionalità di intelligenza artificiale è disponibile nel dispositivo dell'utente, iniziare chiamando: IsAvailable()
. Questo metodo restituirà true
se il modello chiamato viene installato nel dispositivo dell'utente. Questo metodo deve essere chiamato prima di ogni chiamata al modello.
Se il modello non è disponibile nel dispositivo dell'utente, è possibile chiamare il metodo MakeAvailableAsync()
per installare il modello richiesto. L'installazione del modello verrà eseguita in background e l'utente sarà in grado di controllare lo stato di avanzamento dell'installazione nella pagina Windows Update dell'applicazione Impostazioni.
Il metodo MakeAvailableAsync()
ha un'opzione di stato che può mostrare un'interfaccia utente di caricamento. Se l'utente non ha hardware supportato, MakeAvailableAsync()
avrà esito negativo con un errore.
Quando il modello è disponibile, è possibile chiamare CreateAsync()
per creare una nuova istanza da una classe appartenente al modello. Le API che appartengono a tale classe possono quindi essere usate nell'app.
Esempio di codice
Nell'esempio seguente viene illustrato il controllo della disponibilità del modello.
using Microsoft.Windows.AI.Generative;
if (!LanguageModel.IsAvailable())
{
var op = await LanguageModel.MakeAvailableAsync();
}
using LanguageModel languageModel = await LanguageModel.CreateAsync();
string prompt = "Provide the molecular formula for glucose.";
var result = await languageModel.GenerateResponseAsync(prompt);
Console.WriteLine(result.Response);