Copilot dans Windows

Cet article décrit comment déterminer si Copilot dans Windows est disponible sur l’appareil actuel et la fonctionnalité est disponible. Cet article traite également de la manière de lancer Copilot dans Windows, à l’aide du schéma d’URI de lancement Microsoft Edge. Les techniques décrites dans cet article sont destinées à être utilisées à court terme. Dans les versions ultérieures, les méthodes décrites dans cet article peuvent être dépréciées et remplacées par des API plus formelles et plus robustes. Pour obtenir des informations générales et de l’aide sur l’utilisation de Microsoft Copilot, consultez Documentation et ressources Microsoft Copilot, ou Vue d’ensemble de Copilot avec la protection des données commerciales.

Sous Windows 11 version 23H2, cette fonctionnalité est disponible en version 22631.3007 ou ultérieur. Sous Windows 11 version 22H2, cette fonctionnalité est disponible en version 22621.3007 ou ultérieur. Cette fonctionnalité nécessite Microsoft Edge version 120.0.2210.121 ou ultérieur.

Vérifier la disponibilité de Copilot dans Windows sur l’appareil

Pour déterminer si Copilot dans Windows est disponible sur un appareil Windows, vérifiez la valeur de la clé de Registre suivante. La valeur 0 signifie que Copilot dans Windows n’est pas disponible. La valeur 1 signifie que Copilot dans Windows est disponible.

Élément	Valeur
Chemin d’accès au Registre	HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\Copilot
Nom de la clé de registre	IsCopilotAvailable
Valeurs possibles	0 – Non disponible ou 1 – Disponible

Lancer Copilot dans Windows à l’aide du schéma d’URI de lancement Microsoft Edge

Une fois qu’il est déterminé que Copilot dans Windows est disponible sur l’appareil actuel, les applications peuvent invoquer la fonctionnalité à l’aide du schéma d’URI de lancement Microsoft Edge, microsoft-edge://?ux=copilot&lcp=1.

Ce schéma d’URI prend en charge les paramètres de chaîne de requête suivants liés à Copilot dans Windows

Paramètre	Valeur	Description	Obligatoire
UX	copilot	Lance Microsoft Edge dans le contexte Copilot dans Windows.	Oui
lcp	1	Lance Microsoft Edge dans le contexte Copilot dans Windows.	Oui
prompt	Chaîne de caractères	Chaîne facultative représentant l’invite qui sera transmise à Copilot dans Windows lors du lancement.	Non
formcode	Chaîne de caractères	Identificateur à 6 chiffres facultatif qui peut être transmis pour aider à identifier le trafic entrant.	Non
cpfilepath	Chaîne de caractères	Chaîne facultative contenant le chemin d’accès du fichier qui sera transmis à Copilot.	Non
cpfilemime	Chaîne de caractères	Chaîne facultative contenant le type MIME du fichier qui sera transmis à Copilot.	Non

Copilot dans Windows a les exigences de syntaxe suivantes :

• Pour ajouter le protocole, chaque paire clé-valeur doit être séparée par une esperluette (&).
• La chaîne d’invite doit être encodée par URI/URI-escaped.
• La partie chaîne d’invite de l’URI doit être inférieure ou égale à 2 000 caractères avant l’encodage d’URI.

Exemples

Voici un exemple d’URI permettant de lancer Copilot dans Windows.

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

Utilisez le paramètre de chaîne de requête d’invite pour spécifier une invite.

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

Spécifiez le paramètre formcode 123456.

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

Utilisez le cpfilepath et cpfilemime pour spécifier un fichier qui sera transmis à 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