Erstellen deklarativer Agents mit Dem Microsoft 365 Agents Toolkit und TypeSpec

Ein deklarativer Agent ist eine angepasste Version von Microsoft 365 Copilot, die Benutzer personalisieren können, indem sie bestimmte Anweisungen, Aktionen und Kenntnisse deklarieren. In diesem Leitfaden erfahren Sie, wie Sie mithilfe von TypeSpec und dem Microsoft 365 Agents Toolkit einen deklarativen Agent erstellen.

Voraussetzungen

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

Verwenden Sie für Ihre Entwicklungsumgebung eine der folgenden Optionen:

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

Zum Ausführen der in diesem Artikel beschriebenen Schritte benötigen Sie die folgenden Ressourcen:

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

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

• 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. Wechseln Sie zur Copilot-Anwendung unter https://m365.cloud.microsoft/chat.

2. Wählen Sie neben der Schaltfläche Neue 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 den folgenden Code.

   @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.

1. 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 Copilot Benutzern anzeigt, um zu zeigen, wie sie mit dem deklarativen Agent beginnen können.

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.

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

Die aktualisierten Unterhaltungsstarter 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<Sites = [
       {
         url: "https://learn.microsoft.com",
       },
     ]>;
   }
   

   Weitere Informationen finden Sie unter Websuchobjekt.

   Hinweis

   Wenn Sie das Sites Array nicht angeben, kann der Agent auf alle Webinhalte zugreifen.

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

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

Hinzufügen von OneDrive- und SharePoint-Inhalten

Die 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<ItemsByUrl = [
       {
         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 Sie das Array (oder das alternative ItemsBySharePointIds Array) nicht angebenItemsByUrl, kann der Agent auf alle OneDrive- und SharePoint-Inhalte in Ihrem Microsoft 365-organization zugreifen, auf die der angemeldete Benutzer zugreifen kann.

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<TeamsMessagesByUrl = [
       {
         url: "https://teams.microsoft.com/l/team/...",
       }
     ]>;
     // Omitted for brevity
   }
   

   Weitere Informationen finden Sie unter Microsoft Teams-Nachrichtenobjekt.

   Hinweis

   • Die URL in der url Eigenschaft muss wohlgeformte Links zu einem Teams-Chat, Team- oder Besprechungschat sein.
   • Wenn Sie das TeamsMessagesByUrl Array nicht angeben, kann der Agent auf alle Teams-Kanäle, Teams, Besprechungen, 1:1-Chats und Gruppenchats in Ihrem Microsoft 365-organization zugreifen, auf die der authentifizierte Benutzer zugreifen kann.

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

Der deklarative Agent kann auf Teams-Daten zugreifen, 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 People-Objekt.

1. 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<Folders = [
       {
         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 Folders 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.

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

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

Hinzufügen von Codeinterpreter

Die Codeinterpreterfunktion ist ein erweitertes Tool, das entwickelt wurde, um komplexe Aufgaben über Python-Code zu lösen.

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.

1. 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

Fügen Sie dem verfügbaren Wissen für den Agent elemente hinzu, die von einem Copilot-Connector erfasst wurden.

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<Connections = [
       {
         connectionId: "policieslocal",
       }
     ]>;
     // Omitted for brevity
   }
   

   Weitere Informationen finden Sie unter Copilot Connectors-Objekt.

   Hinweis

   Wenn Sie das Connections Array nicht angeben, ruft der Agent Inhalte von allen Copilot-Connectors in Ihrem Microsoft 365-organization ab, auf die der angemeldete Benutzer zugreifen kann.

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

Der deklarative Agent kann auf Inhalte von Copilot-Connectors zugreifen, 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.

Nächste Schritte