Benutzerdefinierte Vorlagen in der Agent-Bibliothek im Copilot-Agent-Kit

Administratoren können die Agent-Bibliothek erweitern, indem sie benutzerdefinierte Vorlagen – organisationsspezifische Agent-Vorlagen, die im Dataverse gespeichert werden. Benutzerdefinierte Vorlagen werden neben den Systemvorlagen in der Agent-Bibliothek angezeigt und stehen den Erstellern zum Durchsuchen und Installieren zur Verfügung.

Anmerkung

Nur Benutzer mit der Sicherheitsrolle CSK – Administrator können benutzerdefinierte Vorlagen verwalten. Ersteller können die in der Galerie veröffentlichten benutzerdefinierten Vorlagen sehen, können diese jedoch weder erstellen noch bearbeiten oder löschen.

Benutzerdefinierte Vorlagen unterstützen zwei Veröffentlichungsstatus:

Status Verhalten
Aktiv Sowohl für Administratoren als auch für Ersteller sichtbar. Ersteller können durchsuchen und installieren.
Inaktiv Nur für Admins sichtbar. Wirkt wie ein Entwurf – die Ersteller können ihn nicht sehen oder installieren.

Voraussetzungen

Bevor Sie beginnen:

  • Installieren und konfigurieren Sie das Copilot-Agent-Kit in Ihrer Power Platform-Umgebung.
  • Dem angemeldeten Benutzer wurde im Copilot-Agent-Kit die Sicherheitsrolle CSK – Administrator zugewiesen, um benutzerdefinierte Vorlagen zu erstellen, zu bearbeiten, zu veröffentlichen bzw. deren Veröffentlichung aufzuheben und zu löschen.
  • Die Power Platform-Umgebung hat Copilot Studio aktiviert.

Erstellen einer benutzerdefinierten Vorlage

  1. Im Copilot-Agent-Kit gehen Sie im linken Fenster zur Agentenbibliothek. Die Seite Agentenbibliothek wird geöffnet.
  2. Wählen Sie + Neue Vorlage aus. Der Neue Vorlage-Bereich öffnet sich.
  3. Füllen Sie die Pflichtfelder aus:
    1. Name: Der Anzeigename der Vorlage, z. B. „Meinen Tag planen“.
    2. Beschreibung: Eine kurze Beschreibung des Zwecks und der Funktionalität der Vorlage.
    3. Veröffentlichungsstatus: Legen Sie den Sichtbarkeitsstatus der Vorlage auf Aktiv oder Inaktiv fest.
    4. Symbol und Farbe: Wählen Sie ein Symbol und eine Farbe aus, die die Vorlage repräsentieren sollen.
    5. Vorlagendatei (.zip): Laden Sie eine ZIP-Datei mit einer Copilot Studio-Agent-Lösung oder einem deklarativen Agent-Paket mit einer Größe von bis zu 30 MB hoch.
    6. URL für weitere Informationen: Geben Sie optional eine URL zur Dokumentation an, um weitere Informationen bereitzustellen.
    7. URL der Einrichtungsanleitung: Geben Sie optional eine URL für eine Einrichtungsanleitung an.
  4. Wählen Sie Erstellen aus. Die Agent-Bibliothek wird automatisch aktualisiert, um die neue Vorlagenkarte anzuzeigen.

Trinkgeld

Erstellen Sie eine Vorlage mit dem Veröffentlichungsstatus Inaktiv, um sie als Entwurf zu bearbeiten. Wenn Sie bereit sind, bearbeiten Sie die Vorlage und ändern Sie den Status auf Aktiv, damit sie für die Ersteller sichtbar wird.

Eine benutzerdefinierte Vorlage bearbeiten

Folgen Sie diesen Schritten, um eine benutzerdefinierte Vorlage zu bearbeiten:

  1. Im Copilot-Agent-Kit gehen Sie im linken Fenster zur Agentenbibliothek. Die Seite Agentenbibliothek wird geöffnet.
  2. Wählen Sie die Registerkarte Vorlagen aus.
  3. Durchsuchen Sie die Liste oder suchen Sie nach der benutzerdefinierten Agent-Vorlage, die Sie bearbeiten möchten.
  4. Wählen Sie das Symbol BearbeitenBild des Bearbeiten-Icons. auf einer benutzerdefinierten Vorlagenkarte aus (erkennbar am Chip Benutzerdefiniert). Der Vorlage bearbeiten-Bereich öffnet sich.
  5. Passen Sie die Felder an oder wählen Sie Datei ersetzen, um eine neue ZIP-Datei mit der Lösung hochzuladen.
  6. Wählen Sie Speichern aus.

Wichtig

Wenn Sie den Veröffentlichungsstatus einer Vorlage von Aktiv auf Inaktiv ändern, verschwindet sie sofort aus der Agent-Bibliothek. Ersteller, die den Agent bereits installiert haben, sind davon nicht betroffen, neue Installationen werden jedoch blockiert, bis die Vorlage erneut veröffentlicht wird.

Eine benutzerdefinierte Vorlage löschen

Gehen Sie wie folgt vor, um eine benutzerdefinierte Vorlage zu löschen:

  1. Im Copilot-Agent-Kit gehen Sie im linken Fenster zur Agentenbibliothek. Die Seite Agentenbibliothek wird geöffnet.
  2. Wählen Sie die Registerkarte Vorlagen aus.
  3. Durchsuchen Sie die Liste oder suchen Sie nach der benutzerdefinierten Agent-Vorlage, die Sie löschen möchten.
  4. Wählen Sie das Symbol BearbeitenBild des Bearbeiten-Icons. auf einer benutzerdefinierten Vorlagenkarte aus (erkennbar am Chip Benutzerdefiniert). Der Vorlage bearbeiten-Bereich öffnet sich.
  5. Um den Löschvorgang zu bestätigen, wählen Sie Vorlage löschen und bestätigen Sie die Löschung.

Wichtig

Das Löschen einer benutzerdefinierten Vorlage ist ein unwiderruflicher Vorgang. Agents, die zuvor anhand dieser Vorlage installiert wurden, sind davon nicht betroffen.

  • Last updated on