.NET-Agents in Visual Studio mit dem Microsoft 365 Agents Toolkit erstellen

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

Voraussetzungen

• Installiere die Agents Toolkit-Erweiterung für Visual Studio für Visual Studio.

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

  • Name
  • Ziel-URI
  • Schlüssel

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. Dieses Dokument konzentriert sich auf die Vorlagen, die im Agents Toolkit verfügbar sind. Es stehen verschiedene Vorlagen und Optionen zur Verfügung, um Agents-SDK-Projekte mit dem Toolkit zu erstellen. Diese exemplarische Vorgehensweise konzentriert sich darauf, einen Wetter-Agent mit Semantischem Kernel und Azure AI Foundry zu erstellen.

1. Öffnen Sie Visual Studio, und wählen Sie Neues Projekt erstellen aus. Suchen Sie nach „agent“, um neue Vorlagen mit dem Microsoft 365-Agents-Toolkit und Agents SDK zu finden. Wählen Sie anschließend Microsoft 365 Agents>Weiter aus.

   

   Es erscheint ein Dialogfeld, in dem Sie den Agent benennen können. Sie können auch den Standort und den Namen der Lösung ändern, wenn Sie möchten.

2. Wählen Sie Erstellen aus, wenn Sie fertig sind

   

   Sie können verschiedene Optionen auswählen, die das Toolkit zur Erstellung von Agenten bietet.

3. Wählen Sie für diese exemplarische Vorgehensweise das Beispiel Wetter Agent>Weiter, um das Microsoft 365 Agents SDK zu verwenden. Dieses vorgefertigte Beispiel implementiert den Semantischen Kernel für die Orchestrierung mit Azure KI Foundry oder Azure OpenAI-Modellen. Sie können auch das Beispiel Leerer Agent verwenden, wenn Sie ohne Modell- oder Orchestrator-Einrichtung loslegen möchten.

   

   

   Ein Dialog fordert Sie auf, den LLM-Service auszuwählen.

4. Wählen Sie für diese exemplarische Vorgehensweise Azure OpenAI aus.

   Diese Informationen finden Sie in Azure AI Foundry unter Models und Endpunkte.

   

5. Geben Sie die erforderlichen Eingaben ein: Azure OpenAI service key, Azure OpenAI endpoint und Azure OpenAI deployment name.

6. Wählen Sie Erstellen aus. Das Toolkit erstellt das Projekt automatisch aus einer Vorlage.

7. Nach kurzer Zeit ist ein neues Projekt mit dem Agents SDK erstellt.

   

Ihren Agent lokal im Microsoft 365 Agents-Playground testen

Zum Einstieg können Sie lokal mit dem Microsoft 365 Agents Playground im Toolkit testen.

Um mit dem Testen zu beginnen, stellen Sie das Debug-Ziel in Ihrem Projekt auf Microsoft 365 Agents Playground.

Der Playground wird geöffnet, um sie in einem neuen Browserfenster mit Ihrem lokalen Host zu testen und zeigt den Playground mit dem Spielbereich an, der zum Testen bereit ist. Beginnen Sie, Ihrem Agent Nachrichten zu senden, um sein Verhalten zu testen.

Führen Sie Tests und Debugging für Ihren Agent in Microsoft Teams oder Microsoft 365 Copilot durch

Sie können das Debug-Ziel auch direkt in Microsoft Teams oder Microsoft 365 Copilot einstellen.

1. Wählen Sie aus der Liste der Ziele eine der Debugging-Optionen als Debug-Ziel aus.

   

   Es dauert ein paar Momente, um zu Microsoft Teams zu wechseln. Sie werden aufgefordert, Ihren Agent im Teams-Client hinzuzufügen.

   

2. Wählen Sie Hinzufügen. Ein Benachrichtigungsfeld erscheint, das anzeigt, dass der Agent erfolgreich hinzugefügt wurde.

   

3. Wählen Sie Öffnen für Ihren neuen Agent, um ihn in Teams zu öffnen. Sie können Ihrem Agent direkt in Teams Fragen stellen. Sie können Haltepunkte festlegen, um bei Bedarf das Debuggen Ihrer Erfahrung zu durchlaufen.

   

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
• Den Agent für das Debugging direkt im Teams- oder Microsoft 365-Kanal bereitgestellt