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

Note

Questo articolo descrive le caratteristiche utilizzate negli agenti o nei flussi di agenti alimentati dall'imbracatura standard.

Prerequisites

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
  • Accesso all'ambiente: Autorizzazioni per accedere ad almeno un ambiente Copilot Studio
  • Permessi agenti: Accesso in lettura e scrittura a qualsiasi agente che intendi modificare

Procedure di installazione

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

  • 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 il marchio 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. Appare una notifica pop-up che indica che l'estensione di Copilot Studio richiede il tuo login.

  2. Seleziona Accedi nel pop-up, 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:

    • Leggi e scrivi 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, si vede una struttura nel pannello Agents all'interno dell'estensione Copilot Studio in Visual Studio Code. Vedi una lista 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

I seguenti passaggi di risoluzione dei problemi risolvono alcuni problemi che potrebbero verificarsi durante l'installazione o la configurazione dell'estensione Copilot Studio Visual Studio Code.

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 disabilitata.
  3. Aggiornare Visual Studio Code alla versione più recente.
  4. Installa di nuovo 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

Problema: Non riesci a trovare l'estensione Copilot Studio quando cerchi.

Soluzione:

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

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

  3. Contatta il tuo amministratore per vedere se la tua organizzazione limita l'accesso al marketplace di Visual Studio Code.

Disinstallare l'estensione

Per rimuovere l'estensione:

  1. Apri il pannello Estensioni.

  2. Trovare Copilot Studio nelle estensioni installate.

  3. Nella voce della lista, seleziona l'icona Gestisci , poi seleziona Disinstalla.

  4. Ricaricare Visual Studio Code quando richiesto.

Note

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:

  • Last updated on