這很重要
使用 Phi Silica APIs 的應用程式可能會遇到有限存取功能支援(參見 LimitedAccess Features)的問題。
目前,我們建議使用 實驗性版本 ,因為它們不需要 LAF 代幣。
需求
硬體
Phi Silica 的功能需要 Copilot+ PC(筆電鍵盤有專用的 Copilot 鍵)。 請參閱 Copilot+ PC 開發者指南 ,了解推薦裝置清單。
軟體
必須在 Copilot+ 電腦上安裝 Windows 11 版本 25H2(建號 10.0.26200.7309)或更高版本。 可透過開啟開始選單、輸入「winver」並按下 Enter 鍵來驗證(會出現一個包含作業系統細節的對話框,類似以下內容)。
確保你能使用 Phi Silica 的功能:
- 從 Microsoft Store 下載並安裝 AI 開發者畫廊應用程式。
- 執行應用程式。
- 從左側窗格選擇 AI APIs 。
- 點擊 Phi Silica>文字生成。
- 確認 Phi Silica 會回應提示(範例應用程式以預設提示開始)。
其他建議
啟用設定>中的>選項裡的>。
安裝 Visual Studio,並設定開發 WinUI 和 Windows App SDK 所需的工作負載和元件。 如需詳細資訊,請參閱 必要的工作負載和元件。
偵錯 / 除錯
如果 Phi Silica 在你的系統上似乎沒有效果,你有幾件事可以做。
請到設定>>系統 AI 組件中查看所有必需模型,該系統會顯示系統可用的 AI 模型。 如果沒有列出所需型號,請到 設定 > 中的 Windows Update 點選「檢查更新」(可能需要重新啟動)。
確認你的應用程式使用的是有效的 WinAppSDK 最低版本。
- 穩定版:1.8.3
- 實驗版:2.0-Exp3
檢查 設定>更新 ,確保 Windows 更新沒有被暫停。
透過 Windows 回饋中心應用程式收集追蹤資料,並與 Windows 團隊分享以便檢視。
- 打開 Feedback Hub 應用程式(Windows 鍵 + F)。
- 請用您偏好的帳號登入。
- 在第 1 節輸入錯誤細節(錯誤標題前加「[Windows AI APIs]」)。
- 在第 2 節,點選 「問題」,從第一個下拉選單選擇 「開發者平台 」,再從第二個下拉選單選擇 「Windows AI Foundry 」。
- 第三部分將顯示任何與你相似的現有回饋。 如果找不到現有回饋,請選擇 新回饋 並點擊 「下一步」。
- 在第四節中,你可以:
- 點擊 重現我的問題,然後點擊 開始錄製,運行 AI 開發者圖庫,重現問題,然後停止錄製。
- 請附上額外資訊與附件(如圖片)。 盡可能提供詳細資訊,包括重現步驟及錯誤訊息。
- 提交意見反應。
其他指引
使用 的 Windows AI APIs 應用程式需要在執行時被賦予套件身份。 如需詳細資訊,請參閱 封裝應用程式的優點和缺點。 如果你看到 UnauthorizedAccessException 錯誤(或其他存取問題),請確認你的應用程式已打包,且 systemAIModels 功能已加入清單檔案(參見「 開始建立應用程式」) Windows AI APIs。
有限存取特性(LAF)要求:
- 確認你已向 Microsoft 申請並收到 LAF 令牌
- 以下狀態值表示LAF已失敗。
獨立應用程式無法從 Downloads 資料夾(或資料夾下方
C:\Users的任何位置)執行。 如需詳細資訊,請參閱封裝應用程式和 Windows App SDK 部署概觀的優點和缺點。Windows App SDK 實驗通道包含開發初期階段的 APIs 和其他功能。 實驗通道中的所有 APIs 都可能進行大幅度的修改和重大變更,並可能隨時從後續版本中移除。 實驗性功能不支援在生產環境中使用,且使用它們的應用程式無法發佈至Microsoft市集。
透過在 Windows App SDK GitHub 存放庫中建立APIs(標題中包括Phi Silica),或回應現有問題,提供這些及其功能的回饋意見。