Erstellen deklarativer Agents mit Dem Microsoft 365 Agents Toolkit und TypeSpec

Ein deklarativer Agent ist eine angepasste Version von Microsoft 365 Copilot, mit der Benutzer personalisierte Erfahrungen erstellen können, indem sie bestimmte Anweisungen, Aktionen und Kenntnisse deklarieren. In diesem Leitfaden wird veranschaulicht, wie Sie einen deklarativen Agent mithilfe von TypeSpec und dem Microsoft 365 Agents Toolkit (eine Weiterentwicklung des Teams-Toolkits) erstellen.

Hinweis

Der Agent, den Sie in diesem Tutorial erstellen, zielt auf lizenzierte Microsoft 365 Copilot Benutzer ab. Sie können auch Agents für Microsoft 365 Copilot Chat Benutzer mit eingeschränkten Funktionen erstellen. Weitere Informationen finden Sie unter Agent-Funktionen für Microsoft 365-Benutzer.

Hinweis

Deklarative Agents, die auf Microsoft 365 Copilot basieren, werden jetzt in Word und PowerPoint unterstützt.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Microsoft 365 Copilot für Ihre organization verfügbar ist.

Die folgenden Optionen sind für Ihre Entwicklungsumgebung verfügbar:

• Eine Sandbox von Microsoft 365 organization mit Copilot (in eingeschränkter Vorschau über DIE TAP-Mitgliedschaft verfügbar).
• Eine berechtigte Microsoft 365- oder Office 365-Produktionsumgebung mit einer Microsoft 365 Copilot-Lizenz.

Die folgenden Ressourcen sind erforderlich, um die in diesem Artikel beschriebenen Schritte auszuführen:

• Visual Studio Code
• Microsoft 365 Agents Toolkit Visual Studio Code-Erweiterung

Hinweis

Die Screenshots und Verweise auf die Benutzeroberfläche des Microsoft 365 Agents Toolkit (eine Weiterentwicklung des Teams Toolkits) in diesem Dokument wurden mit der neuesten Version 6.0 generiert. Vorabversionen des Agents Toolkits können sich von der Benutzeroberfläche in diesem Dokument unterscheiden.

Sie sollten mit den folgenden Standards und Richtlinien für deklarative Agents für Microsoft 365 Copilot vertraut sein:

• Standards für Compliance, Leistung, Sicherheit und Benutzererfahrung, die in den Teams Store-Validierungsrichtlinien beschrieben sind.

Erstellen eines deklarativen Agents

Erstellen Sie zunächst einen einfachen deklarativen Agent.

1. Öffnen Sie Visual Studio Code.

2. Wählen Sie Microsoft 365 Agents Toolkit > Neuen Agent/eine neue App erstellen aus.

   

3. Wählen Sie Deklarativer Agent aus.

   

4. Wählen Sie Start with TypeSpec für Microsoft 365 Copilot aus, um einen einfachen deklarativen Agent zu erstellen.

5. Wählen Sie Standardordner aus, um ihren Projektstammordner am Standardspeicherort zu speichern.

6. Geben Sie My Agent als Anwendungsname ein , und drücken Sie die EINGABETASTE.

7. Wählen Sie im neuen Visual Studio Code-Fenster, das geöffnet wird, Microsoft 365 Agents Toolkit aus. Wählen Sie im Bereich Lebenszyklus die Option Bereitstellen aus.

   

Testen des Agents

1. Navigieren Sie zur Copilot-Anwendung mit der URL https://m365.cloud.microsoft/chat.

2. Wählen Sie neben der Schaltfläche Neuer Chat das Symbol für die Unterhaltungsschublade aus.

3. Wählen Sie den deklarativen Agent My Agent aus.

   

4. Geben Sie eine Frage für Ihren deklarativen Agent ein, um ihn in Aktion zu sehen.

Hinzufügen von Anweisungen

Anweisungen ändern das Verhalten eines Agents.

1. Öffnen Sie die main.tsp Datei, und ersetzen Sie den @instructions Decorator durch Folgendes.

   @instructions("""
     You are a declarative agent and were created with Team Toolkit. You are an expert at creating poems.
     Every time a user asks a question, you **must** turn the answer into a poem. The poem **must** not use the quote markdown and use regular text.
   """)
   

   Der Inhalt dieses Decorators wird während der Bereitstellung in die instructions -Eigenschaft im Manifest des Agents eingefügt. Weitere Informationen finden Sie unter Manifestobjekt des deklarativen Agents.

2. Wählen Sie im Bereich Lebenszyklus des Microsoft 365 Agents Toolkits die Option Bereitstellen aus.

Der deklarative Agent verwendet Die aktualisierten Anweisungen, nachdem Sie die Seite neu geladen haben.

Hinzufügen von Unterhaltungsstartern

Unterhaltungsstarter sind Hinweise, die dem Benutzer angezeigt werden, um zu veranschaulichen, wie er mit dem deklarativen Agent beginnen kann.

1. Öffnen Sie die main.tsp Datei, und ersetzen Sie den kommentierten @conversationStarter Decorator durch den folgenden Inhalt:

   @conversationStarter(#{
     title: "Getting started",
     text: "How can I get started with Agents Toolkit?"
   })
   
   @conversationStarter(#{
     title: "Getting Help",
     text: "How can I get help with Agents Toolkit?"
   })
   

   Weitere Informationen finden Sie unter Conversation Starters-Objekt.

2. Wählen Sie im Bereich Lebenszyklus des Microsoft 365 Agents Toolkits die Option Bereitstellen aus.

Die aktualisierten Konversationsstarter sind in Ihrem deklarativen Agent verfügbar, nachdem Sie die Seite aktualisiert haben.

Hinzufügen von Webinhalten

Die Websuchfunktion ermöglicht es Agents, den Suchindex in Bing zu verwenden, um auf Benutzeraufforderungen zu reagieren.

1. Öffnen Sie die main.tsp Datei, und fügen Sie die WebSearch Funktion im MyAgent Namespace mit dem folgenden Inhalt hinzu.

   namespace MyAgent {
     op webSearch is AgentCapabilities.WebSearch<TSites = [
       {
         url: "https://learn.microsoft.com",
       },
     ]>;
   }
   

   Weitere Informationen finden Sie unter Websuchobjekt.

   Hinweis

   Wenn das TSites Array nicht angegeben wird, sind alle Webinhalte für den Agent verfügbar.

2. Wählen Sie im Bereich Lebenszyklus des Microsoft 365 Agents Toolkits die Option Bereitstellen aus.

Der deklarative Agent hat Zugriff auf Webinhalte, um seine Antworten zu generieren, nachdem Sie die Seite neu geladen haben.

Hinzufügen von OneDrive- und SharePoint-Inhalten

Die OneDrive- und SharePoint-Funktion ermöglicht es dem Agent, OneDrive- und SharePoint-Inhalte als Wissen zu verwenden.

1. Öffnen Sie die main.tsp Datei, und fügen Sie die MyAgentOneDriveAndSharePoint Funktion im Namespace mit dem folgenden Wert hinzu, und https://contoso.sharepoint.com/sites/ProductSupport ersetzen Sie dabei durch eine SharePoint-Website-URL in Ihrem Microsoft 365-organization.

   namespace MyAgent {
     // Omitted for brevity
     op od_sp is AgentCapabilities.OneDriveAndSharePoint<TItemsByUrl = [
       {
         url: "https://contoso.sharepoint.com/sites/ProductSupport"
       }
     ]>;
     // Omitted for brevity
   }
   

   Weitere Informationen finden Sie unter OneDrive- und SharePoint-Objekt.

   Hinweis

   • URLs sollten der vollständige Pfad zu SharePoint-Elementen (Website, Dokumentbibliothek, Ordner oder Datei) sein. Sie können die Option "Direkten Link kopieren" in SharePoint verwenden, um den vollständigen Pfad oder die Dateien und Ordner abzurufen. Klicken Sie mit der rechten Maustaste auf die Datei oder den Ordner, und wählen Sie Details aus. Navigieren Sie zu Pfad , und wählen Sie das Kopiersymbol aus.
   • Wenn das TItemsByUrl Array (oder das alternative TItemsBySharePointIds Array) nicht angegeben wird, werden alle OneDrive- und SharePoint-Inhalte in Ihrem Microsoft 365-organization, der für den angemeldeten Benutzer verfügbar ist, für den Agent verfügbar sein.

2. Wählen Sie im Bereich Lebenszyklus des Microsoft 365 Agents Toolkits die Option Bereitstellen aus.

Der deklarative Agent hat Zugriff auf OneDrive- und SharePoint-Inhalte, um seine Antworten zu generieren, nachdem Sie die Seite neu geladen haben.

Hinzufügen von Teams-Nachrichten

Die Funktion "Teams-Nachrichten " ermöglicht es dem Agent, Teams-Kanäle, Team- und Besprechungschats als Wissen zu verwenden.

1. Öffnen Sie die main.tsp Datei, und fügen Sie die MyAgentTeamsMessages Funktion im Namespace mit dem folgenden Wert hinzu. Ersetzen Sie dabei https://teams.microsoft.com/l/team/... durch einen Teams-Kanal oder eine Team-URL aus Ihrem organization.

   namespace MyAgent {
     // Omitted for brevity
     op teamsMessages is AgentCapabilities.TeamsMessages<TUrls = [
       {
         url: "https://teams.microsoft.com/l/team/...",
       }
     ]>;
     // Omitted for brevity
   }
   

   Weitere Informationen finden Sie unter Teams-Nachrichtenobjekt.

   Hinweis

   • Die URL in der url Eigenschaft muss wohlgeformte Links zu einem Teams-Chat, Team- oder Besprechungschat sein.
   • Wenn Das TUrls Array nicht angegeben wird, werden alle Teams-Kanäle, Teams, Besprechungen, 1:1-Chats und Gruppenchats in Ihrem Microsoft 365-organization, der für den angemeldeten Benutzer verfügbar ist, für den Agent verfügbar sein.

2. Wählen Sie im Bereich Lebenszyklus des Microsoft 365 Agents Toolkits die Option Bereitstellen aus.

Der deklarative Agent hat Zugriff auf Teams-Daten, um seine Antworten zu generieren, nachdem Sie die Seite neu geladen haben.

Hinzufügen von Personenwissen

Mit der Funktion "Personen" können Sie Ihren Agent so festlegen, dass er Fragen zu Personen in einem organization beantwortet.

1. Öffnen Sie die main.tsp Datei, und fügen Sie die People Funktion im MyAgent Namespace mit dem folgenden Inhalt hinzu.

   namespace MyAgent {
     // Omitted for brevity
     op people is AgentCapabilities.People;
     // Omitted for brevity
   }
   

   Weitere Informationen finden Sie unter Personen-Objekt.

2. Wählen Sie im Bereich Lebenszyklus des Microsoft 365 Agents Toolkits die Option Bereitstellen aus.

Der deklarative Agent hat Zugriff auf Personenwissen, nachdem Sie die Seite neu geladen haben.

Hinzufügen von E-Mail-Wissen

Mit der E-Mail-Funktion können Sie Ihren Agent so festlegen, dass E-Mails aus dem Postfach des Benutzers oder ein freigegebenes Postfach als Wissensquelle verwendet werden.

1. Öffnen Sie die main.tsp Datei, und fügen Sie die Email Funktion im MyAgent Namespace mit dem folgenden Inhalt hinzu.

   namespace MyAgent {
     // Omitted for brevity
     op email is AgentCapabilities.Email<TFolders = [
       {
         folder_id: "Inbox",
       }
     ]>;
     // Omitted for brevity
   }
   

   Weitere Informationen finden Sie unter Email-Objekt.

   Hinweis

   • In diesem Beispiel wird auf den Benutzer des Postfachs des Agents zugegriffen. Um stattdessen auf ein freigegebenes Postfach zuzugreifen, fügen Sie die optionale shared_mailbox Eigenschaft hinzu, die auf die E-Mail-Adresse des freigegebenen Postfachs festgelegt ist.
   • Das TFolders Array beschränkt den Postfachzugriff auf bestimmte Ordner. Lassen Sie das Array aus, um auf das folders gesamte Postfach zuzugreifen.

2. Wählen Sie im Bereich Lebenszyklus des Microsoft 365 Agents Toolkits die Option Bereitstellen aus.

Der deklarative Agent hat Zugriff auf E-Mail-Informationen, nachdem Sie die Seite neu geladen haben.

Hinzufügen eines Bildgenerators

Die Bildgeneratorfunktion ermöglicht Es Agents, Bilder basierend auf Benutzeraufforderungen zu generieren.

1. Öffnen Sie die main.tsp Datei, und fügen Sie die GraphicArt Funktion im MyAgent Namespace mit dem folgenden Inhalt hinzu.

   namespace MyAgent {
     // Omitted for brevity
     op graphicArt is AgentCapabilities.GraphicArt;
     // Omitted for brevity
   }
   

   Weitere Informationen finden Sie unter Grafikobjekt.

2. Wählen Sie im Bereich Lebenszyklus des Microsoft 365 Agents Toolkits die Option Bereitstellen aus.

Der deklarative Agent kann Bilder generieren, nachdem Sie die Seite neu geladen haben.

Hinzufügen von Codeinterpreter

Die Codeinterpreterfunktion ist ein erweitertes Tool, das zum Lösen komplexer Aufgaben über Python-Code entwickelt wurde.

1. Öffnen Sie die main.tsp Datei, und fügen Sie die CodeInterpreter Funktion im MyAgent Namespace mit dem folgenden Inhalt hinzu.

   namespace MyAgent {
     // Omitted for brevity
     op codeInterpreter is AgentCapabilities.CodeInterpreter;
     // Omitted for brevity
   }
   

   Weitere Informationen finden Sie unter Codeinterpreterobjekt.

2. Wählen Sie im Bereich Lebenszyklus des Microsoft 365 Agents Toolkits die Option Bereitstellen aus.

Der deklarative Agent verfügt über die Codeinterpreterfunktion, nachdem Sie die Seite neu geladen haben.

Inhalt von Copilot-Connectors hinzufügen

Sie können dem verfügbaren Wissen für den Agent von einem Copilot-Connector erfasste Elemente hinzufügen.

1. Öffnen Sie die main.tsp Datei, und fügen Sie die MyAgentGraphConnectors Funktion im Namespace mit dem folgenden Wert hinzu. Ersetzen Sie dabei policieslocal durch eine gültige Copilot-Connector-ID in Ihrem Microsoft 365-organization. Weitere Informationen zum Ermitteln von Copilot-Connector-IDs finden Sie unter Abrufen von Funktions-IDs für das deklarative Agent-Manifest.

   namespace MyAgent {
     // Omitted for brevity
     op copilotConnectors is AgentCapabilities.GraphConnectors<TConnections = [
       {
         connectionId: "policieslocal",
       }
     ]>;
     // Omitted for brevity
   }
   

   Weitere Informationen finden Sie unter Copilot Connectors-Objekt.

   Hinweis

   Wenn das TConnections Array nicht angegeben wird, werden Inhalte von allen Copilot-Connectors in Ihrem Microsoft 365-organization, die für den angemeldeten Benutzer verfügbar sind, für den Agent verfügbar sein.

2. Wählen Sie im Bereich Lebenszyklus des Microsoft 365 Agents Toolkits die Option Bereitstellen aus.

Der deklarative Agent hat Zugriff auf Inhalte von Copilot-Connectors, um seine Antworten zu generieren, nachdem Sie die Seite neu geladen haben.

Abgeschlossen

Sie haben den Leitfaden für den deklarativen Agent für Microsoft 365 Copilot abgeschlossen. Nachdem Sie nun mit der Verwendung von TypeSpec zum Erstellen eines deklarativen Agents vertraut sind, finden Sie weitere Informationen in den folgenden Artikeln.

• Erfahren Sie, wie Sie effektive Anweisungen für Ihren Agent schreiben.
• Testen Sie Ihren Agent mit dem Copilot-Entwicklermodus , um zu überprüfen, ob und wie der Copilot-Orchestrator Ihre Wissensquellen für die Verwendung als Reaktion auf bestimmte Eingabeaufforderungen auswählt.
• Hier erhalten Sie Antworten auf häufig gestellte Fragen.
• Erfahren Sie mehr über eine alternative Methode zum Erstellen deklarativer Agents mit Copilot Studio Agent Builder.

Nächste Schritte

Erstellen einer Aktion mit TypeSpec