Deklarative Agentenvorlagen in der Agentenbibliothek im Copilot-Agent-Kit

Deklarative Agentenvorlagen sind vorgefertigte Agentendefinitionen, die für Microsoft 365 Copilot entwickelt wurden. Die Agent-Bibliothek hilft Ihnen, diese Vorlagen anzupassen und herunterzuladen, aber die Bereitstellung in Teams ist immer ein manueller Schritt. Sie laden die Lösungsdatei .zip herunter und laden sie selbst in Teams hoch.

Wenn Sie in der Agentenbibliothek eine deklarative Agentenvorlage auswählen, öffnet sich ein Bereich mit der Vorlagenbeschreibung und drei Erstellungsoptionen.

Screenshot des deklarativen Agentvorlagen-Bereichs mit den drei Erstellungsoptionen.

Erstellungsoption Beschreibung des Dataflows Am besten geeignet für
Anpassen & herunterladen Konfigurieren Sie die Vorlage und laden Sie eine Lösungsdatei .zip herunter. Am meisten Nutzer. Passen Sie den Agenten inline an und laden Sie dann manuell in Teams hoch.
Agent Builder verwenden Laden Sie die Einrichtungsschritte für Microsoft 365 Agent Builder herunter und folgen Sie diesen. Nutzer, die den Agenten direkt in Microsoft 365 Copilot erstellen möchten.
Mit VS Code erstellen Klonen Sie das Repository und folgen Dem Einrichtungs-Leitfaden für Entwickler. Entwickler, die einen Code-First-Ansatz mit dem Microsoft 365 Agents Toolkit bevorzugen.

Voraussetzungen

Bevor Sie beginnen:

  • Installieren und konfigurieren Sie das Copilot-Agent-Kit in Ihrer Power Platform-Umgebung.
  • Der angemeldete Nutzer hat die CSK - Ersteller Sicherheitsrolle im Copilot-Agent-Kit zugewiesen, um Vorlagen zu durchsuchen und zu installieren.
  • Die Power Platform-Umgebung hat Copilot Studio aktiviert.

Anpassen und herunterladen

Anpassen und herunterladen ist die gängigste Option. Sie ermöglicht es, die Vorlage direkt in der Agentenbibliothek zu konfigurieren, bevor Sie die bereit-zu-implementierende Lösungsdatei .zip herunterladen.

  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 oder suchen Sie nach der deklarativen Agentenvorlage, die Sie verwenden möchten.

  4. Wählen Sie eine deklarative Agent-Vorlagekarte aus, um den Bereich für Vorlagendetails zu öffnen.

  5. Im Vorlagen-Detailbereich wählen Sie Anpassen & herunterladen und wählen dann Weiter aus. Der anpassbare Bereich wird geöffnet.

  6. Im Anpassungsbereich bearbeiten Sie die folgenden Felder:

    • Name: Der Anzeigename des Agenten, zum Beispiel „Plane meinen Tag“.
    • Beschreibung: Eine kurze Zusammenfassung dessen, was der Agent macht (bis zu 1.000 Zeichen). Aktualisieren Sie diese Zusammenfassung, um den Anwendungsfall Ihrer Organisation widerzuspiegeln.
    • Anweisungen: Die vollständige Systemanweisung, die die Persona, das Verhalten, die Regeln und den Antwortstil des Agenten definiert (bis zu 8.000 Zeichen). Passen Sie diese Eingabeaufforderung an Ihre spezifischen Anforderungen an.
    • Funktionen: Schalten Sie die Microsoft 365-Datenquellen ein- oder aus, auf die der Agent zugreifen kann.
    • Startprompts: Sehen Sie die für den deklarativen Agenten konfigurierten Startprompts an, aktualisieren oder löschen Sie diese.

    Screenshot des Anpassungsbereich für den deklarativen Agent, der die bearbeitbaren Felder zeigt.

  7. Nachdem Sie die Vorlage angepasst haben, wählen Sie Herunterladen, um die modifizierte Lösungsdatei .zip herunterzuladen. Die Datei wird auf Ihrem Computer gespeichert und ein neues Panel öffnet sich.

  8. Der neue Bereich zeigt Schritt-für-Schritt-Anleitungen zur Installation des Agenten in Teams:

    1. Öffne Microsoft Teams (Desktop-App oder teams.microsoft.com).
    2. Wählen Sie Apps im linken Fensterbereich. Der Bereich Apps wird geöffnet.
    3. Wählen Sie unten im Bereich AppsApps verwalten aus. Die Seite Apps verwalten wird geöffnet.
    4. Wählen Sie Eine App hochladen und dann Hochladen im Bereich eine benutzerdefinierte App hochladen.
    5. Wählen Sie die heruntergeladene .zip Datei von Ihrem Computer aus. Der Detailbereich der App wird geöffnet.
    6. Wählen Sie Add aus

    Screenshot der Schritt-für-Schritt-Installationsanleitung für Teams.

  9. Wählen Sie Fertig aus.

Trinkgeld

Nehmen Sie sich Zeit, das Anleitungsfeld vor dem Herunterladen anzupassen. Gut formulierte Anweisungen sind der wichtigste Faktor für die Qualität eines Agenten. Die Vorlage enthält vorgefertigte Anleitungen, die Sie als Ausgangspunkt nutzen und an die Bedürfnisse Ihrer Organisation anpassen können.

Agent Builder verwenden

Agent Builder ermöglicht es Ihnen, den Agenten direkt in Microsoft 365 Copilot zu erstellen. Ein Upload ist nicht .zip erforderlich.

  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 oder suchen Sie nach der deklarativen Agentenvorlage, die Sie verwenden möchten.

  4. Wählen Sie eine deklarative Agent-Vorlagekarte aus, um den Bereich für Vorlagendetails zu öffnen.

  5. Im Vorlagen-Detailbereich wählen Sie Agent Builder verwenden und dann Weiter aus. Ein neue Browser-Registerkarte öffnet sich automatisch mit der Einrichtungsanleitung für Microsoft 365 Agent Builder. Wenn sich die Registerkarte nicht öffnet, wählen Sie Herunterladen, um eine Kopie der Einrichtungsanleitung als PDF herunterzuladen.

    Screenshot der Download-Schaltfläche, mit dem die Einrichtungsanleitung als PDF gespeichert wird.

  6. Folgen Sie der Einrichtungsanleitung, um Ihren Agenten direkt in Microsoft 365 Copilot zu konfigurieren und bereitzustellen.

Trinkgeld

Agent Builder ist eine No-Code-Option. Sie müssen keine .zip Dateien herunterladen oder hochladen. Der Einrichtungsleitfaden führt Sie direkt durch die Erstellung des Agenten in der Microsoft 365 Copilot-Oberfläche.

Mit VS Code erstellen

Für Entwickler, die einen Code-First-Ansatz bevorzugen, kann man das Vorlagen-Repository klonen und es mit Visual Studio Code und der Microsoft 365 Agents Toolkit-Erweiterung anpassen.

  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 oder suchen Sie nach der deklarativen Agentenvorlage, die Sie verwenden möchten.

  4. Wählen Sie eine deklarative Agent-Vorlagekarte aus, um den Bereich für Vorlagendetails zu öffnen.

  5. Im Vorlagen-Detailbereich wählen Sie mit VS Code erstellen und dann Weiter aus. Eine neue Browser-Registerkarte öffnet sich automatisch mit der Einrichtungsanleitung für Entwickler. Wenn sich die Registerkarte nicht öffnet, wählen Sie Herunterladen, um eine Kopie der Einrichtungsanleitung als PDF herunterzuladen.

    Screenshot der GitHub-Klon-URL und der Download-Option für die Entwickler-Einrichtungsleitung.

  6. Kopieren Sie die GitHub-Klon-URL: https://github.com/microsoft/m365-agent-templates.git.

  7. Klonen Sie das Repository mit der bereitgestellten URL.

  8. Öffnen Sie das geklonte Repository in Visual Studio Code.

  9. Folgen Sie dem Entwickler-Einrichtungsleitfaden, um die Agentendefinition, Anweisungen und Funktionen mit der Microsoft 365 Agents Toolkit-Erweiterung anzupassen.

  10. Laden Sie den Agenten manuell in Teams hoch, indem Sie folgende Schritte befolgen:

    1. Öffne Microsoft Teams (Desktop-App oder teams.microsoft.com).
    2. Wählen Sie Apps im linken Fensterbereich. Der Bereich Apps wird geöffnet.
    3. Wählen Sie unten im Bereich AppsApps verwalten aus. Die Seite Apps verwalten wird geöffnet.
    4. Wählen Sie Eine App hochladen und dann Hochladen im Bereich eine benutzerdefinierte App hochladen.
    5. Wählen Sie die heruntergeladene .zip Datei von Ihrem Computer aus. Der Detailbereich der App wird geöffnet.
    6. Wählen Sie Add aus
  • Last updated on