共用方式為


Windows AI API 疑難排解

這很重要

使用 Phi Silica APIs 的應用程式可能會遇到有限存取功能支援(參見 LimitedAccess Features)的問題。

目前,我們建議使用 實驗性版本 ,因為它們不需要 LAF 代幣。

需求

硬體

Phi Silica 的功能需要 Copilot+ PC(筆電鍵盤有專用的 Copilot 鍵)。 請參閱 Copilot+ PC 開發者指南 ,了解推薦裝置清單。

軟體

必須在 Copilot+ 電腦上安裝 Windows 11 版本 25H2(建號 10.0.26200.7309)或更高版本。 可透過開啟開始選單、輸入「winver」並按下 Enter 鍵來驗證(會出現一個包含作業系統細節的對話框,類似以下內容)。

輸入「winver」並按 Enter 顯示的 Windows 版本對話截圖。

確保你能使用 Phi Silica 的功能:

  1. 從 Microsoft Store 下載並安裝 AI 開發者畫廊應用程式。
  2. 執行應用程式。
  3. 從左側窗格選擇 AI APIs
  4. 點擊 Phi Silica>文字生成
  5. 確認 Phi Silica 會回應提示(範例應用程式以預設提示開始)。

AI 開發者畫廊範例應用程式的截圖,展示了文字生成功能的基本範例。

其他建議

啟用設定>中的>選項裡的>。

安裝 Visual Studio,並設定開發 WinUI 和 Windows App SDK 所需的工作負載和元件。 如需詳細資訊,請參閱 必要的工作負載和元件

偵錯 / 除錯

如果 Phi Silica 在你的系統上似乎沒有效果,你有幾件事可以做。

  1. 請到設定>>系統 AI 組件中查看所有必需模型,該系統會顯示系統可用的 AI 模型。 如果沒有列出所需型號,請到 設定 > 中的 Windows Update 點選「檢查更新」(可能需要重新啟動)。

  2. 確認你的應用程式使用的是有效的 WinAppSDK 最低版本。

    • 穩定版:1.8.3
    • 實驗版:2.0-Exp3
  3. 檢查 設定>更新 ,確保 Windows 更新沒有被暫停。

  4. 透過 Windows 回饋中心應用程式收集追蹤資料,並與 Windows 團隊分享以便檢視。

    1. 打開 Feedback Hub 應用程式(Windows 鍵 + F)。
    2. 請用您偏好的帳號登入。
    3. 在第 1 節輸入錯誤細節(錯誤標題前加「[Windows AI APIs]」)。
    4. 在第 2 節,點選 「問題」,從第一個下拉選單選擇 「開發者平台 」,再從第二個下拉選單選擇 「Windows AI Foundry 」。
    5. 第三部分將顯示任何與你相似的現有回饋。 如果找不到現有回饋,請選擇 新回饋 並點擊 「下一步」。
    6. 在第四節中,你可以:
      1. 點擊 重現我的問題,然後點擊 開始錄製,運行 AI 開發者圖庫,重現問題,然後停止錄製。
      2. 請附上額外資訊與附件(如圖片)。 盡可能提供詳細資訊,包括重現步驟及錯誤訊息。
    7. 提交意見反應。

其他指引

  • 使用 的 Windows AI APIs 應用程式需要在執行時被賦予套件身份。 如需詳細資訊,請參閱 封裝應用程式的優點和缺點。 如果你看到 UnauthorizedAccessException 錯誤(或其他存取問題),請確認你的應用程式已打包,且 systemAIModels 功能已加入清單檔案(參見「 開始建立應用程式」) Windows AI APIs

  • 有限存取特性(LAF)要求:

  • 獨立應用程式無法從 Downloads 資料夾(或資料夾下方 C:\Users 的任何位置)執行。 如需詳細資訊,請參閱封裝應用程式和 Windows App SDK 部署概觀的優點和缺點

  • Windows App SDK 實驗通道包含開發初期階段的 APIs 和其他功能。 實驗通道中的所有 APIs 都可能進行大幅度的修改和重大變更,並可能隨時從後續版本中移除。 實驗性功能不支援在生產環境中使用,且使用它們的應用程式無法發佈至Microsoft市集。

  • 透過在 Windows App SDK GitHub 存放庫中建立APIs(標題中包括Phi Silica),或回應現有問題,提供這些及其功能的回饋意見。

另請參閱