Agents mithilfe von Lösungen exportieren und importieren

Sie können Agents mithilfe von Lösungen exportieren und importieren, damit Sie Ihre Agents in mehrere Umgebungen verschieben können.

Erstellen Sie zunächst eine benutzerdefinierte Lösung, und fügen Sie Ihr Agent hinzu. Exportieren Sie dann die Lösung mit Ihrem Agent, und importieren Sie sie in eine andere Umgebung. Sie können auch eine Lösung mit einem Agent upgraden oder aktualisieren und eine nicht verwaltete Ebene von einem verwalteten Agent entfernen.

Weitere Informationen zum Lösungsexplorer in Copilot Studio finden Sie unter Anzeigen und Verwalten von Lösungen in Copilot Studio.

Voraussetzungen

• Sie müssen mindestens über die Sicherheitsrolle „Systemanpasser“ verfügen, um diese Funktion verwenden zu können. Erfahren Sie mehr über das Konfigurieren der Benutzersicherheit in einer Umgebung.
• Sie sollten mit Lösungskonzepten vertraut sein, wie in Solution-Konzepten und Create and manage solutions in Copilot Studio beschrieben.

Wichtige Informationen ...

• Sie können Kommentare auf Themen- oder Knotenebene nicht exportieren, wenn Sie einen Agent exportieren.

  Anmerkung

  Wenn Sie einen Agent mithilfe von Lösungen exportieren und importieren, sind nicht alle Agentkomponenten enthalten.

  Die Agentanweisungen (Hauptaufforderung) sind enthalten. Einige Komponenten wie benutzerdefinierte Themen und Wissensquellen werden jedoch möglicherweise nicht einbezogen, wenn sie je nach Erstellung oder Verknüpfung als separate Ressourcen oder Dataverse-Tabellen gespeichert sind.

• Durch das Entfernen eines Agents aus einer Lösung werden seine Komponenten nicht aus der Lösung entfernt. Sie sollten die Komponenten separat entfernen.

  Warnung

  Entfernen Sie nicht verwaltete Agent-Komponenten, wie beispielsweise Agent-Themen, nicht direkt aus der Lösung, es sei denn, Sie entfernen auch den Agent aus der Lösung.

  Sie sollten nur Änderungen an Themen im Rahmen des standardmäßigen Erstellungsprozesses in der Copilot Studio-Benutzeroberfläche vornehmen. Das direkte Entfernen oder Ändern von Komponenten eines Agents aus der Lösung führt dazu, dass der Export und Import fehlschlägt.

• Sie können verwaltete Lösungen nicht exportieren. Wenn Sie eine Lösung erstellen, wird sie standardmäßig nicht verwaltet. Wenn Sie sie in eine verwaltete Lösung ändern, können Sie sie nicht exportieren. Sie müssen eine neue Lösung erstellen.

• Sie können keine Lösung exportieren, die einen Agent mit Punkten (.) im Namen eines seiner Themen enthält.

Erstellen einer benutzerdefinierten Lösung und Hinzufügen Ihres Agents

1. Zum Erstellen einer neuen Lösung im Projektmappen-Explorer von Copilot Studio befolgen Sie die Schritte in Erstellen und Verwalten von Lösungen in Copilot Studio.

2. Die erstellte Lösung wird automatisch geöffnet. Sollte dies nicht der Fall sein, wählen Sie sie bitte aus der Liste der Lösungen aus.

3. Wählen Sie "Vorhandene hinzufügen", dann "Agent" und schließlich erneut "Agent" aus.

4. Wählen Sie in der Liste " Vorhandene Agents hinzufügen " die Agents aus, die Sie exportieren möchten, und wählen Sie dann "Hinzufügen" aus.

Einem Agent in einer benutzerdefinierten Lösung Komponenten hinzufügen

Wenn Sie Ihrem Agent in Copilot Studio Komponenten, z. B. Themen oder Flüsse, hinzufügen, müssen Sie sie auch dem Agent in Ihrer nicht verwalteten Lösung hinzufügen, bevor Sie sie exportieren.

1. Öffnen Sie den Projektmappen-Explorer in Copilot Studio.

2. Wählen Sie die Lösung aus, die Ihren Agent enthält.

3. Suchen Sie im Bereich Objekte Ihren Agenten unter Agent aus.

4. Wählen Sie die drei Punkte (⋮) aus, Erweitert wählen und dann Erforderliche Objekte hinzufügen.

Lesen Sie die Anweisungen und Anforderungen in der Power Apps Dokumentation, um eine vorhandene Komponente an eine Lösung zu addieren.

Fügen Sie Ihrer Lösung individuelle Steckverbinder hinzu

Wenn Ihr Agent benutzerdefinierte Connectors verwendet, folgen Sie den Schritten in Create custom connectors in solutions und informieren Sie sich über bekannte Einschränkungen.

Power Automate Flows hinzufügen

Wenn Sie Flüsse und Umgebungsvariablen verwenden, fügen Sie die erforderlichen Objekte für Flüsse und Umgebungsvariablen hinzu.

1. Öffnen Sie den Projektmappen-Explorer im Copilot Studio.

2. Wählen Sie die Lösung aus, die Ihren Agent enthält.

3. Im Bereich Objekte suchen Sie Ihre Arbeitsabläufe.

4. Wählen Sie die drei Punkte (⋮) aus, Erweitert wählen und dann Erforderliche Objekte hinzufügen.

Hinzufügen von Umgebungsvariablen

Um Umgebungsvariablen hinzuzufügen, folgen Sie diesen Schritten:

1. Öffnen Sie den Projektmappen-Explorer im Copilot Studio.

2. Wählen Sie die Lösung aus, die Ihren Agent enthält.

3. Wenn die Lösung keine Umgebungsvariablen enthält, wählen Sie "Vorhandene hinzufügen" aus, wählen Sie "Weitere" und dann " Umgebungsvariable" aus.

   1. Wählen Sie die erforderlichen Umgebungsvariablen aus.

   2. Wählen Sie Nächst und dann Hinzufügen.

4. Wenn die Lösung bereits über alle Umgebungsvariablen verfügt, wählen Sie die drei Punkte (⋮) aus, wählen Sie "Erweitert" aus, und wählen Sie dann "Erforderliche Objekte hinzufügen" aus, um sicherzustellen, dass die Lösung über alle Abhängigkeiten verfügt.

Komponenten für verwaltete Lösungen anpassen

Informationen zum Anpassen von Komponenten in einer verwalteten Lösung finden Sie unter Anzeigen und Bearbeiten von verwalteten Tabelleneigenschaften.

Stellen Sie sicher, dass Ihre Umgebung Anpassungen erlaubt, bevor Sie verwaltete Lösungen importieren. Überprüfen Sie, ob Ihre Umgebung keine Anpassungen oder unverwaltete Lösungen blockiert. Erfahren Sie mehr unter Blockierte und nicht verwaltete Anpassungen in Dataverse.

Lösung mit Ihrem Agenten exportieren

Sie exportieren und importieren Agents, indem Sie die Lösungen, die diese enthalten, von einer Umgebung in eine andere exportieren und importieren.

Führen Sie die folgenden Schritte aus, um die Lösung mit Ihrem Agent zu exportieren:

1. Öffnen Sie den Lösungsexplorer im Copilot Studio.

2. Wählen Sie in der Liste der nicht verwalteten Lösungen die Lösung aus, die Ihren Agent enthält.

3. Wählen Sie Lösung exportieren aus. Wie im Power Apps Exportieren von Lösungen erscheint der rechte Bereich Bevor Sie exportieren.

4. Die restlichen Schritte sind identisch mit dem Exportieren von Lösungen in Power Apps. Um Exportierung der Lösung abzuschließen, befolgen Sie die Anweisungen und Anforderungen in der Power Apps Dokumentation.

Die Lösung mit Ihrem Agenten importieren

Führen Sie die folgenden Schritte aus, um die Lösung mit Ihrem Agent in eine andere Umgebung zu importieren:

1. Öffnen Sie in der Zielumgebung den Projektmappen-Explorer in Copilot Studio.

2. Wählen Sie Lösung importieren aus. Wie im Power Apps Importieren von Lösungen wird der rechte Bereich Importieren einer Lösung angezeigt.

3. Die restlichen Schritte entsprechen dem Importieren von Lösungen in Power Apps. Um Importierung der Lösung abzuschließen, befolgen Sie die Anweisungen und Anforderungen in der Power Apps Dokumentation.

Wenn der Import nicht erfolgreich ist, wählen Sie Protokolldatei herunterladen aus, um eine XML-Datei herunterzuladen, die Details darüber enthält, warum der Import fehlgeschlagen ist. Die häufigste Ursache für das Fehlschlagen eines Lösungsimports besteht darin, dass die Lösung einige erforderliche Lösungskomponenten nicht enthielt.

1. Wählen Sie im Projektmappen-Explorer die neue importierte Lösung aus der Liste aus.

2. Wählen Sie im Bereich ObjekteAgenten aus. Wählen Sie dann den Namen des Agents aus, um den Agent in Copilot Studio auf einer neuen Registerkarte zu öffnen.

3. Konfigurieren Sie die Benutzerauthentifizierung für den Agent erneut.

Agents in Teams exportieren und importieren

In Microsoft Teams können Sie Agents mithilfe der Power Apps Teams-App zwischen einzelnen Teams exportieren und importieren.

Wenn Sie beispielsweise einen Arbeitsagenten aus einem Teams-Team (Team A) exportieren und dann in Team B importieren, müssen Sie ihn nicht von Grund auf neu für Team B erstellen.

Befolgen Sie die Anweisungen unter Exportieren von Anpassungen aus Dataverse for Teams.

Wählen Sie bei der Auswahl der zu exportierenden Anpassungen den Agent aus, den Sie exportieren möchten. Verwenden Sie den Filter im Seitenbereich, um nur Agents für ein bestimmtes Team anzuzeigen.

Der Agent wird im Ordner Downloads auf Ihrem Computer gespeichert.

Um in Teams zu importieren, befolgen Sie die Anweisungen zum Importieren von Anpassungen in Dataverse for Teams.

Ihr Agent wird in der Copilot Studio-App in Teams unter dem Team angezeigt, in das Sie ihn importiert haben.