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

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

Voraussetzungen

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

• Sie benötigen ein Azure OpenAI-Modell aus dem Microsoft Foundry-Portal. Sie benötigen folgende Daten über das Modell:

  • Name
  • Ziel-URI
  • Schlüssel

  Erfahren Sie, wie Sie Modelle zu Azure AI Foundry Models hinzufügen und konfigurieren

Neues Projekt erstellen

Das Agents-Toolkit stellt eine Projektvorlage bereit, die Ihnen den Einstieg in die Erstellung eines Agent erleichtert. Sie können mit einer Vorlage aus dem Toolkit oder mit Beispielen aus dem Agents SDK beginnen.

1. Öffnen Sie in Visual Studio Code den Seitenbereich der Microsoft 365-Agents-Toolkit-Erweiterung, indem Sie das Microsoft 365-Agents-Symbol in der Seitenleiste auswählen.

2. Um ein neues Agentenprojekt zu erstellen, wählen Sie Create a New Agent/App aus. Sie können mit einer Vorlage aus dem Toolkit oder mit Beispielen aus dem Agents SDK beginnen. Dieser Leitfaden beschreibt, wie man mit dem Agents Toolkit beginnt.

1. Um mit dem Agents SDK einen Agenten zu erstellen, wählen Sie Custom Engine Agent aus:

Einen neuen Agent erstellen

Nachdem Sie „Custom Engine Agent“ als Option ausgewählt haben, werden Sie durch eine Reihe von Aufforderungen geführt, um Ihre eigenen KI-Dienste hinzuzufügen.

Sie haben zwei Vorlagen zur Auswahl:

• 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, sowie Ihr Wissen hinzufügen, damit der Agent nützlich ist.

1. Wählen Sie in diesem Beispiel Wetter-Agent aus, um einen Agenten zu erstellen, der LangChain und Azure AI Foundry verwendet, abhängig von Ihrer gewählten Sprache.

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

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

   

   Sie werden vom Microsoft Foundry-Portal nach Ihrem Schlüssel, der Ziel-URI und dem Namen Ihres Azure OpenAI-Modells gefragt. Diese Informationen finden Sie unter Meine Assets und Modelle und Endpunkte im Foundry-Portal.

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

   

3. Wählen Sie JavaScript oder TypeScript, wählen Sie den Standardordner und geben Sie einen Anwendungsnamen ein, um Ihren Projekt-Root-Ordner im Standardverzeichnis zu speichern.

   Ihr neues Projekt wird geöffnet.

   

4. Stellen Sie sicher, dass Sie über die Erweiterung angemeldet sind, indem Sie das Microsoft 365-Logo in der Symbolleiste von Visual Studio Code auswählen. Stellen Sie sicher, dass Sie bei dem Mandanten angemeldet sind, mit dem Sie sich verbinden möchten.

   

Agent lokal im Agents-Playground testen und debuggen

Mit dem neuen Microsoft 365 Agent Playground, der im Toolkit enthalten ist, können Sie Ihren Code debuggen und testen. Der Playground hilft Ihnen, Ihren Code einfach zu debuggen und ohne einen kompletten 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, sehen Sie doch einmal in Ihrem Ordner nach, ob der Code bereits vorhanden ist, und sehen Sie ihn sich an, um sich damit vertraut zu machen.

   

3. Sobald der Playground für Debugging und Tests vollständig geladen ist, öffnet sich ein Browser, und Sie können über den Playground mit Ihrem Agenten interagieren. Wenn Sie der Anleitung folgen und die vorgefertigte Vorlage mit LangChain und Azure AI Foundry verwenden, können Sie fragen: „Wie wird das Wetter morgen in {Ihrem Standort} sein?“ Der Agent antwortet mit einer Adaptive Card, die die Wetterdaten anzeigt, wobei der von Ihnen gewählte KI-Dienst zum Einsatz kommt.

   

   

Debuggen und Testen Ihres Agenten in Microsoft 365 Copilot

Wenn Sie das lokale Testen im Agents Playground abgeschlossen haben, können Sie auf Azure Bot Service bereitstellen und für den Microsoft 365 Copilot-Kanal konfigurieren. Stellen Sie sicher, dass Sie in einem Tenant angemeldet sind, der Zugriff auf Microsoft 365 Copilot hat.

1. Stellen Sie das Debug-Ziel auf Copilot um, damit Sie in Microsoft 365 Copilot debuggen können. Drücken Sie F5 auf der Tastatur oder wählen Sie Debug aus, um zu testen. Es dauert ein paar Minuten, bis der Agent Microsoft 365 zur Verfügung gestellt wird. Hinter den Kulissen erstellt das Toolkit eine App-Registrierung und einen Azure Bot Service-Datensatz in Azure Bot Service und stellt Ihr Projekt zusammen mit einem Manifest in Ihrem Mandanten bereit.

   

2. Sobald Ihr Projekt bereitgestellt wurde, sollten Sie sehen, dass Microsoft 365 Copilot geladen wird und Sie direkt in Microsoft 365 Copilot Fragen stellen, Haltepunkte setzen und bei Bedarf debuggen können.

   

Zusammenfassung

Sie haben jetzt Folgendes erfolgreich getan:

• Sie haben erfolgreich ein neues Microsoft 365 Agents-Projekt und einen Agent mit dem Agents Toolkit gestartet
• Sie haben den Agent lokal mit dem Microsoft 365 Agents Playground getestet
• Sie haben den Agent für das Debugging direkt im Microsoft 365 Channel bereitgestellt