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

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

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. Dieses Dokument konzentriert sich auf die Vorlagen, die im Agents-Toolkit verfügbar sind.

1. Um ein neues Agentprojekt zu erstellen, öffnen Sie Visual Studio, und wählen Sie "Neues Projekt erstellen" aus. Suchen Sie nach "Agent", um neue Vorlagen mithilfe des Microsoft 365 Agent Toolkits und des Agents SDK Zu suchen, wählen Sie "Microsoft 365 Agents>Next" aus.

   

   Ein Dialogfeld wird angezeigt, damit Sie den Agent benennen können. Sie können auch den Speicherort und Lösungsnamen ändern, wenn Sie möchten.

2. Wenn Sie fertig sind, wählen Sie "Weiter" aus.

   

3. Im nächsten Dialogfeld werden Sie aufgefordert, den Agenttyp auszuwählen. Sie können einige verschiedene Optionen auswählen, die das Toolkit zum Erstellen von Agents bereitstellt. Um das Microsoft 365 Agents SDK zu verwenden, sollten Sie das Wetter-Agent-Beispiel auswählen. In diesem vordefinierten Beispiel wird der semantische Kernel für die Orchestrierung mit Azure AI Foundry- oder Azure OpenAI-Modellen implementiert. Sie können auch das Beispiel Leerer Agent verwenden, wenn Sie ohne Modell- oder Orchestrator-Einrichtung loslegen möchten.

   

   

4. Wählen Sie für diese exemplarische Vorgehensweise Azure AI Foundry aus, und füllen Sie die erforderlichen Eingaben aus. Einschließlich des Schlüssels, des Endpunkts und des Bereitstellungsnamens. Diese Informationen finden Sie in Azure AI Foundry unter "Modelle und Endpunkte".

   

5. Wählen Sie "Erstellen" aus. Das Toolkit erstellt das Projekt aus einer Vorlage für Sie, die bereit für die ersten Schritte ist.

6. In kurzer Zeit sollten Sie ein neues Projekt erstellt haben, das das Agents SDK verwendet.

   

Testen Ihres Agents im Microsoft 365 Agents Playground

Um zu beginnen, können Sie lokal testen, indem Sie den Microsoft 365 Agents Playground im Toolkit verwenden.

Um mit dem Testen zu beginnen, wählen Sie im Projekt Microsoft 365 Agents Playground als Debugziel aus.

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 mit dem Senden von Nachrichten an Ihren Agenten, um das Verhalten zu testen.

Debuggen und Testen Ihres Agents in Microsoft Teams oder Microsoft 365 Copilot

Sie können auch das Debugziel so festlegen, dass es sich direkt in Microsoft Teams oder Microsoft 365 Copilot befindet.

1. Wählen Sie eine der Debugoptionen als Debugziel aus der Liste der Ziele aus.

   

   Es dauert nur wenige Augenblicke, um zu Microsoft Teams zu gelangen. Sie werden aufgefordert, Ihren Agent im teams-Client hinzuzufügen, der geöffnet wird.

   

2. Wählen Sie "Hinzufügen " aus. Daraufhin wird ein Benachrichtigungsbereich angezeigt, der angibt, dass der Agent erfolgreich hinzugefügt wurde.

   

3. Wählen Sie Öffnen auf Ihrem neuen Agenten aus, um es in Teams zu öffnen. Sie können Ihrem Agenten direkt in Teams Fragen stellen. Sie können Haltepunkte festlegen, um bei Bedarf das Debuggen Ihrer Erfahrung zu durchlaufen.

   

Zusammenfassung

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
• Der Agent wurde direkt in den Teams- oder Microsoft 365-Kanal zum Debuggen bereitgestellt.