Installare l'estensione Microsoft Copilot Studio per Microsoft Visual Studio Code

Prerequisiti

Prima di installare l'estensione Microsoft Copilot Studio per Microsoft Visual Studio Code, assicurarsi di soddisfare i requisiti seguenti:

Requisiti di sistema

• Sistema operativo:
  • Windows (architettura x64)
    • Windows 10 versione 1809 o successiva
    • Windows 11 (qualsiasi versione)
  • macOS
• Visual Studio Code: versione 1.80 o successiva (versione stabile più recente consigliata)
• Connessione Internet: Richiesto per installazione e autenticazione

Requisiti dell'account

• Account Microsoft Microsoft: Account Microsoft attivo con licenza o accesso a Copilot Studio
• Copilot Studio license: Licenza appropriata assegnata all'account
• A access: Autorizzazioni per accedere ad almeno un ambiente Copilot Studio
• Permessi agenti: Accesso in lettura e scrittura a qualsiasi agente che intendi modificare

Passaggi di installazione

Esistono due modi per installare l'estensione Copilot Studio in Visual Studio Code:

• Eseguire l'installazione da Visual Studio Code
• Eseguire l'installazione dal sito Web Visual Studio Code Marketplace

Metodo 1: Eseguire l'installazione da Visual Studio Code

1. Seleziona l'icona Estensioni nella barra attività o premi Ctrl+Shift+X. Il riquadro Extensions viene aperto in Visual Studio Code.

2. Nella barra di ricerca immettere "Copilot Studio". Cercare l'estensione ufficiale Copilot Studio nell'elenco risultati. Verifica che l'editore sia "Microsoft."

3. Una volta trovata l'estensione corretta, selezionala per aprire la pagina dettagli dell'estensione.

4. Seleziona Installa per iniziare l'installazione.

5. Attendere il completamento dell'installazione. Potrebbe essere visualizzato un prompt per ricaricare Visual Studio Code, in questo caso selezionare Reload quando richiesto.

6. Verifica l'installazione. Cercare l'icona di Copilot Studio nella barra delle attività. L'icona viene visualizzata con la personalizzazione di Copilot Studio.

Metodo 2: Installare dal sito Web Visual Studio Code marketplace

1. Passare a https://marketplace.visualstudio.com/ e cercare "Copilot Studio". È anche possibile usare il collegamento diretto: https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio.

2. Seleziona Installa nella pagina del marketplace. I prompt del browser potrebbero richiedere di scaricare Visual Studio Code prima di chiedere di aprire Visual Studio Code.

3. Consentire al browser di aprire Visual Studio Code e confermare l'installazione cercando l'icona dell'estensione nella barra delle attività.

Configurazione iniziale

Primo lancio

1. Selezionare l'icona Copilot Studio nella barra delle attività. L'estensione si apre come pannello applicativo. Viene visualizzata una notifica popup che indica che l'estensione Copilot Studio deve essere eseguita l'accesso.

2. Seleziona Accedi nel popup, poi seleziona Consenti. Il browser predefinito si apre su una pagina di autenticazione Microsoft.

3. Inserisci le tue credenziali di autenticazione e completa eventuali autenticazioni multifattore se necessario.

4. Esamina i permessi richiesti:

   • Leggere e scrivere agenti di Copilot Studio
   • Accedi alle informazioni sull'ambiente
   • Sincronizza i file con il cloud

   Seleziona Accetta o Consenti. Il browser richiede di chiudere la finestra e tornare a Visual Studio Code.

5. Tornare a Visual Studio Code. Il pannello di estensione carica gli ambienti a cui hai accesso e gli agenti in quegli ambienti.

Verifica l'installazione riuscita

Dopo l'autenticazione, verrà visualizzata una struttura nel riquadro Agents all'interno dell'estensione Copilot Studio in Visual Studio Code. Dovresti vedere un elenco di gruppi di ambiente, con ambienti annidati e agenti, simile alla seguente struttura:

AGENTS
  └─ Environment Group (for example, developer, default, sandbox, production)
      ├─ Example Environment 1
      │   ├─ Agent 1
      │   └─ Agent 2
      └─ Example Environment 2
          └─ Agent 3

Risolvere i problemi di installazione

Di seguito sono riportati i passaggi per la risoluzione dei problemi che possono verificarsi durante l'installazione o la configurazione dell'estensione Visual Studio Code di Copilot Studio.

L'estensione non appare

Problem: L'icona di Copilot Studio non viene visualizzata nella barra delle attività.

Soluzione:

1. Ricaricare Visual Studio Code
2. Seleziona Estensioni e cerca l'estensione nell'elenco Installato. Assicurati che l'estensione non sia disattivata.
3. Aggiornare Visual Studio Code alla versione più recente.
4. Reinstalla l'estensione.

Errori di autenticazione

Problema: L'autenticazione fallisce o si ripete ripetutamente.

Soluzione:

1. Svuota la cache del browser e i cookie per microsoft.com.

2. Prova ad accedere usando un browser diverso. Imposta temporaneamente questo browser come predefinito.

3. Disabilita le estensioni del browser che potrebbero bloccare l'autenticazione.

4. Controlla le impostazioni del firewall aziendale e del proxy.

5. Assicurati di utilizzare un tipo di account supportato.

Estensione non trovata in Visual Studio Code Marketplace

Problem: Impossibile trovare l'estensione Copilot Studio durante la ricerca.

Soluzione:

1. Assicurati di cercare nel pannello delle Estensioni , non nella ricerca web.

2. Controllare l'ortografia: "Copilot Studio".

3. Contattare l'amministratore per verificare se l'organizzazione limita Visual Studio Code'accesso al Marketplace.

Disinstallare l'estensione

Per rimuovere l'estensione:

1. Apri il pannello Estensioni.

2. Trovare Copilot Studio nelle estensioni installate.

3. Nella voce della lista, selezionala Gestione (icona dell'ingranaggio) >Disinstalla.

4. Ricaricare Visual Studio Code quando richiesto.

Annotazioni

Disinstallare l'estensione non cancella i file agente clonati localmente. Devi rimuovere questi file manualmente.

Passaggi successivi

Dopo aver installato l'estensione e aver eseguito l'autenticazione con Copilot Studio, è possibile:

• Clona il tuo primo agente
• Scopri i componenti dell'agente di editing