Agents mithilfe von Lösungen exportieren und importieren

Sie können Agenten mit Lösungen importieren, sodass Sie Ihre Agenten über mehrere Umgebungen hinweg bewegen können.

Zuerst erstellen Sie eine benutzerdefinierte Lösung und fügen Ihren Agent hinzu. Dann exportieren Sie die Lösung mit Ihrem Agent und importieren ihn 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 Projektmappen-Explorer in Copilot Studio finden Sie im Artikel 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.
• Machen Sie sich mit den Lösungskonzepten vertraut, die unter Lösungskonzepte und Erstellen und Verwalten von Lösungen in Copilot Studio beschrieben sind.

Wichtige Informationen ...

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

• 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 Agentkomponenten, 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.

• Es ist nicht möglich, eine Lösung zu exportieren, die einen Agenten mit Punkten (.) im Namen eines seiner Themen enthält.

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

1. Führen Sie die Schritte unter Erstellen und Verwalten von Lösungen in Copilot Studio aus, um eine neue Lösung im Copilot Studio-Projektmappen-Explorer zu erstellen.

2. Die von Ihnen erstellte Lösung sollte sich automatisch öffnen. Sollte dies nicht der Fall sein, wählen Sie sie bitte aus der Liste der Lösungen aus.

3. Wählen Sie Bestehende hinzufügen und wählen dann Agent und nochmals Agent aus.

4. Wählen Sie in der Liste Vorhandene Agents hinzufügen den oder 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 wie Themen oder Flows hinzufügen, müssen Sie diese vor dem Export auch dem Agent in Ihrer nicht verwalteten Lösung hinzufügen.

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, wählen Sie Erweitert und wählen Sie dann erforderliche Objekte hinzufügen.

Außerdem sollten Sie die Anweisungen und Anforderungen in der Power Apps-Dokumentation überprüfen, um einer Lösung eine vorhandene Komponente hinzuzufügen.

Lösung mit dem Agent 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 Projektmappen-Explorer in 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 in der Power Apps Exportlösungen-Umgebung wird der rechte Bereich Vor dem Exportieren angezeigt.

4. Die restlichen Schritte sind identisch mit dem Exportieren von Lösungen in Power Apps. Befolgen Sie die Anweisungen und Anforderungen in der Power Apps-Dokumentation, um den Export der Lösung abzuschließen.

Lösung mit dem Agent 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ösungen importieren aus. Wie in der Power Apps-Umgebung Lösungen importieren wird der rechte Bereich Lösung importieren angezeigt.

3. Die restlichen Schritte sind identisch mit dem Importieren von Lösungen in Power Apps. Befolgen Sie die Anweisungen und Anforderungen in der Power Apps-Dokumentation, um den Import der Lösung abzuschließen.

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.

Agenten in Teams exportieren und importieren

In Microsoft Teams können Sie Agents zwischen einzelnen Teams exportieren und importieren, indem Sie die Power Apps-Teams-App verwenden.

Wenn Sie z. B. einen funktionierenden Agent aus einem Teams-Team (Team A) exportieren und dann in Team B importieren, müssen Sie ihn für Team B nicht von Grund auf neu 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. Sie können den Filter im Seitenbereich verwenden, um nur Agenten 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.