Sdílet prostřednictvím

Řešení potíží s rozhraním API pro Windows AI

Důležité

Aplikace používající Phi Silica APIs můžou narazit na problémy s podporou funkce omezeného přístupu (viz LimitedAccessFeatures).

V tuto chvíli doporučujeme používat experimentální verze , protože nevyžadují tokeny LAF.

Požadavky

Hardwarová zařízení

Funkce Phi Silica vyžadují počítač Copilot+ (přenosné klávesnice mají vyhrazenou klávesu Copilot). Podívejte se na příručku pro vývojáře Copilot+ PC pro seznam doporučených zařízení.

Softwarový produkt

Windows 11, verze 25H2 (build 10.0.26200.7309) nebo novější musí být nainstalován na počítači Copilot+. Můžete to ověřit tak, že otevřete nabídku Start, zadáte "winver" a stisknete Enter (mělo by se zobrazit dialogové okno s podrobnostmi operačního systému, podobně jako v následujícím příkladu).

Snímek obrazovky s dialogovým oknem verze systému Windows, které se zobrazuje zadáním

Ujistěte se, že můžete používat funkce Phi Silica:

  1. Stáhněte a nainstalujte aplikaci AI Dev Gallery z Microsoft Storu.
  2. Spustit aplikaci.
  3. V levém podokně vyberte AI APIs.
  4. Klikněte na Phi Silica>Text Generation.
  5. Ověřte, že Phi Silica reaguje na výzvu (ukázková aplikace začíná výchozí výzvou).

Snímek obrazovky ukázkové aplikace AI Dev Gallery zobrazující základní příklad funkce Generování textu

Další doporučení

Povolte vývojářský režim v nastavení>systému>pro vývojáře>vývojářský režim.

Nainstalujte Sadu Visual Studio s úlohami a komponentami potřebnými k vývoji pomocí WinUI a sady Windows App SDK. Další podrobnosti najdete v tématu Požadované úlohy a komponenty.

Odstraňování chyb

Pokud Se zdá, že Phi Silica nefunguje na vašem systému, existuje několik věcí, které můžete udělat.

  1. Ověřte, že máte nainstalované všechny požadované modely, a to tak, že přejdete do části Nastavení > systémových > komponent AI, které zobrazují modely AI dostupné v systému. Pokud požadovaný model není uvedený, přejděte na Nastavení > služby Windows Update a klikněte na Vyhledat aktualizace (může se vyžadovat restartování).

  2. Ověřte, že vaše aplikace používá platnou minimální verzi WinAppSDK.

    • Stabilní: 1.8.3
    • Experimentální: 2.0-Exp3

  3. Zkontrolujteaktualizace> a ujistěte se, že nejsou pozastavené aktualizace Windows.

  4. Sbírejte trasování prostřednictvím aplikace Windows Feedback Hub a sdílejte je s týmem Windows, aby je mohli zkontrolovat.

    1. Otevřete aplikaci Centrum Feedback (klávesa Windows + F).
    2. Přihlaste se pomocí svého upřednostňovaného účtu.
    3. Zadejte podrobnosti o chybě v oddílu 1 (předpona názvu chyby "[Windows AI APIs]").
    4. V oddílu 2 klikněte na Problém, v prvním rozevíracím seznamu vyberte Vývojářská platforma a pak v druhém rozevíracím seznamu vyberte Windows AI Foundry .
    5. Oddíl 3 zobrazí všechny existující názory, které jsou podobné vašemu. Pokud se existující zpětná vazba nenajde, vyberte Nový názor a klikněte na Další.
    6. V části 4 můžete:
      1. Klikněte na Znovu vytvořit můj problém a potom klikněte na Spustit nahrávání, spusťte galerii vývojářů AI, reprodukujte problém, zastavte nahrávání.
      2. Uveďte další informace a přílohy (například obrázky). Uveďte co nejvíce podrobností, včetně kroků pro reprodukci a chybových zpráv.
    7. Odešlete zpětnou vazbu.

Další pokyny

  • Aplikace, které používají Windows AI APIs , musí mít udělenou identitu balíčku za běhu. Podrobnosti najdete v tématu Výhody a nevýhody balení aplikace. Pokud se zobrazí chyba UnauthorizedAccessException (nebo máte jiné problémy s přístupem), ujistěte se, že je vaše aplikace zabalená a funkce systemAIModels byla přidána do souboru manifestu (viz Začínáme se sestavováním aplikace pomocí Windows AI APIs).

  • Požadavky na funkci omezeného přístupu (LAF):

  • Samostatné aplikace se nedají spustit ze složky Stažené soubory (ani z libovolného místa ve C:\Users složce). Další podrobnosti najdete v tématu Výhody a nevýhody balení aplikace a přehled nasazení sady Windows App SDK.

  • Experimentální kanál sady Windows App SDK zahrnuje APIs a funkce v počátečních fázích vývoje. Všechny APIs v experimentálním kanálu podléhají rozsáhlým revizím a výrazným změnám a mohou být odstraněny z následných verzí kdykoli. Experimentální funkce nejsou podporovány pro použití v produkčních prostředích a aplikacích, které je používají, nelze publikovat do Microsoft Storu.

  • Poskytněte nám zpětnou vazbu k těmto APIs funkcím vytvořením nového problému v úložišti GitHub sady Windows App SDK (včetně Phi Silica v názvu) nebo reagováním na existující problém.

Viz také

  • Last updated on