Copilot в Windows

  • Статья

В этой статье описывается, как определить, доступен ли Copilot в Windows на текущем устройстве и, если эта функция доступна, как запустить Copilot в Windows с помощью схемы URI запуска Microsoft Edge. Методы, описанные в этой статье, предназначены для использования в ближайшее время. В будущих выпусках методы, описанные в этой статье, могут быть устаревшими и заменены более формальными и надежными API. Общие сведения и рекомендации по использованию Microsoft Copilot см . в документации и ресурсах Microsoft Copilot или обзоре Copilot с защитой коммерческих данных.

В Windows 11 версии 23H2 эта функция доступна в сборке 22631.3007 или более поздней версии. В Windows 11 версии 22H2 функция доступна в сборке 22621.3007 или более поздней версии. Для этой функции требуется Microsoft Edge версии 120.0.2210.121 или более поздней.

Проверка доступности Copilot в Windows на устройстве

Чтобы определить, доступен ли Copilot в Windows на устройстве Windows, проверка значение следующего раздела реестра. Значение 0 означает, что Copilot в Windows недоступна. Значение 1 означает, что Copilot в Windows доступен.

Товар Значение
Путь к разделу реестра HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\Copilot
Имя раздела реестра IsCopilotAvailable
Возможные значения 0 — недоступно или 1 — доступно

Запуск Copilot в Windows с помощью схемы URI запуска Microsoft Edge

После определения того, что Copilot в Windows доступен на текущем устройстве, приложения могут вызывать функцию с помощью схемы microsoft-edge://?ux=copilot&lcp=1URI запуска Microsoft Edge.

Эта схема URI поддерживает следующие параметры строки запроса, связанные с Copilot в Windows

Параметр Стоимость Описание Обязательное поле
Ux copilot Запускает Microsoft Edge в copilot в контексте Windows. Да
Lcp 1 Запускает Microsoft Edge в copilot в контексте Windows. Да
prompt Строка Необязательная строка, представляющая запрос, который будет передан в Copilot в Windows при запуске. No
код формы Строка Необязательный 6-значный идентификатор, который можно передать для идентификации входящего трафика. No
cpfilepath Строка Необязательная строка, содержащая путь к файлу, который будет передан в Copilot. No
cpfilemime Строка Необязательная строка, содержащая тип MIME файла, который будет передан в Copilot. No

Copilot в Windows имеет следующие требования к синтаксису:

  • Чтобы добавить в протокол, каждая пара "ключ-значение" должна быть разделена амперсандом.
  • Строка запроса должна быть закодирована URI / URI-escaped.
  • Строка запроса URI должна быть меньше или равна 2000 символам до кодирования URI.

Примеры

Ниже приведен пример URI для запуска Copilot в Windows.

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

Используйте параметр строки запроса запроса, чтобы указать запрос.

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