Erstellen und teilen Sie wiederverwendbare Komponentensammlungen

Komponentensammlungen ermöglichen es Herstellern, wiederverwendbare Komponenten zwischen Agenten zu erstellen und zu teilen.

Wenn Sie Sammlungen verwenden, haben Sie folgende Möglichkeiten:

• Sie können Komponentensammlungen in der Seitenleiste von Copilot Studio verwalten, suchen und erstellen, ohne einen Agenten öffnen zu müssen, was das Auffinden und Wiederverwenden gemeinsamer Bausteine erleichtert.
• Verwenden Sie den Ein-Klick-Export und den vereinfachten Import. Copilot Studio packt Sammlungen in versioniert verwaltete Lösungen und ermöglicht es Ihnen, direkt aus den Agenteneinstellungen zu importieren, was das Maker-Erlebnis vereinfacht.
• Teilen Sie Sammlungen mit Teamkollegen und kontrollieren Sie gleichzeitig den Bearbeitungszugriff, ermöglichen Sie eine sichere Zusammenarbeit und schützen Sie wichtige Ressourcen.
• Beschränken Sie eine Sammlung, sodass sie nur von ihrem vorgesehenen Agenten (dem primären Agenten) verwendet werden kann, und helfen Sie Teams, große oder vertrauliche Copiloten ohne unbeabsichtigte Wiederverwendung zu modularisieren.
• Testen Sie, wie sich eine Sammlung in verschiedenen Agents direkt über den Arbeitsbereich "Komponentensammlungen" verhält, um die Iteration zu beschleunigen und konsistente Ergebnisse sicherzustellen.
• Sammeln und Freigeben neuerer Connectortypen, einschließlich untergeordneter Agents, Modellkontextprotokolle, Connectors und Flows.
• Entfernen oder passen Sie Abhängigkeiten an, um Assets zu entkoppeln und unabhängige Release-Zyklen über Teams hinweg zu unterstützen.

Zu den Agentenkomponenten gehören:

• topics
• Wissen
• Werkzeuge
• Untergeordnete Agenten
• Modellkontext-Protokolle
• connectors
• flows
• Entitäten

Um eine Komponentensammlung zu bearbeiten oder einem Agent eine Komponentensammlung hinzuzufügen, müssen Sie die Person sein, die die Sammlung erstellt hat, oder ein Benutzer mit der Rolle Systemanpasser oder Systemadministrator. Sobald eine Komponentensammlung für einen Agent verfügbar ist, können alle Agentenautoren die Sammlung sehen und verwenden, aber sie können die Komponenten in der Sammlung nicht ändern. Erfahren Sie mehr über das Konfigurieren der Benutzersicherheit in einer Umgebung.

Komponentensammlungen erstellen

Sie erstellen Komponentensammlungen direkt auf der Seite Einstellungen für einen Agenten oder auf der Seite Komponentensammlungen . Wenn Sie einer Auflistung Komponenten aus einem Agent hinzufügen, werden die Komponenten in die Auflistung verschoben, und der Agent verweist auf die Komponenten in der Auflistung.

Sie können die Sammlung für andere Agents in Ihrer Umgebung freigeben oder exportieren, um sie in andere Umgebungen zu importieren.

Eine Komponentensammlung aus einem Agent erstellen

1. Öffnen Sie den Agent, der die Komponenten enthält, die Sie als Komponentensammlung zur Verfügung stellen möchten.

2. Gehen Sie zu Einstellungen und wählen Komponentensammlung.

3. Wenn Sie im Begriff sind, die erste Komponentensammlung in Ihrer Umgebung zu erstellen, wählen Sie Erstellen aus. Wählen Sie andernfalls Neu aus.

4. Geben Sie einen Namen und eine Beschreibung für Ihre Komponentensammlung ein.

5. Wählen Sie Weiter.

6. Wählen Sie die Komponente aus, die Sie der Komponentensammlung hinzufügen möchten. Sie können die Kategorien und das Suchfeld verwenden, um die Liste der Komponenten einzugrenzen. Sie können untergeordnete Agents verbinden, wenn Sie die Sammlung überprüfen.

   Alle Komponentenabhängigkeiten werden automatisch ausgewählt und der Sammlung hinzugefügt. Sie können Abhängigkeiten nur ausschließen, wenn Sie einen primären Agent für die Komponentensammlung festgelegt haben.

   Der primäre Agent ist der Agent, der die Komponenten in der Auflistung besitzt. Wenn Sie keinen primären Agent festlegen, befindet sich die Komponentensammlung im Besitz der Umgebung und muss daher Zugriff auf die Abhängigkeiten haben.

   Tipp

   Wenn Sie Dateien als Wissensquellen für einen Agent hochgeladen haben, werden sie durch das Hinzufügen solcher Dateien zu einer Komponentensammlung vom ursprünglichen Agent entfernt.
   Um dieses Problem zu umgehen, können Sie solche Dateien aus der Komponentensammlung zurück auf ihren ursprünglichen Agent verschieben.

7. Wählen Sie Weiter.

8. Überprüfen Sie den Inhalt Ihrer Sammlung, und wählen Sie Erstellen aus.

Erstellen einer Komponentensammlung auf Umgebungsebene

1. Wähle in der Seitenleiste die drei Punkte (...) aus und wähle dann Komponentensammlungen.

2. Klicken Sie auf Neu hinzufügen, und wählen Sie dann die Komponentensammlung aus.

3. Geben Sie einen Namen und eine Beschreibung für Ihre Komponentensammlung ein.

4. Klicken Sie auf Fertig stellen.

5. Verbinden Sie den Agent, der die Komponenten enthält, die Sie freigeben möchten, mit Ihrer neuen Komponentensammlung.

6. Fügen Sie der Sammlung Komponenten des ausgewählten Agents hinzu.

Verbinden eines Agents mit einer Komponentensammlung

1. Wähle in der Seitenleiste die drei Punkte (...) aus und wähle dann Komponentensammlungen.

2. Wählen Sie die Sammlung aus, die Sie mit einem Agent verbinden möchten.

3. Wählen Sie im Abschnitt Verbundene Agenten die Option Agent hinzufügen aus. Wählen Sie den Agent aus, den Sie verbinden möchten, und klicken Sie dann auf Hinzufügen.

   Sie können Ihrer Komponentensammlung beliebige Komponenten aus den verbundenen Agenten hinzufügen. Alle verbundenen Agents können auch beliebige Komponenten aus dieser Sammlung verwenden.

Komponenten von einem Agent zu einer Sammlung hinzufügen

1. Wähle in der Seitenleiste die drei Punkte (...) aus und wähle dann Komponentensammlungen.

2. Wählen Sie die Sammlung aus, der Sie Komponenten hinzufügen möchten.

3. Verbinden Sie den Agent, der die Komponenten enthält, die Sie in der Auflistung wiederverwenden möchten, falls dies noch nicht geschehen ist.

4. Wählen Sie im Abschnitt Komponenten hinzufügen die Option Von einem Agenten hinzufügen aus.

   Hinweis

   Wenn Sie keine Agents mit der Komponentensammlung verbunden haben, ist die Option zum Hinzufügen von Komponenten aus einem Agent nicht verfügbar.

5. Klicken Sie auf Weiter, und wählen Sie den gewünschten Agenten aus.

6. Wählen Sie die Komponente aus, die Sie der Komponentensammlung hinzufügen möchten. Sie können die Kategoriebeschriftungen und das Feld Komponenten suchen verwenden, um die Liste der Komponenten einzugrenzen.

7. Wählen Sie Weiter.

8. Überprüfen Sie den Inhalt Ihrer Sammlung, und wählen Sie Zur Sammllung hinzufügen aus.

Festlegen eines primären Agents für eine Komponentensammlung und Ausschließen von Abhängigkeiten

Sie können einen einzelnen Agent als primären Agent für eine Komponentensammlung festlegen. Ersteller haben die Möglichkeit, einen primären Agent auszuwählen, wenn sie nur einen bestimmten Agenten für die Komponentensammlung verwenden möchten.

Wenn Ihre Sammlung über mehrere verbundene Agents verfügt, können Sie keinen primären Agent festlegen. Sie müssen zuerst alle anderen Agenten trennen.

Wenn Sie einen primären Agent festlegen, können Sie auch Abhängigkeiten ausschließen, wenn Sie Komponenten zu diesem Agent hinzufügen. Auf diese Weise können Sie kleinere Komponentensammlungen erstellen, die nicht alle Abhängigkeiten enthalten, was nützlich sein kann, wenn Sie nur bestimmte Komponenten freigeben möchten.

1. Wähle in der Seitenleiste die drei Punkte (...) aus und wähle dann Komponentensammlungen.

2. Wählen Sie die Sammlung aus, für die Sie einen primären Agent festlegen möchten.

3. Im Abschnitt Verbundene Agenten wählen Sie die drei Punkte (...) neben dem Agenten aus und wählen dann Primäragent setzen.

   

   Von Bedeutung

   Wenn Ihre Sammlung über mehrere verbundene Agents verfügt, ist die Option zum Festlegen eines primären Agents nicht verfügbar. Wählen Sie für jeden Agenten, mit Ausnahme des Agenten, den Sie als primären Agent festlegen möchten, die Option Vom Agenten trennen aus.

So schließen Sie Abhängigkeiten beim Hinzufügen von Komponenten aus dem primären Agent aus:

1. Wählen Sie Aus einem Agent in der Komponentensammlung Hinzufügen aus.

2. Wählen Sie den primären Agent aus, und klicken Sie auf Weiter.

3. Wählen Sie die Komponente aus, die Sie der Komponentensammlung hinzufügen möchten. Deaktivieren Sie Komponentenabhängigkeiten einschließen.

4. Wählen Sie Weiter.

5. Überprüfen Sie den Inhalt Ihrer Sammlung, und wählen Sie Zur Sammllung hinzufügen aus.

Freigeben einer Komponentensammlung

Sie können eine Komponentensammlung für andere Benutzer in Ihrer Organisation freigeben und angeben, ob diese über Betrachter - oder Bearbeiterberechtigungen verfügen. Weitere Informationen zu Berechtigungsrollen für Copilot Studio-Benutzer finden Sie unter Steuern, wie Agenten freigegeben werden.

1. Wähle in der Seitenleiste die drei Punkte (...) aus und wähle dann Komponentensammlungen.

2. Wählen Sie die Sammlung aus, die Sie freigeben möchten.

3. Wählen Sie in der oberen Menüleiste Freigeben aus.

4. Geben Sie im Freigabebereich die Namen oder E-Mail-Adressen anderer Personen ein, für die Sie die Komponentensammlung freigeben möchten. Geben Sie für jeden Benutzer die Berechtigungsrollen (Betrachter oder Bearbeiter) an.

Importieren und Exportieren von Sammlungen

Sie können Sammlungen exportieren, um sie in andere Umgebungen zu importieren. Wenn Sie eine Sammlung exportieren, wird sie verwaltet. Informationen zum Exportieren einer Auflistung, ohne dass sie verwaltet wird, finden Sie unter Verwenden von Lösungen für komplexe Auflistungen.

So exportieren Sie eine Sammlung:

1. Wähle in der Seitenleiste die drei Punkte (...) aus und wähle dann Komponentensammlungen.

2. Öffnen Sie die Sammlung, die Sie exportieren möchten.

3. Wählen Sie in der oberen Menüleiste Exportieren aus.

Der Export beginnt, und eine Benachrichtigungsleiste wird angezeigt. Wenn der Export abgeschlossen ist, ändert sich die Benachrichtigung und enthält einen Link zum Herunterladen der Sammlung als .zip Datei.

So importieren Sie eine Sammlung:

1. Stellen Sie in Copilot Studio sicher, dass die Umgebung, in die Sie Ihre Sammlung importieren möchten, ausgewählt ist:

   

2. Öffnen Sie den Agent, den Sie mit der Sammlung verbinden möchten, und wählen Sie dann in der oberen Leiste Einstellungen aus.

3. Wählen Sie im Seitenmenü Komponentenauflistungen und dann Lösung importieren aus.

4. Wählen Sie im angezeigten Bereich Dateien durchsuchen und dann die exportierte Sammlung aus.

5. Die Details der Kollektion werden angezeigt. Sie können Plug-in-Schritte und -Flows im Abschnitt Erweiterte Einstellungen ausschließen.

   Tipp

   Wenn Sie versuchen, eine Sammlung in dieselbe Umgebung zu importieren, aus der Sie sie exportiert haben, wird eine Fehlermeldung angezeigt. Vergewissern Sie sich, dass Sie sich in der Zielumgebung befinden, in der die Sammlung nicht enthalten ist.

6. Wählen Sie Weiter. Das Importpanel schließt sich, und eine Meldung zeigt, dass die Sammlung erfolgreich importiert wurde.

Verwenden von Lösungen für komplexe Sammlungen

Sie können Lösungen auch verwenden, um Agent-Komponenten aus einer Umgebung zu exportieren und in eine andere zu importieren. Die Lösung funktioniert als Träger für die Komponenten. Sie können mehrere Agentenkomponenten in einer Lösung exportieren und importieren.

Verwenden Sie im Allgemeinen Lösungen für komplexe Komponentensammlungen. Dies ist beispielsweise der Fall, wenn Ihre Sammlung über Konnektoren oder Umgebungsvariablen verfügt.

Erstellen einer Lösung

1. Gehen Sie auf die Seite Lösungen.

2. Wählen Sie Neue Lösung aus.

3. Geben Sie die folgenden Informationen für die neue Lösung ein:

   • Anzeigename: Der Name, der in der Liste der Lösungen angezeigt wird. Sie können ihn später ändern.
   • Name: Der eindeutige Name der Lösung, generiert aus Anzeigename. Sie können ihn nur ändern, bevor Sie die Lösung speichern.
   • Herausgeber: Wählen Sie den Standardherausgeber oder erstellen Sie einen neuen Herausgeber. Erwägen Sie die Erstellung eines einzelnen Herausgebers und dessen konsistente Verwendung in allen Umgebungen Ihrer Lösung. Weitere Informationen zu Lösungsherausgebern.
   • Version: Geben Sie eine Nummer für die Version Ihrer Lösung an. Die Versionsnummer ist im Dateinamen enthalten, wenn Sie die Lösung exportieren.

4. Wählen Sie Erstellen aus.

Einer Lösung Komponentensammlungen hinzufügen

1. Wechseln Sie zur Seite Lösungen und öffnen Sie die gewünschte Lösung, falls sie noch nicht geöffnet ist.

2. Wählen Sie Vorhandene hinzufügen aus, zeigen Sie auf Agent, und wählen Sie Komponentensammlung aus.

   Es wird ein Bereich angezeigt, in dem alle verfügbaren Komponentensammlungen angezeigt werden.

3. Wählen Sie die Komponentensammlungen aus, die Sie exportieren möchten, und wählen Sie dann unten im Bereich Hinzufügen aus.

Exportieren einer Lösung zum Freigeben von Komponentensammlungen in anderen Umgebungen

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

1. Gehen Sie auf die Seite Lösungen.

2. Wählen Sie die drei Punkte (⋮) für die Lösung aus, die die Komponentensammlungen enthält, die Sie exportieren möchten, und wählen Sie dann Lösung exportieren.

3. Geben Sie die folgenden Werte ein, oder wählen Sie diese aus:

   • Versionsnummer: Copilot Studio erhöht Ihre Lösungsversion automatisch. Sie können die Standardversion akzeptieren oder eine eigene eingeben.
   • Exportieren als: Wählen Sie den Pakettyp, entweder verwaltet oder nicht verwaltet aus. Weitere Informationen zu verwalteten und nicht verwalteten Lösungen.

4. Wählen Sie Exportieren aus. Der Export kann möglicherweise einige Minuten dauern. Sehen Sie sich die Statusmeldung oben auf der Seite Lösungen an.

5. Wenn der Export abgeschlossen ist, wählen Sie die Schaltfläche Herunterladen aus, um eine .zip Datei herunterzuladen.

   Der Dateiname hat folgendes Format: SolutionName_Version_SolutionType.zip, z. B. ContosoSolution_1_0_0_1_managed.zip.

Importieren einer Lösung zum Hinzufügen von Komponentensammlungen zu einer Umgebung

1. Gehen Sie auf die Seite Lösungen.

2. Wählen Sie die Umgebung aus, in die Sie Ihre Komponentensammlung importieren möchten.

3. Wählen Sie Lösungen importieren aus.

4. Wählen Sie im Bereich Importieren die Option Durchsuchen und wählen Sie die .zip Datei aus, die die Lösung mit Ihrer Komponentensammlung enthält, und wählen Sie dann Weiter aus.

5. Klicken Sie auf Importieren. Der Import kann möglicherweise einige Minuten dauern. Sehen Sie sich die Statusmeldung oben auf der Seite Lösungen an.

6. warten Sie einen Augenblick, bis der Lösungsimport abgeschlossen ist.

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.

Dem Agent importierte Komponentensammlungen hinzufügen

Nachdem Sie eine Komponentensammlung importiert haben, können Sie sie in Ihren Agents verwenden.

1. Öffnen Sie den Agent, in dem Sie die Komponentensammlung verwenden möchten.

2. Gehen Sie zur Seite Einstellungen und wählen Komponentensammlung.

3. Wählen Sie neben der importierten Komponentensammlung die drei Punkte (...) und dann Zum Agent hinzufügen aus.

   Es wird eine Meldung angezeigt, in der Sie zur Bestätigung aufgefordert werden.

4. Wählen Sei Zu Agent hinzufügen aus.

   Der Name Ihres Agents wird unter Aktiv für für diese Komponentensammlung angezeigt.

5. Überprüfen Sie die Komponenten aus der importierten Sammlung, und veröffentlichen Sie den Agenten, um die Änderungen Ihren Kunden zur Verfügung zu stellen.

Komponenten zu einer Komponentensammlung in einer benutzerdefinierten Lösung hinzufügen

Wenn Sie neue Agentkomponenten zu einer Komponentensammlung in Copilot Studio hinzufügen, müssen Sie sie auch jeder nicht verwalteten Lösung hinzufügen, die auf diese Komponentensammlung verweist.

1. Wechseln Sie zur Seite Lösungen und öffnen Sie die nicht verwaltete Lösung, die die zu aktualisierende Komponentensammlung enthält.

2. Wählen Sie im Bereich Objekte die Option Agent-Komponentensammlungen aus.

3. Wählen Sie die drei Punkte (⋮) der Sammlung, die Sie aktualisieren möchten, zeigen Sie auf Erweitert und wählen Sie erforderliche Objekte hinzufügen.

4. Wählen Sie OK aus.

   Im Bereich Objekte können Sie Agentenkomponenten auswählen, um zu überprüfen, ob die erwarteten Komponenten jetzt angezeigt werden.

Projektmappen-Explorer öffnen

In Copilot Studio wählen Sie die drei Punkte (...) in der Seitenleiste aus und wählen Sie dann Lösungen.

Die Seite Lösungen wird in einer neuen Browserregisterkarte geöffnet.