Copilot in Windows

Questo articolo descrive come determinare se Copilot in Windows è disponibile nel dispositivo corrente e, se la funzionalità è disponibile, come avviare Copilot in Windows usando lo schema URI di avvio di Microsoft Edge. Le tecniche descritte in questo articolo sono destinate all'uso a breve termine. Nelle versioni future, i metodi descritti in questo articolo possono essere deprecati e sostituiti con API più formali e affidabili. Per informazioni generali e indicazioni sull'uso di Microsoft Copilot, vedere la documentazione e le risorse di Microsoft Copilot o Panoramica di Copilot con la protezione dei dati commerciali.

In Windows 11 versione 23H2 questa funzionalità è disponibile nella build 22631.3007 o successiva. In Windows 11 versione 22H2 la funzionalità è disponibile in Build 22621.3007 o successiva. Questa funzionalità richiede Microsoft Edge versione 120.0.2210.121 o successiva.

Controllare la disponibilità di Copilot in Windows nel dispositivo

Per determinare se Copilot in Windows è disponibile in un dispositivo Windows, controllare il valore della chiave del Registro di sistema seguente. Il valore 0 indica che Copilot in Windows non è disponibile. Il valore 1 indica che Copilot in Windows è disponibile.

Articolo	Valore
Percorso del Registro di sistema	HKEY_CURRENT_U edizione Standard R\Software\Microsoft\Windows\Shell\Copilot
Nome della chiave del Registro di sistema	IsCopilotAvailable
Possibili valori	0 – Non disponibile o 1 - Disponibile

Avviare Copilot in Windows usando lo schema URI di avvio di Microsoft Edge

Dopo aver stabilito che Copilot in Windows è disponibile nel dispositivo corrente, le applicazioni possono richiamare la funzionalità usando lo schema URI di avvio di Microsoft Edge, microsoft-edge://?ux=copilot&lcp=1.

Questo schema URI supporta i parametri di stringa di query seguenti correlati a Copilot in Windows

Parametro	valore	Descrizione	Richiesto
Ux	Copilota	Avvia Microsoft Edge in Copilot nel contesto di Windows.	Sì
Lcp	1	Avvia Microsoft Edge in Copilot nel contesto di Windows.	Sì
prompt	Una stringa	Stringa facoltativa che rappresenta il prompt che verrà passato a Copilot in Windows all'avvio.	No
formcode	Una stringa	Identificatore facoltativo a 6 cifre che può essere passato per identificare il traffico in ingresso.	No
cpfilepath	Una stringa	Stringa facoltativa contenente il percorso del file che verrà passato a Copilot.	No
cpfilemime	Una stringa	Stringa facoltativa contenente il tipo MIME del file che verrà passato a Copilot.	No

Copilot in Windows presenta i requisiti di sintassi seguenti:

• Per aggiungere al protocollo, ogni coppia chiave/valore deve essere separata da una e commerciale.
• La stringa del prompt deve essere con codifica URI/URI con escape.
• La parte della stringa di richiesta dell'URI deve essere minore o uguale a 2000 caratteri prima della codifica URI.

Esempi

Di seguito è riportato un esempio di URI per avviare Copilot in Windows.

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

Usare il parametro della stringa di query prompt per specificare un prompt.

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

Specificare il parametro formcode 123456.

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

Usare cpfilepath e cpfilemime per specificare un file che verrà passato a 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