Erstellen von JavaScript-Agents in Visual Studio Code mit dem Microsoft 365 Agents Toolkit

In diesem Artikel erfahren Sie, wie Sie ein neues Agents SDK-JavaScript-Projekt in Visual Studio mit dem Microsoft 365 Agents Toolkit erstellen.

Voraussetzungen

• Installieren Sie die Agents Toolkit-Erweiterung für Visual Studio Code.

• Sie benötigen ein Azure-Modell aus dem Azure AI Foundry-Portal. Sie benötigen diese Daten zum Modell:

  • Name
  • Ziel-URI
  • Schlüssel

  Informationen zum Hinzufügen und Konfigurieren von Modellen zu Azure AI Foundry-Modellen

Erstellen eines neuen Projekts

Das Agents Toolkit stellt eine Projektvorlage bereit, die Ihnen bei den ersten Schritten beim Erstellen eines Agents hilft. Sie können mit einer Vorlage im Toolkit oder mit Beispielen im Agents SDK beginnen.

Sie können ein neues Agentprojekt erstellen, indem Sie im Microsoft 365 Agents Toolkit "Neuen Agent/App erstellen " auswählen. Sie können mit einer Vorlage im Toolkit oder mit Beispielen im Agents SDK beginnen. Diese Anleitung bietet eine Einführung in das Agents Toolkit.

Um mit dem Erstellen eines Agents mit dem Agents SDK zu beginnen, wählen Sie im ersten Menü: den benutzerdefinierten Engine-Agent aus.

Einen neuen Agent erstellen

Wenn der benutzerdefinierte Engine-Agent als Option ausgewählt ist, werden Sie durch eine Reihe von Eingabeaufforderungen geführt, um Ihre eigenen KI-Dienste hinzuzufügen.

1. Sie haben zwei Vorlagen, aus denen Sie auswählen können: Basic Custom Engine Agent oder Weather Agent. Der grundlegende benutzerdefinierte Modul-Agent ist ein Agent ohne vordefinierte Komponenten. Sie müssen einen KI-Orchestrator hinzufügen, z. B. semantic Kernel oder LangChain, und Ihr Wissen.

   

2. Wählen Sie in diesem Beispiel Wetter-Agent aus, um einen Agent zu erstellen, der LangChain und Azure AI Foundry verwendet, je nach ausgewählter Sprache.

3. Wählen Sie Azure OpenAI für Ihr Modell aus.

   

   Sie werden aufgefordert, Ihren Schlüssel, Den Ziel-URI und den Namen Ihres Azure-Modells aus dem Azure AI Foundry-Portal einzugeben. Diese Informationen finden Sie unter "Meine Ressourcen " und " Modelle" und "Endpunkte " im Foundry-Portal.

4. Geben Sie die Details ein, beginnend mit dem Schlüssel:

   

5. Wählen Sie JavaScript oder TypeScript aus, wählen Sie den Standardordner aus, und geben Sie einen Anwendungsnamen ein, um den Projektstammordner am Standardspeicherort zu speichern.

   Ihr neues Projekt wird geöffnet.

   

6. Bestätigen Sie, dass Sie mit der Erweiterung angemeldet sind, indem Sie das Microsoft 365-Logo auf der Symbolleiste in Visual Studio Code auswählen. Stellen Sie sicher, dass Sie beim Mandanten angemeldet sind, mit dem Sie eine Verbindung herstellen möchten.

   

Debuggen und Testen Ihres Agents im Agents-Playground

Sie können Ihren Code mit dem neuen Microsoft 365 Agent Playground debuggen und testen, der im Toolkit verfügbar ist. Der Playground hilft Ihnen, Ihren Code einfach zu debuggen und ohne einen vollständigen Bereitstellungszyklus durchlaufen zu müssen.

1. Wählen Sie Debuggen in Microsoft 365 Agents Playground aus.

   Wenn Sie den Playground auswählen, warten Sie kurz, während Ihr lokaler Computer mit den erforderlichen Komponenten vorbereitet wird. Die Vorbereitung dauert ein paar Minuten.

   

2. Während Sie auf die Bereitstellung warten, überprüfen Sie Ihren Ordner auf den Code und sehen Sie ihn sich an, um sich mit ihm vertraut zu machen.

   

3. Sobald der Playground zum Debuggen und Testen geladen wurde, wird ein Browser geöffnet, und Sie können mit Ihrem Agenten im Playground interagieren. Wenn Sie dem Leitfaden gefolgt und die vorgefertigte Vorlage mit LangChain und Azure AI Foundry verwendet haben, können Sie fragen: "Was ist das Wetter in {Ihrem Standort} morgen?" Der Agent antwortet mit einer adaptiven Karte mit dem Wetter unter Verwendung Ihres ausgewählten AI-Diensts.

   

   

Debuggen und Testen Ihres Agents in Microsoft 365 Copilot

Wenn Sie die Tests lokal im Agents Playground abschließen, können Sie den Bot in den Azure Bot Service bereitstellen und für den Microsoft-365-Copilot-Kanal konfigurieren. Stellen Sie sicher, dass Sie bei einem Mandanten angemeldet sind, der Zugriff auf Microsoft 365 Copilot hat.

1. Ändern Sie das Debugziel in Copilot, damit Sie mit Microsoft 365 Copilot debuggen können. Wählen Sie F5 oder Debuggen aus, um zu testen. Es dauert ein paar Minuten Vorbereitung, um den Agent microsoft 365 zur Verfügung zu stellen. Im Hintergrund erstellt das Toolkit einen App-Registrierungsdatensatz und einen Bot Service-Datensatz im Azure Bot Service und stellt Ihr Projekt zusammen mit einem Manifest in Ihrem Mandantenkonto bereit.

   

2. Sobald Sie dies tun, sollten Microsoft 365 Copilot geladen werden und Sie sollten bei Bedarf direkt in Microsoft 365 Copilot Fragen stellen, Haltepunkte hinzufügen und debuggen können.

   

Zusammenfassung

Sie haben jetzt Folgendes erfolgreich getan:

• Ein neues Microsoft 365 Agents-Projekt und -Agent mit dem Agents Toolkit gestartet
• Testen des Agents lokal mithilfe des Microsoft 365 Agents Playground
• Zum Debuggen wurde der Agent direkt im Microsoft 365-Kanal bereitgestellt.