Proveedores de claves de hardware de Microsoft Copilot

A partir de Windows Build 22621, las aplicaciones se pueden registrar para incluirse en la interfaz de usuario del selector que permite a los usuarios seleccionar la aplicación que se inicia cuando se presiona la tecla de hardware de Microsoft Copilot o la tecla de Windows + C.

Nota:

Se recomienda que las aplicaciones que se registren como proveedor de claves de hardware de Microsoft Copilot se implementen como aplicaciones de una sola ventana.

Extensión de la aplicación de clave de hardware de Microsoft Copilot

Una aplicación debe empaquetarse para registrarse como proveedor de claves de hardware de Microsoft Copilot. Para obtener información sobre el empaquetado de aplicaciones, consulte Introducción a la identidad del paquete en la aplicación de Windows. El archivo de manifiesto del paquete de aplicación, Package.appxmanifest, admite muchas extensiones y características diferentes para aplicaciones de Windows. El formato del manifiesto de paquete de la aplicación se define mediante un conjunto de esquemas que se documentan en la referencia del esquema del manifiesto del paquete. Los proveedores de claves de hardware de Microsoft Copilot declaran su información de registro en uap3:AppExtension. El atributo Name de la extensión debe establecerse en "com.microsoft.windows.copilotkeyprovider".

<Package
...

  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
...>
    <Applications>
        <Application...>
            ...
            <Extensions>
                <uap3:Extension Category="windows.appExtension">
                    <uap3:AppExtension Name="com.microsoft.windows.copilotkeyprovider" 
                        Id="MyAppId"
                        DisplayName="App display name"
                        Description="App description"
                        PublicFolder="Public" />
                </uap3:Extension>
            </Extensions>
          ...
    </Application>
    </Applications>
    ...
</Package>

En la tabla siguiente uap3:AppExtension se describen los atributos del elemento uap3:AppExtension .

Atributo	Descripción	Obligatorio
Id	Identificador definido por la aplicación para la aplicación.	Sí
DisplayName (Nombre para mostrar)	Nombre de la aplicación que se muestra en la interfaz de usuario del selector de botones de hardware de Windows Copilot.	Sí
Descripción	La descripción de la aplicación que se muestra en la interfaz de usuario del selector de botones de hardware de Windows Copilot.	Sí
PublicFolder	Carpeta que la instancia declara como la ubicación en la que un host tiene acceso de lectura a los archivos a través de un agente.	Sí

Autenticar el proveedor de claves hardware de Windows Copilot

Las aplicaciones del proveedor deben iniciar sesión para habilitarse como destino de la clave de hardware de Microsoft Copilot. Para obtener información sobre el empaquetado y la firma de la aplicación, consulta Empaquetar una aplicación de escritorio o para UWP en Visual Studio.

Consulta del proveedor actual de claves de hardware de Copilot

Compruebe si su aplicación es el objetivo del usuario para la tecla de hardware Copilot y el método abreviado de teclado tecla Windows + C consultando el valor de las siguientes claves del Registro. Para obtener más información, consulte Recuperación de datos del Registro.

Clave del Registro	Descripción	Importancia
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\BrandedKeyChoiceType	Identifica si el usuario ha seleccionado Buscar o una aplicación como destino de la clave de Copilot. El valor "AppEnforcedByPolicy" indica que una política establecida por el administrador de TI ha configurado un objetivo de aplicación para la clave de Copilot. Para obtener más información, consulte Directiva CSP – WindowsAI.	"Buscar", "Aplicación", "AppEnforcedByPolicy"
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\AppAumid	Identifica el identificador del modelo de usuario de aplicación (AUMID, también conocido como AppId) del proveedor de claves de hardware de Copilot que se configuró por última vez, incluso si la clave está configurada actualmente a Buscar.	Un AUMID.

Para proporcionar una buena experiencia de usuario, las aplicaciones deben respetar la selección del usuario para la aplicación del proveedor de claves de hardware de Copilot y no deben mostrar solicitudes persistentes o ruidosas para que el usuario cambie su selección.