Freigeben über


Installieren Sie die Microsoft Copilot Studio-Erweiterung für Microsoft Visual Studio Code

Voraussetzungen

Bevor Sie die Microsoft Copilot Studio-Erweiterung für Microsoft Visual Studio Code installieren, stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen:

Systemanforderungen

  • Betriebssystem:
    • Windows (x64-Architektur)
      • Windows 10 Version 1809 oder höher
      • Windows 11 (beliebige Versionen)
    • macOS
  • Visual Studio Code: Version 1.80 oder neuer (neueste stabile Version empfohlen)
  • Internetverbindung: Erforderlich für Installation und Authentifizierung

Kontoanforderungen

  • Microsoft-Konto: Aktives Microsoft-Konto mit Copilot-Studio-Lizenz oder Zugriff
  • Copilot Studio-Lizenz: Passende Lizenz deinem Konto zugewiesen
  • Zugang zur Umgebung: Berechtigungen zum Zugriff auf mindestens eine Copilot Studio-Umgebung
  • Agentenberechtigungen: Lesen und schreiben Sie Zugang zu allen Agenten, die Sie bearbeiten möchten,

Installationsschritte

Es gibt zwei Möglichkeiten, die Copilot Studio-Erweiterung in Visual Studio Code zu installieren:

  • Installieren aus Visual Studio Code
  • Installation über die Visual Studio Code Marketplace-Website

Methode 1: Installation aus Visual Studio Code

  1. Wählen Sie das Erweiterungssymbol in der Aktivitätsleiste aus oder drücken Ctrl+Shift+XSie . Der Erweiterungsbereich öffnet sich in Visual Studio Code.

  2. Geben Sie in der Suchleiste "Copilot Studio" ein. Suchen Sie in der Ergebnisliste nach der offiziellen Copilot Studio-Erweiterung. Überprüfen Sie, dass der Publisher "Microsoft" ist.

  3. Sobald du die richtige Erweiterung gefunden hast, wähle sie aus, um die Seite mit den Details der Erweiterung zu öffnen.

  4. Wählen Sie Installieren , um mit der Installation zu beginnen.

  5. Warten Sie, bis die Installation abgeschlossen ist. Du könntest eine Aufforderung sehen, Visual Studio Code neu zu laden, in diesem Fall wählst du Reload, wenn du dazu aufgefordert wirst.

  6. Überprüfe die Installation. Suchen Sie nach dem Copilot Studio-Symbol in der Aktivitätsleiste. Das Symbol erscheint mit der Marke Copilot Studio.

Methode 2: Installieren von der Visual Studio Code Marktplatz-Website

  1. Gehen Sie zu https://marketplace.visualstudio.com/ und suchen Sie nach "Copilot Studio". Du kannst auch den direkten Link nutzen: https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio.

  2. Wählen Sie auf der Marktplatzseite Installieren . Ihre Browser-Prompts könnten Sie auffordern, Visual Studio Code herunterzuladen, bevor Sie gebeten werden, Visual Studio Code zu öffnen.

  3. Erlauben Sie dem Browser, Visual Studio Code zu öffnen, und bestätigen Sie die Installation, indem Sie nach dem Erweiterungssymbol in der Aktivitätsleiste suchen.

Erstkonfiguration

Erster Start

  1. Wählen Sie das Copilot Studio-Symbol in der Aktivitätsleiste. Die Erweiterung öffnet sich als Anwendungsfenster. Eine Pop-up-Benachrichtigung wird angezeigt, die anzeigt, dass Sie sich in der Copilot Studio-Erweiterung anmelden.

  2. Wähle im Popup "Anmelden " und dann "Erlauben". Ihr Standardbrowser öffnet eine Microsoft-Authentifizierungsseite.

  3. Geben Sie Ihre Authentifizierungsdaten ein und führen Sie gegebenenfalls die Multi-Faktor-Authentifizierung durch.

  4. Überprüfen Sie die angeforderten Berechtigungen:

    • Lesen und schreiben Copilot Studio-Agenten
    • Zugreifen Sie auf Umweltinformationen
    • Dateien an die Cloud synchronisieren

    Wählen Sie Annehmen oder Erlauben. Der Browser fordert Sie auf, das Fenster zu schließen und zu Visual Studio Code zurückzukehren.

  5. Kehren Sie zu Visual Studio Code zurück. Der Erweiterungsbereich lädt die Umgebungen, auf die du Zugriff hast, sowie die Agenten in diesen Umgebungen.

Erfolgreiche Einrichtung überprüfen

Nach der Authentifizierung sollten Sie unter dem Agenten-Fenster innerhalb der Copilot Studio-Erweiterung in Visual Studio Code eine Struktur sehen. Sie sollten eine Liste von Umgebungsgruppen mit verschachtelten Umgebungen und Agenten sehen, ähnlich der folgenden Struktur:

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

Problembehandlung bei der Installation

Im Folgenden finden Sie Schritte zur Fehlerbehebung für einige Probleme, die bei der Installation oder Konfiguration der Copilot Studio Visual Studio Code-Erweiterung auftreten können.

Erweiterung erscheint nicht

Problem: Das Copilot Studio-Symbol erscheint nicht in der Aktivitätsleiste.

Solution:

  1. Laden Sie Visual Studio Code neu
  2. Wählen Sie Erweiterungen aus und suchen Sie in der Liste der installierten Erweiterungen nach der Erweiterung. Stellen Sie sicher, dass die Erweiterung nicht deaktiviert ist.
  3. Update Visual Studio Code auf die neueste Version.
  4. Installieren Sie die Erweiterung erneut.

Authentifizierungsfehler

Problem: Die Authentifizierung schlägt fehl oder läuft wiederholt in Schleifen.

Solution:

  1. Löschen Sie Ihren Browser-Cache und Ihre Cookies für microsoft.com.

  2. Versuche, dich in einem anderen Browser anzumelden. Setzen Sie diesen Browser vorübergehend als Standard.

  3. Deaktiviere Browser-Erweiterungen, die die Authentifizierung blockieren könnten.

  4. Überprüfe die Firmen-Firewall und die Proxy-Einstellungen.

  5. Stelle sicher, dass du einen unterstützten Kontotyp verwendest.

Erweiterung nicht im Visual Studio Code Marktplatz gefunden

Problem: Ich finde die Copilot Studio-Erweiterung bei der Suche nicht.

Solution:

  1. Stelle sicher, dass du im Erweiterungsbereich suchst und nicht in der Websuche .

  2. Überprüfen Sie die Rechtschreibung: "Copilot Studio."

  3. Kontaktieren Sie Ihren Administrator, um zu erfahren, ob Ihre Organisation den Zugriff auf den Visual Studio Code Marktplatz einschränkt.

Deinstallieren der Erweiterung

Um die Verlängerung zu entfernen:

  1. Öffnen Sie den Erweiterungsbereich.

  2. Finde Copilot Studio in den installierten Erweiterungen.

  3. Wählen Sie im Eintrag in der Liste dasVerwalten (Zahnrad-Symbol) >Deinstallieren.

  4. Lade Visual Studio Code bei Aufforderung neu.

Hinweis

Das Deinstallieren der Erweiterung löscht keine lokal geklonten Agentendateien. Du musst diese Dateien manuell entfernen.

Nächste Schritte

Nach der Installation der Erweiterung und der Authentifizierung bei Copilot Studio sind Sie bereit zu: