Windows の Copilot

  • [アーティクル]

この記事では、Windows の Copilot が現在のデバイスで使用できるかどうかを判断する方法と、機能が使用可能な場合は、Microsoft Edge 起動 URI スキームを使用して Windows で Copilot を起動する方法について説明します。 この記事で説明する手法は、近い将来使用することを目的としています。 今後のリリースでは、この記事で説明されているメソッドは非推奨になり、より正式で信頼性の高い API に置き換えられる可能性があります。 Microsoft Copilot の使用に関する一般的な情報とガイダンスについては、Microsoft Copilot のドキュメントとリソース、または商用データ保護を使用した Copilot の概要を参照してください。

Windows 11 バージョン 23H2 では、この機能はビルド 22631.3007 以降で使用できます。 Windows 11 バージョン 22H2 では、この機能はビルド 22621.3007 以降で使用できます。 この機能には Microsoft Edge バージョン 120.0.2210.121 以降が必要です。

デバイス上の Windows の可用性で Copilot を確認する

Windows デバイスで Copilot が使用できるかどうかを判断するには、次のレジストリ キーの値をチェックします。 値が 0 の場合、Windows の Copilot は使用できません。 値が 1 の場合、Windows の Copilot が使用できます。

Item Value
レジストリ パス HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\Copilot
レジストリ キー名 IsCopilotAvailable
有効値 0 – 使用不可、または 1 - 使用可能

Microsoft Edge 起動 URI スキームを使用して Windows で Copilot を起動する

Windows の Copilot が現在のデバイスで使用できるようになったら、アプリケーションは Microsoft Edge 起動 URI スキーム microsoft-edge://?ux=copilot&lcp=1 を使用して機能を呼び出すことができます。

この URI スキームでは、Windows の Copilot に関連する次のクエリ文字列パラメーターがサポートされます

パラメーター Value 説明 必須
ux copilot Windows コンテキストで、Copilot で Microsoft Edge を起動します。 はい
lcp 1 Windows コンテキストで、Copilot で Microsoft Edge を起動します。 はい
prompt 文字列 起動時に Windows の Copilot に渡されるプロンプトを表す省略可能な文字列。 いいえ
formcode 文字列 着信トラフィックの識別に役立つ、渡すことができる省略可能な 6 桁の識別子。 いいえ
cpfilepath 文字列 Copilot に渡されるファイルのファイル パスを含む省略可能な文字列。 いいえ
cpfilemime 文字列 Copilot に渡されるファイルの MIME の種類を含む省略可能な文字列。 いいえ

Windows の Copilot には、次の構文要件があります。

  • プロトコルに追加するには、各キーと値のペアをアンパサンドで区切る必要があります。
  • プロンプト文字列は、URI エンコード/URI エスケープする必要があります。
  • URI のプロンプト文字列部分は、URI エンコードの前に 2000 文字以下にしておく必要があります。

例

Windows で Copilot を起動する URI の例を次に示します。

microsoft-edge://?ux=copilot&lcp=1

プロンプトを指定するには、prompt クエリ文字列パラメーターを使用します。

microsoft-edge://?ux=copilot&lcp=1&prompt=Explain%20This%3A%2020%2F20%20Vision

formcode パラメーターの123456を指定します。

microsoft-edge://?ux=copilot&lcp=1&prompt=Explain%20This%3A%2020%2F20%20Vision&formcode=123456

cpfilepath と cpfilemime を使用して、Copilot に渡されるファイルを指定します。

microsoft-edge://?ux=copilot&lcp=1&prompt=What%20is%20this%20a%20picture%20of%3F&formcode=123456&cpfilepath=C%3A%5CUsers%5Cme%5CDownloads%5CCopilot.png&cpfilemime=image%2Fpng