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

Note

Dit artikel beschrijft functies die worden gebruikt in agenten of agentstromen die gebruikmaken van het standard harness.

Prerequisites

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

Je 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 verschijnt een pop-up melding die aangeeft dat de Copilot Studio-extensie je moet inloggen.

  2. Selecteer Inloggen in de pop-up en 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 authenticatie zie je een structuur onder het Agents-paneel binnen de Copilot Studio-extensie in Visual Studio Code. Je ziet een lijst met omgevingsgroepen, met onderliggende 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

De volgende stappen voor probleemoplossing pakken enkele problemen aan 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. Laad Visual Studio Code opnieuw.
  2. Selecteer extensies en zoek naar de extensie in de geïnstalleerde lijst. Zorg ervoor dat de verlenging 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 via 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

Probleem: Je kunt de Copilot Studio-extensie niet vinden tijdens het zoeken.

Oplossing:

  1. Zorg 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 bij de vermelding in de lijst het pictogram Beheren en selecteer vervolgens Verwijderen.

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

Note

Het verwijderen van de extensie verwijdert niet de lokaal gekloonde agentbestanden. Je moet deze bestanden handmatig verwijderen.

Volgende stappen 

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

  • Last updated on