Klonen Ihres Microsoft Copilot Studio Agents in Microsoft Visual Studio Code

Wenn Sie einen Agent von Microsoft Copilot Studio mithilfe der Erweiterung klonen, laden Sie die Agentdefinition und zugehörige Komponentendefinitionen von Copilot Studio auf Ihren lokalen Computer herunter. Sie können diese Dateien mithilfe von 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 typischer Agent kann je nach Anzahl der Komponenten in seiner Größe variieren.
  • Verwenden Sie möglichst einen Pfad ohne Leerzeichen, obwohl Leerzeichen unterstützt werden.
  • Überlege, einen Ort zu verwenden, der bereits von Git verfolgt wird.

Verstehen, was geklont wird

Wenn Sie einen Agent klonen, werden die Agent-Dateien lokal am von Ihnen ausgewählten Speicherort geklont und erstellen eine Strukturdefinition wie im Visual Studio Code Explorer:

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 Sie die Erweiterung zum ersten Mal verwenden oder noch neu bei Visual Studio Code sind, besteht die einfachste Möglichkeit zum Klonen eines Agents darin, Clone Agent auszuwählen, wenn der Bereich Extension 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 in der Aktivitätsleiste das Symbol Copilot Studio auswählen. Sie können auch Ctrl+Shift+P drücken und "Copilot Studio: Fokussierung auf Agentenansicht" eingeben. Der Copilot Studio-Bereich wird in der Seitenleiste geöffnet.

  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 Agentordner wird im Visual Studio Code Explorer geöffnet, im Quellcodeverwaltungsbereich wird eine klare Arbeitsstruktur angezeigt, und im Dateifenster wird der Name Des Ordners angezeigt.

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. Geben Sie "Copilot Studio: Clone Agent" ein, und drücken Sie 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 Agent im Copilot Studio-Webportal.

  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. Kehren Sie zu Visual Studio Code zurück, und öffnen Sie die Copilot Studio-Erweiterung.

  4. Wählen Sie Klonagent. 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 eigenständig an einem Agenten

  1. Klone den Agenten in einen lokalen Ordner.

  2. Initialisiere ein Git-Repository aus der Versionskontrolle in der Navigationsleiste.

  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 verschiebt den Inhalt an ein freigegebenes Repository (GitHub, Azure DevOps).

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

  4. Jeder Entwickler führt Copilot Studio: Reattach Agent aus, um seinen lokalen Ordner mit Copilot Studio zu verbinden.

  5. Das Team verwendet Git für die Zusammenarbeit und das Nachverfolgen von Änderungen und verwendet die Visual Studio Code Erweiterung, um an dem Agent zu arbeiten.

  6. Jeder Entwickler wendet dann Änderungen an Copilot Studio zum Testen oder Übertragen an eine andere nachgelagerte Umgebung basierend auf seinem Softwareentwicklungslebenszyklus oder automatisierten Pipelines an.

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 Benutzer, die nicht mit Lösungen arbeiten möchten, bietet die Copilot Studio-Erweiterung die Möglichkeit, eine Copilot Studio-Agentdefinition von einem lokalen Computer mit einer anderen 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: Reattach Agent, um den Agent mit der alternativen Umgebung zu verbinden.

  5. Testen Sie den Agent im Copilot Studio-Testbereich.

Optimale Verfahren

Ausführen

  • 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.
  • Halten Sie den Klonspeicherort gesichert (z. B. in GitHub oder Azure DevOps).
  • Dokumentiere deinen Klonstandort in deinem internen Team-Wiki oder in den Dokumenten.

Tue nicht

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

Nächste Schritte

Nachdem du deinen Agenten geklont hast:

  • Last updated on