Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Voraussetzungen
Stellen Sie vor der Installation der Microsoft Copilot Studio-Erweiterung für Microsoft Visual Studio Code sicher, dass Sie die folgenden Anforderungen erfüllen:
Systemanforderungen
-
Betriebssystem:
- Windows (x64-Architektur)
- Windows 10 Version 1809 oder höher
- Windows 11 (beliebige Version)
- macOS
- Windows (x64-Architektur)
- Visual Studio Code: Version 1.80 oder höher (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 license: Dem Konto zugewiesene entsprechende Lizenz
- Environment access: Berechtigungen für den Zugriff auf mindestens eine Copilot Studio-Umgebung
- Agentenberechtigungen: Lese- und Schreibzugriff auf alle Agenten, die Sie bearbeiten möchten.
Installationsschritte
Es gibt zwei Möglichkeiten zum Installieren der Copilot Studio-Erweiterung in Visual Studio Code:
- Von Visual Studio Code aus installieren
- Installieren von der Visual Studio Code Marketplace-Website
Methode 1: Installieren von Visual Studio Code
Wählen Sie das Erweiterungssymbol in der Aktivitätsleiste aus oder drücken Sie
Ctrl+Shift+X. Der Bereich Extensions wird in Visual Studio Code geöffnet.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.
Sobald du die richtige Erweiterung gefunden hast, wähle sie aus, um die Seite mit den Details der Erweiterung zu öffnen.
Wählen Sie Installieren, um mit der Installation zu beginnen.
Warten Sie, bis die Installation abgeschlossen ist. Möglicherweise wird eine Aufforderung zum Erneutladen Visual Studio Code angezeigt, in diesem Fall wählen Sie Reload aus, wenn Sie dazu aufgefordert werden.
Überprüfe die Installation. Suchen Sie in der Aktivitätsleiste nach dem symbol Copilot Studio. Das Symbol wird mit Copilot Studio-Branding angezeigt.
Methode 2: Installieren von der Visual Studio Code Marketplace-Website
Wechseln Sie zu
https://marketplace.visualstudio.com/, und suchen Sie nach "Copilot Studio". Sie können auch den direkten Link verwenden:https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio.Wählen Sie auf der Marktplatzseite Installieren . Möglicherweise werden Sie von Ihrem Browser aufgefordert, Visual Studio Code herunterzuladen, bevor Sie aufgefordert werden, Visual Studio Code zu öffnen.
Erlauben Sie dem Browser, Visual Studio Code zu öffnen und die Installation zu bestätigen, indem Sie auf der Aktivitätsleiste nach dem Erweiterungssymbol suchen.
Erstkonfiguration
Erster Start
Wählen Sie in der Aktivitätsleiste das Symbol Copilot Studio aus. Die Erweiterung öffnet sich als Anwendungsfenster. Es wird eine Pop-up-Benachrichtigung angezeigt, die darauf hinweist, dass Sie sich bei der Copilot Studio-Erweiterung anmelden müssen.
Wähle im Popup "Anmelden " und dann "Erlauben". Ihr Standardbrowser öffnet eine Microsoft-Authentifizierungsseite.
Geben Sie Ihre Authentifizierungsdaten ein und führen Sie gegebenenfalls die Multi-Faktor-Authentifizierung durch.
Überprüfen Sie die angeforderten Berechtigungen:
- Lesen und Schreiben von Copilot Studio-Agents
- Zugreifen Sie auf Umweltinformationen
- Dateien an die Cloud synchronisieren
Wählen Sie zwischen Annehmen oder Erlauben. Der Browser fordert Sie auf, das Fenster zu schließen und zu Visual Studio Code zurückzukehren.
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 sollte eine Struktur im Bereich Agents innerhalb der Copilot Studio-Erweiterung in Visual Studio Code angezeigt werden. 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
Fehlerbehebung der Installation
Im Folgenden finden Sie Schritte zur Problembehandlung für einige Probleme, die beim Installieren oder Konfigurieren der Copilot Studio-Visual Studio Code-Erweiterung auftreten können.
Erweiterung erscheint nicht
Problem: Das Symbol Copilot Studio wird nicht in der Aktivitätsleiste angezeigt.
Solution:
- Visual Studio Code neu laden
- 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.
- Aktualisieren Sie Visual Studio Code auf die neueste Version.
- Installieren Sie die Erweiterung erneut.
Authentifizierungsfehler
Problem: Die Authentifizierung schlägt fehl oder läuft wiederholt in Schleifen.
Solution:
Löschen Sie Ihren Browser-Cache und Ihre Cookies für
microsoft.com.Versuche, dich in einem anderen Browser anzumelden. Setzen Sie diesen Browser vorübergehend als Standard.
Deaktiviere Browser-Erweiterungen, die die Authentifizierung blockieren könnten.
Überprüfe die Firmen-Firewall und die Proxy-Einstellungen.
Stelle sicher, dass du einen unterstützten Kontotyp verwendest.
Die Erweiterung wurde auf Visual Studio Code Marketplace nicht gefunden
Problem: Die Copilot Studio-Erweiterung kann beim Suchen nicht gefunden werden.
Solution:
Stelle sicher, dass du im Erweiterungsbereich suchst und nicht in der Websuche .
Überprüfen Sie die Rechtschreibung: "Copilot Studio".
Wenden Sie sich an Ihren Administrator, um festzustellen, ob Ihre Organisation Visual Studio Code Marketplace-Zugriff einschränkt.
Deinstallieren der Erweiterung
Um die Verlängerung zu entfernen:
Öffnen Sie den Erweiterungsbereich.
Suchen Sie Copilot Studio in den installierten Erweiterungen.
Wählen Sie im Eintrag in der Liste dasVerwalten (Zahnrad-Symbol) >Deinstallieren.
Laden Sie Visual Studio Code erneut, wenn Sie dazu aufgefordert werden.
Hinweis
Das Deinstallieren der Erweiterung löscht keine lokal geklonten Agentendateien. Du musst diese Dateien manuell entfernen.
Nächste Schritte
Nachdem Sie die Erweiterung installiert und mit Copilot Studio authentifiziert haben, können Sie folgende Aufgaben ausführen: