Windows AI API のトラブルシューティング

Requirements

ハードウェア

Phi Silica の機能には、Copilot+ PC が必要です (ノート PC キーボードには専用の Copilot キーがあります)。 推奨されるデバイスの一覧については、 Copilot+ PC 開発者ガイド を参照してください。

ソフトウェア

Windows 11 バージョン 25H2 (ビルド 10.0.26200.7309) 以降を Copilot+ PC にインストールする必要があります。 これを確認するには、[スタート] メニューを開き、「winver」と入力し、Enter キーを押します (次のような OS の詳細が表示されたダイアログ ボックスが表示されます)。

Phi Silica の機能を使用できることを確認します。

1. Microsoft Store から AI Dev Gallery アプリをダウンロードしてインストールします。
2. アプリを実行します。
3. 左側のウィンドウから [AI APIs ] を選択します。
4. [Phi Silica>Text Generation] をクリックします。
5. Phi Silica がプロンプトに応答することを確認します (サンプル アプリは既定のプロンプトで開始されます)。

その他の推奨事項

Settings>>> で開発者モードを有効にします。

WinUI と Windows App SDK を使用した開発に必要なワークロードとコンポーネントを含む Visual Studio をインストールします。 詳細については、「 必要なワークロードとコンポーネント」を参照してください。

デバッグ

Phi Silica がシステムで動作していないように見える場合は、いくつかのことができます。

1. [システム > AI コンポーネントの設定] >移動して、必要なすべてのモデルがインストールされていることを確認します。このコンポーネントには、システムで使用可能な AI モデルが表示されます。 必要なモデルが一覧にない場合は、[ Windows Update > 設定] に移動し、[更新プログラムの確認] をクリックします (再起動が必要な場合があります)。

2. アプリで有効な WinAppSDK 最小バージョンが使用されていることを確認します。

   • 安定: 1.8.3
   • 試験段階: 2.0-Exp3

3. [設定]>[更新]をオンにして、Windows の更新プログラムが一時停止されていないことを確認します。

4. Windows フィードバック ハブ アプリを使用してトレースを収集し、Windows チームと共有して確認します。

   1. フィードバック ハブ アプリを開きます (Windows キー + F キー)。
   2. お好みのアカウントでサインインします。
   3. セクション 1 にバグの詳細を入力します (バグ タイトルの前に "[Windows AI APIs]" を付けます)。
   4. セクション 2 で、[ 問題] をクリックし、最初のドロップダウンから [開発者プラットフォーム ] を選択し、2 番目のドロップダウンから [Windows AI Foundry ] を選択します。
   5. セクション 3 には、お客様に似た既存のフィードバックが表示されます。 既存のフィードバックが見つからない場合は、[ 新しいフィードバック ] を選択し、[ 次へ] をクリックします。
   6. セクション 4 では、次のことができます。
      1. [ 問題の再作成]、[ 記録の開始]、[AI 開発ギャラリーの実行]、[問題の再現]、[記録の停止] の順にクリックします。
      2. 追加情報と添付ファイル (画像など) を含めます。 再生手順やエラー メッセージなど、可能な限り詳細を指定します。
   7. フィードバックを送信します。

その他のガイダンス

• Windows AI APIsを使用するアプリには、実行時にパッケージ ID を付与する必要があります。 詳細については、 アプリのパッケージ化の長所と短所に関するページを参照してください。 UnauthorizedAccessException エラー (またはその他のアクセスの問題) が発生している場合は、アプリがパッケージ化され、systemAIModels 機能がマニフェスト ファイルに追加されていることを確認します (「Windows AI APIsを使用したアプリのビルドの開始」を参照してください)。

• 制限付きアクセス機能 (LAF) の要件:

  • Microsoft から LAF トークンを要求して受け取ったことを確認します
  • 次の状態値は、LAF が失敗したことを示しています。
    • LimitedAccessFeatureStatus.Unavailable
    • LimitedAccessFeatureStatus.Unknown

• 自己完結型アプリは 、ダウンロード フォルダーから (または C:\Users フォルダーの下の任意の場所から) 実行できません。 詳細については、アプリと Windows App SDK のデプロイの概要をパッケージ化する利点と欠点に関するページを参照してください。

• Windows App SDK の実験用チャネルには、開発の初期段階で APIs と機能が含まれています。 実験用チャネルのすべての APIs は、広範な変更と破壊的変更の対象となり、今後のリリースからいつでも削除される可能性があります。 試験段階の機能は運用環境での使用はサポートされておらず、使用するアプリは Microsoft Store に公開できません。

• Windows App SDK GitHub リポジトリにAPIs (タイトルに Phi Silica を含む) を作成するか、既存の問題に対応することで、これらのとその機能に関するフィードバックを提供します。

こちらも参照ください

• AI 開発ギャラリー
• Windows AI API のサンプル