Udostępnij za pośrednictwem

Wprowadzenie do tworzenia aplikacji za pomocą sztucznej inteligencji systemu Windows APIs

Dowiedz się więcej o wymaganiach sprzętowych dotyczących sztucznej inteligencji systemu Windows API i sposobach konfigurowania urządzenia w celu pomyślnego kompilowania aplikacji przy użyciu sztucznej inteligencji APIssystemu Windows.

Zależności

Upewnij się, że komputer obsługuje sztuczną inteligencję APIs systemu Windows i że są zainstalowane wszystkie zależności. Możesz to zrobić automatycznie (zalecane) lub ręcznie.

  1. Upewnij się, że urządzenie jest komputerem copilot+ (zalecamy urządzenia wymienione w przewodniku dewelopera Copilot+ PCs).

  2. Uruchom następujące polecenie w terminalu systemu Windows.

    winget configure https://raw.githubusercontent.com/microsoft/winget-dsc/refs/heads/main/samples/Configuration%20files/Learn%20tutorials/Windows%20AI/learn_wcr.winget

    Spowoduje to uruchomienie pliku konfiguracji WinGet , który wykonuje następujące zadania:

    • Sprawdza minimalną wersję systemu operacyjnego.
    • Włącza tryb dewelopera.
    • Instaluje program Visual Studio Community Edition z pakietem WinUI i innymi wymaganymi obciążeniami.
    • Instaluje zestaw SDK aplikacji systemu Windows.

Tworzenie nowej aplikacji

W poniższych krokach opisano sposób tworzenia aplikacji korzystającej ze sztucznej inteligencji APIs systemu Windows (wybierz kartę preferowanej struktury interfejsu użytkownika).

  1. W programie Visual Studio utwórz nowy projekt WinUI, wybierając szablon Pusta aplikacja, Pakowana (WinUI 3 na komputerze stacjonarnym).

    Zrzut ekranu przedstawiający nowy interfejs użytkownika projektu programu Visual Studio z wybranym szablonem WinUI.

  2. W Eksploratorze rozwiązań kliknij prawym przyciskiem myszy węzeł projektu, wybierz pozycję Właściwości>Ogólne aplikacji> i upewnij się, że platforma docelowa jest ustawiona na .NET 8.0, a docelowy system operacyjny ma wartość 10.0.22621 lub nowszą.

    Zrzut ekranu przedstawiający okienko właściwości projektu programu Visual Studio

  3. Edytuj plik Package.appxmanifest (kliknij prawym przyciskiem myszy i wybierz pozycję Wyświetl kod) i dodaj następujące fragmenty kodu.

    • Możliwość systemAIModels węzła <Capabilities> :

      <Capabilities>
   <systemai:Capability Name="systemAIModels"/>
</Capabilities>

    • Specyfikator przestrzeni nazw systemai do "IgnorableNamespaces" w węźle <Package>:

      xmlns:systemai="http://schemas.microsoft.com/appx/manifest/systemai/windows10"
IgnorableNamespaces="uap rescap systemai"

    • Maksymalna wersja przetestowana w TargetDeviceFamily elemenie węzła <Dependencies> musi być co najmniej 10.0.26226.0:

      <TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.17763.0" MaxVersionTested="10.0.26226.0" />

  4. Dodaj następujący kod do pliku .waproj, csproj lub .vcxproj. Ten krok jest niezbędny, aby upewnić się, że program Visual Studio nie zastępuje maksymalnej wersji przetestowanej.

    <AppxOSMinVersionReplaceManifestVersion>false</AppxOSMinVersionReplaceManifestVersion>
<AppxOSMaxVersionTestedReplaceManifestVersion>false</AppxOSMaxVersionTestedReplaceManifestVersion>

  5. Kliknij prawym przyciskiem myszy węzeł projektu i wybierz polecenie Zarządzaj pakietami NuGet....

  6. W Menedżerze pakietów NuGet zaznacz pole Uwzględnij wersję wstępną i wybierz wersję 1.8.250410001-experimental1 Zestawu SDK aplikacji systemu Windows. Kliknij pozycję Zainstaluj lub zaktualizuj.

    Zrzut ekranu przedstawiający menedżera pakietów NuGet programu Visual Studio z wybraną wersją Microsoft.WindowsAppSDK 1.8.250410001-experimental1.

  7. Upewnij się, że konfiguracja kompilacji jest ustawiona na ARM64.

    Zrzut ekranu przedstawiający konfigurację kompilacji programu Visual Studio ustawioną na ARM64.

  8. Skompiluj i uruchom aplikację.

  9. Jeśli aplikacja zostanie uruchomiona pomyślnie, przejdź do sekcji Dodaj swoją pierwszą sztuczną inteligencję API. W przeciwnym razie zobacz Rozwiązywanie problemów.

Dodaj swoją pierwszą AI API

Podczas implementowania funkcji przy użyciu sztucznej inteligencji systemu Windows APIsaplikacja powinna najpierw sprawdzić dostępność modelu AI, który obsługuje tę funkcję.

Poniższy fragment kodu pokazuje, jak sprawdzić dostępność modelu i wygenerować odpowiedź.

  1. W pliku MainWindow.xaml dodaj element TextBlock , aby wyświetlić odpowiedź LanguageModel .

    <TextBlock x:Name="OutputText" HorizontalAlignment="Center" VerticalAlignment="Center" />

  2. W górnej części MainWindow.xaml.cs dodaj następującą using Microsoft.Windows.AI dyrektywę.

    using Microsoft.Windows.AI;

  3. W MainWindow.xaml.cspliku zastąp klasę MainWindow następującym kodem, który potwierdza, że model LanguageModel jest dostępny, a następnie przesyła monit z prośbą o odpowiedź modelu na formułę molekularną glukozy.

    public sealed partial class MainWindow : Window
{
    public MainWindow()
    {
        this.InitializeComponent();
        InitAI();
    }

    private async void InitAI()
    {
        OutputText.Text = "Loading..";

        if (LanguageModel.GetReadyState() == AIFeatureReadyState.EnsureNeeded)
        {
            var result = await LanguageModel.EnsureReadyAsync();
            if (result.Status != PackageDeploymentStatus.CompletedSuccess)
            {
                throw new Exception(result.ExtendedError().Message);
            }
        }            

        using LanguageModel languageModel = 
           await LanguageModel.CreateAsync();

        string prompt = "Provide the molecular formula of glucose.";
        var result = await languageModel.GenerateResponseAsync(prompt);
        OutputText.Text = result.Response;
    }
}

  4. Skompiluj i uruchom aplikację.

  5. Formuła glukozy powinna pojawić się w bloku tekstowym.

Zaawansowane samouczki i APIs

Po pomyślnym sprawdzeniu dostępności modelu, zgłębiaj APIs dalej w różnych samouczkach dotyczących sztucznej inteligencji API systemu Windows.

Rozwiązywanie problemów

Jeśli wystąpią jakiekolwiek błędy, zazwyczaj jest to spowodowane sprzętem lub brakiem wymaganego modelu.

  • Metoda GetReadyState sprawdza, czy model wymagany przez funkcję sztucznej inteligencji jest dostępny na urządzeniu użytkownika. Tę metodę należy wywołać przed wszelkimi wywołaniami związanymi z modelem.
  • Jeśli model nie jest dostępny na urządzeniu użytkownika, możesz wywołać metodę EnsureReadyAsync , aby zainstalować wymagany model. Instalacja modelu jest uruchamiana w tle, a użytkownik może sprawdzić postęp instalacji na stronie Ustawienia>systemu Windows Windows Update .
  • Metoda EnsureReadyAsync ma opcję stanu, która może wyświetlać interfejs użytkownika pokazujący ładowanie. Jeśli użytkownik ma nieobsługiwany sprzęt, funkcja EnsureReadyAsync zakończy się niepowodzeniem z powodu błędu.

Aby uzyskać więcej pomocy, zobacz Rozwiązywanie problemów ze sztuczną inteligencją systemu Windows API i często zadawane pytania .

Zobacz także