Freigeben über

Klone deinen Microsoft Copilot Studio Agenten in Microsoft Visual Studio Code

Wenn Sie einen Agenten aus Microsoft Copilot Studio mit der Erweiterung klonen, laden Sie die Agentendefinition und die zugehörigen Komponentendefinitionen von Copilot Studio auf Ihren lokalen Rechner herunter. Sie können diese Dateien mit Microsoft Visual Studio Code bearbeiten. Die Klonoperation erstellt einen lokalen Arbeitsbereich mit allen Agentdateien in einem strukturierten Verzeichnisformat.

Voraussetzungen

Bevor Sie mit dem Klonen von Agenten beginnen, gibt es einige wichtige Voraussetzungen und Überlegungen.

Wählen Sie einen Arbeitsplatzstandort

Wählen Sie einen geeigneten lokalen Ordner für Ihre Agentendateien aus. An diesem Ort speichert die Erweiterung die Agent-Dateien. Hier sind einige wichtige Tipps zur Auswahl eines Standorts:

  • Sorgen Sie für ausreichenden Speicherplatz. Ein typisches Mittel kann je nach Anzahl der Komponenten in der Größe variieren.
  • Verwenden Sie möglichst einen Pfad ohne Leerzeichen, obwohl Zwischenräume unterstützt werden.
  • Überlege, einen Ort zu verwenden, der bereits von Git verfolgt wird.

Verstehen, was geklont wird

Wenn Sie einen Agenten klonen, werden die Agentendateien lokal an dem von Ihnen gewählten Ort geklont, wodurch eine Strukturdefinition wie folgt im Visual Studio Code Explorer erstellt wird:

my-agent/
├── actions                   # Connectors
│   ├── DevOpsAction.mcs.yml  
│   └── GetItems.mcs.yml      
├── knowledge/files                # Knowledge sources
│   ├── source1.yaml
│   └── source2.yaml
├── topics/                   # Conversation topics
│   ├── greeting.mcs.yaml
│   ├── help.mcs.yaml
│   └── escalate.mcs.yaml
├── workflows/                    # Agent tools and actions
│   └── GetDevOpsItems
│       ├── metadata.yaml
│       └── workflow.json
│   └── GetMeetings
│       ├── metadata.yaml
│       └── workflow.json
├── trigger/                 # Event triggers
│   └── welcometrigger.mcs.yaml
├── agent.mcs.yaml                # Main agent definition
├── icon.png                      # Icon used for the agent, visible in test panel and in supported channels
├── settings.mcs.yml              # Configuration settings for the agent
└── connectioreferences.mcs.yml   # Connection References used by Connectors and other actions

Klonierungsmethoden

Wenn du die Erweiterung zum ersten Mal benutzt oder sogar neu bei Visual Studio Code bist, ist der einfachste Weg, einen Agenten zu klonen, Clone Agent auszuwählen, wenn der Erweiterungsbereich geöffnet ist. Diese Option ist jedoch nicht verfügbar, wenn du bereits einen Agenten geklont und lokal geöffnet hast. Stattdessen können folgende Methoden verwendet werden:

Dies ist die unkomplizierteste und empfohlene Methode, einen Agenten zu klonen.

  1. Öffnen Sie die Copilot Studio-Erweiterung, indem Sie das Copilot Studio-Symbol in der Aktivitätsleiste auswählen. Sie können auch "Copilot Studio: Focus on Agents View" drücken Ctrl+Shift+P und eingeben. Der Copilot Studio-Bereich öffnet sich in der Seitenleiste.

  2. Im Agenten-Bereich wählen Sie Ihre Zielumgebung aus der Dropdown-Liste (zum Beispiel "Umgebung 1"), um eine Liste der Agenten in der Umgebung zu sehen.

    > Environment 1
  Environment 2
  Environment 3

  3. Wähle den Agenten aus der Liste aus. Die Agenten zeigen ihr zuletzt geändertes Datum an. Rechtsklick auf den Agentennamen und wähle Klonagent aus.

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    Ein Dateiauswähler-Dialog öffnet sich.

  4. Navigiere im Dateiauswahl-Dialog zu deinem gewünschten Ort oder erstelle einen neuen Ordner und wähle Ordner auswählen. Der Klonprozess beginnt.

  5. Warte, bis der Klonvorgang abgeschlossen ist. Eine Fortschrittsbenachrichtigung erscheint mit der Anzeige "Klonagent: Kundensupport-Bot", gefolgt von einer Erfolgsmeldung "Agent erfolgreich geklont." Dieser Vorgang dauert normalerweise 10–30 Sekunden.

  6. Überprüfen Sie, ob das Klonen erfolgreich abgeschlossen wurde. Der Agent-Ordner öffnet sich im Visual Studio Code Explorer, der Quellcode-Kontrollbereich zeigt einen sauberen Arbeitsbaum an, und das Dateifenster zeigt den Namen deines Ordners an.

Methode 3: Klonen mit der Befehlspalette

Nutzen Sie diese Methode, wenn Sie tastaturfokussierte Arbeitsabläufe bevorzugen.

  1. Öffne die Befehlspalette, indem du drückst Ctrl+Shift+P.

  2. Gib "Copilot Studio: Clone Agent" ein und drücke Enter. Der Befehl wird ausgeführt und Prompts erscheinen.

  3. Folgen Sie den Aufforderungen, um Ihre Umgebung auszuwählen, wählen Sie den Agenten, wählen Sie den Zielordner und warten Sie, bis das Klonen abgeschlossen ist. Der Agent wird an den von dir gewählten Standort geklont.

Methode 3: Klonen mit Agenten-URL

Diese Methode ist nützlich, wenn jemand eine Agenten-URL mit dir teilt.

  1. Öffnen Sie Ihren Agenten im Webportal von Copilot Studio.

  2. Wählen Sie Einstellungen>Agentendetails aus und kopieren Sie die URL des Agenten. Die URL sollte das Format haben: https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. Die URL befindet sich jetzt in deiner Zwischenablage.

  3. Gehen Sie zum Visual Studio Code zurück und öffnen Sie die Copilot Studio-Erweiterung.

  4. Wählen Sie Klonagenten. Die Erweiterung erkennt die URL in deiner Zwischenablage und zeigt den Agenten an, der als "(aus der Zwischenablage)" markiert ist.

  5. Wählen Sie den Agenten mit der Markierung "(aus der Zwischenablage)" aus, wählen Sie einen Zielordner und warten Sie, bis das Klonen abgeschlossen ist. Der Agent wird an den von dir gewählten Standort geklont.

Häufige Klonszenarien

Hier sind einige gängige Szenarien, in denen das Klonen von Agenten nützlich ist, mit übergeordneten Details zum vorgeschlagenen Workflow.

Szenario 1: Klon für Solo-Entwicklung

Ziel: Arbeiten Sie selbst an einem Agenten

  1. Klone den Agenten in einen lokalen Ordner.

  2. Initialisiere ein Git-Repository aus der Quellcode-Kontrolle in der Navigation.

  3. Nehmen Sie änderungen lokal vor.

  4. Mach deine Verpflichtungen.

  5. Wenden Sie die Änderungen auf Copilot Studio an, wenn Sie bereit sind.

Szenario 2: Klon für Teamzusammenarbeit

Ziel: Mehrere Entwickler arbeiten am selben Agenten

  1. Der erste Entwickler klont den Agenten.

  2. Der erste Entwickler initialisiert Git und pusht die Inhalte in ein gemeinsames Repository (GitHub, Azure DevOps).

  3. Andere Entwickler klonen aus dem gemeinsamen Git-Repository.

  4. Jeder Entwickler benutzt Copilot Studio: Reattach Agent, um seinen lokalen Ordner mit Copilot Studio zu verbinden.

  5. Das Team nutzt Git zur Zusammenarbeit und zur Nachverfolgung von Änderungen und nutzt die Visual Studio Code-Erweiterung, um am Agenten zu arbeiten.

  6. Jeder Entwickler wendet dann Änderungen in Copilot Studio zum Testen an oder pusht sie basierend auf ihrem Softwareentwicklungszyklus oder automatisierten Pipelines in eine andere Downstream-Umgebung.

Szenario 3: Mehrere Umgebungen klonen

Ziel: Verwaltung von Entwicklungs-, Test- und Produktionsversionen

Der empfohlene Ansatz für die Bereitstellung in mehreren Umgebungen ist die Verwendung von Lösungen. Betrachten Sie einen automatisierten Bereitstellungsprozess mit organisatorischen Prozessen, die auditierbar und skalierbar sind, wie z. B. Pipelines. Für Nutzer, die sich entscheiden, nicht mit Lösungen zu arbeiten, bietet die Copilot Studio-Erweiterung die Möglichkeit, eine Copilot-Studio-Agentendefinition von einer lokalen Maschine in eine andere Umgebung zu synchronisieren. Sie sollten dennoch den organisatorischen Prozess berücksichtigen, um technische Assets in nachgelagerte Umgebungen zu verlagern, um Audits, Telemetrie und andere wichtige Komponenten im Softwareentwicklungszyklus bereitzustellen, wenn Sie Software für Ihre Kunden und Endanwender ausliefern.

  1. Klone den Agenten aus der Entwicklungsumgebung in einen lokalen Entwicklungsordner.

  2. Mach Änderungen im Entwicklungsordner.

  3. Wenden Sie diese Änderungen an und testen Sie sie in derselben Umgebung.

  4. Verwenden Sie Copilot Studio: Verbinden Sie den Agenten wieder, um den Agenten mit der alternativen Umgebung zu verbinden.

  5. Teste den Agenten im Testfenster von Copilot Studio.

Bewährte Methoden

Empfehlung

  • Klone alle Agenten an einen festen Ort.
  • Initialisiere Git direkt nach dem Klonen.
  • Verwenden Sie einen aussagekräftigen Ordnernamen.
  • Überprüfe, ob der Klon funktioniert, bevor du Änderungen vornimmst.
  • Sichern Sie Ihren Klonstandort (zum Beispiel in GitHub oder Azure DevOps).
  • Dokumentiere deinen Klonstandort in deinem internen Team-Wiki oder in den Dokumenten.

Tue nicht

  • Klon nicht in temporäre Verzeichnisse.
  • Klone nicht mehrfach an verschiedene Orte. Das kann zu Verwirrung führen.

Nächste Schritte

Nachdem du deinen Agenten geklont hast:

  • Last updated on