De Microsoft Copilot Studio-extensie voor Microsoft Visual Studio Code installeren

Vereiste voorwaarden

Voordat u de Microsoft Copilot Studio-extensie voor Microsoft Visual Studio Code installeert, moet u aan de volgende vereisten voldoen:

Systeemvereisten

• Besturingssysteem:
  • Windows (x64-architectuur)
    • Windows 10 versie 1809 of hoger
    • Windows 11 (elke versie)
  • macOS
• Visual Studio Code: versie 1.80 of hoger (meest recente stabiele versie aanbevolen)
• Internetverbinding: Vereist voor installatie en authenticatie

Rekeningvereisten

• Microsoft-account: Active Microsoft-account met Copilot Studio-licentie of -toegang
• Copilot Studio-licentie: De juiste licentie toegewezen aan uw account
• Toegang tot omgeving: machtigingen voor toegang tot ten minste één Copilot Studio-omgeving
• Agentenrechten: Lees en schrijf toegang tot alle agenten die je wilt bewerken

Installatiestappen

U kunt de Copilot Studio-extensie op twee manieren installeren in Visual Studio Code:

• Installeren vanuit Visual Studio Code
• Installeren vanaf de Visual Studio Code Marketplace-website

Methode 1: Installeren vanuit Visual Studio Code

1. Selecteer het Extensie-icoon in de activiteitenbalk of druk Ctrl+Shift+Xop . Het deelvenster Extensions wordt geopend in Visual Studio Code.

2. Voer in de zoekbalk 'Copilot Studio' in. Zoek de officiële Copilot Studio-extensie in de lijst met resultaten. Controleer of de uitgever "Microsoft" is.

3. Zodra je de juiste extensie hebt gevonden, selecteer je deze om de pagina met extensiedetails te openen.

4. Selecteer Installeren om de installatie te starten.

5. Wacht tot de installatie is voltooid. Mogelijk ziet u een prompt om Visual Studio Code opnieuw te laden. In dat geval selecteert u Reload wanneer hierom wordt gevraagd.

6. Controleer de installatie. Zoek het Copilot Studio-pictogram op de activiteitenbalk. Het pictogram wordt weergegeven met Copilot Studio-huisstijl.

Methode 2: Installeren vanaf de Visual Studio Code Marketplace-website

1. Ga naar https://marketplace.visualstudio.com/ en zoek naar 'Copilot Studio'. U kunt ook de directe koppeling gebruiken: https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio.

2. Selecteer Installeren op de marktplaatspagina. Uw browserprompts vragen u mogelijk om Visual Studio Code te downloaden voordat u wordt gevraagd om Visual Studio Code te openen.

3. Hiermee staat u toe dat de browser Visual Studio Code opent en de installatie bevestigt door te zoeken naar het extensiepictogram op de activiteitenbalk.

Initiële configuratie

Eerste lancering

1. Selecteer het pictogram Copilot Studio in de activiteitenbalk. De extensie opent als een applicatievenster. Er wordt een pop-upmelding weergegeven, waarmee wordt aangegeven dat u zich moet aanmelden bij de Copilot Studio-extensie.

2. Selecteer Inloggen op de pop-up, selecteer vervolgens Toestaan. Je standaardbrowser opent een Microsoft-authenticatiepagina.

3. Voer je authenticatiegegevens in en voer indien nodig een multifactorauthenticatie uit.

4. Bekijk de gevraagde toestemmingen:

   • Copilot Studio-agents lezen en schrijven
   • Toegang tot omgevingsinformatie
   • Synchroniseer bestanden naar de cloud

   Selecteer Accepteren of Toestaan. In de browser wordt u gevraagd het venster te sluiten en terug te keren naar Visual Studio Code.

5. Ga terug naar Visual Studio Code. Het extensiepaneel laadt de omgevingen waar je toegang toe hebt, en de agenten in die omgevingen.

Verifieer een succesvolle installatie

Na verificatie ziet u een structuur onder het deelvenster Agents in de extensie Copilot Studio in Visual Studio Code. Je zou een lijst van omgevingsgroepen moeten zien, met geneste omgevingen en agenten, vergelijkbaar met de volgende structuur:

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

Problemen met de installatie oplossen

Hieronder vindt u stappen voor het oplossen van problemen die kunnen optreden bij het installeren of configureren van de Copilot Studio Visual Studio Code-extensie.

Uitbreiding verschijnt niet

Problem: Het pictogram Copilot Studio wordt niet weergegeven op de activiteitenbalk.

Oplossing:

1. Visual Studio Code opnieuw laden
2. Selecteer extensies en zoek naar de extensie in de geïnstalleerde lijst. Zorg ervoor dat de extensie niet is uitgeschakeld.
3. Werk Visual Studio Code bij naar de nieuwste versie.
4. Installeer de extensie opnieuw.

Authenticatiefouten

Probleem: Authenticatie faalt of loopt herhaaldelijk af.

Oplossing:

1. Wis je browsercache en cookies voor microsoft.com.

2. Probeer in te loggen met een andere browser. Stel deze browser tijdelijk als standaard in.

3. Schakel browserextensies uit die authenticatie mogelijk blokkeren.

4. Controleer de instellingen van de bedrijfsfirewall en proxy.

5. Zorg ervoor dat je een ondersteund accounttype gebruikt.

Extensie is niet gevonden in Visual Studio Code Marketplace

Problem: Kan de Copilot Studio-extensie niet vinden tijdens het zoeken.

Oplossing:

1. Zorg ervoor dat je zoekt in het Extensie-paneel , niet in de webzoekopdracht.

2. Controleer de spelling: 'Copilot Studio'.

3. Neem contact op met uw beheerder om te zien of uw organisatie Visual Studio Code marketplace-toegang beperkt.

De extensie verwijderen

Om de verlenging te verwijderen:

1. Open het Extensie-paneel.

2. Zoek Copilot Studio in de geïnstalleerde extensies.

3. Selecteer in de lijst de optie Beheren (tandwielicoon) en daarna >.

4. Laad Visual Studio Code opnieuw wanneer hierom wordt gevraagd.

Volgende stappen

Nadat u de extensie hebt geïnstalleerd en geverifieerd met Copilot Studio, kunt u het volgende doen:

• Kloon je eerste agent
• Leer over componenten van de bewerkingsagenten