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 OpenAI-Modell aus dem Microsoft Foundry-Portal. Sie benötigen die folgenden Daten zum Modell:

  • Name
  • Ziel-URI
  • Wichtig

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

Neues Projekt erstellen

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.

1. Öffnen Sie in Visual Studio Code das Microsoft 365 Agents Toolkit-Erweiterungsbereich, indem Sie auf der Randleiste das Symbol Microsoft 365 Agents auswählen.

2. Um ein neues Agentprojekt zu erstellen, wählen Sie "Neuen Agent/App erstellen" aus. 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.

1. Um mit dem Erstellen eines Agents mit dem Agents SDK zu beginnen, wählen Sie Custom Engine-Agent aus:

Erstellen eines neuen Agents

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.

Sie haben zwei Vorlagen, aus denen Sie auswählen können:

• Basic Custom Engine Agent
• Wetter-Agent.

Der grundlegende benutzerdefinierte Modul-Agent ist ein Agent ohne vordefinierte Komponenten. Sie müssen einen KI-Orchestrator wie Semantischer Kernel oder LangChain und Ihr Wissen hinzufügen, damit der Agent nützlich sein kann.

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

Sie werden aufgefordert, einen LLM-Dienst auszuwählen.

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

   

   Sie werden aufgefordert, ihren Key, Target-URI und den Name Ihres Azure OpenAI-Modells aus dem Microsoft Foundry-Portal abzurufen. Diese Informationen finden Sie unter "Meine Ressourcen " und " Modelle" und "Endpunkte " im Foundry-Portal.

2. Geben Sie die Modelldetails ein, beginnend mit dem Azure OpenAI-Dienstschlüssel.

   

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

   

4. 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 folgen und die vorgefertigte Vorlage mit LangChain und Azure AI Foundry verwenden, können Sie "Was ist das Wetter in {Ihrem Standort} morgen?" fragen. Der Agent antwortet mit einer adaptiven Karte, die das Wetter über Ihren ausgewählten AI-Dienst anzeigt.

   

   

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 auf der Tastatur oder debuggen aus, um zu testen. Es dauert ein paar Minuten Vorbereitung, um den Agent microsoft 365 zur Verfügung zu stellen. Hinter den Kulissen erstellt das Toolkit eine App-Registrierung und Azure Bot Service Datensatz in Azure Bot Service und stellt Ihr Projekt zusammen mit einem Manifest für Ihren Mandanten bereit.

   

2. Nachdem Ihr Projekt bereitgestellt wurde, sollten Sie Microsoft 365 Copilot Laden sehen und Fragen stellen, Haltepunkte hinzufügen und nach Bedarf direkt in Microsoft 365 Copilot debuggen können:

   

Summe

Sie haben jetzt erfolgreich:

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