.NET-agenten in Visual Studio maken met de toolkit voor Microsoft 365-agenten

In dit artikel leert u hoe u een nieuw Agents SDK .NET-project in Visual Studio maakt, met behulp van de Microsoft 365 Agents Toolkit.

Vereisten

• Installeer de Agents Toolkit-extensie voor Visual Studio voor Visual Studio.

• Een Azure OpenAI-model uit de Azure AI Foundry-portal. U hebt de volgende gegevens over het model nodig:

  • Naam
  • Doel-URI
  • Sleutel

Een nieuw project maken

De Agents Toolkit biedt een projectsjabloon waarmee u aan de slag kunt gaan met het maken van een agent. U kunt starten vanuit een sjabloon in de toolkit of vanuit voorbeelden in de Agents SDK. Dit document richt zich op de sjablonen die beschikbaar zijn in de Agents Toolkit. Er zijn verschillende sjablonen en opties beschikbaar om Agents SDK-projecten met de toolkit te maken. Deze stapsgewijze handleiding richt zich op het creëren van een Weeragent met behulp van Semantic Kernel en Azure AI Foundry.

1. Open Visual Studio en selecteer Een nieuw project maken. Zoek naar "agent" om nieuwe sjablonen te vinden die gebruikmaken van de Microsoft 365 Agents Toolkit en Agents SDK. Selecteer Microsoft 365 Agents>Volgende.

   

   Er verschijnt een dialoogvenster waarin u de agent een naam kunt geven. U kunt ook de locatie en de naam van de oplossing wijzigen, desgewenst.

2. Wanneer u gereed bent, selecteert u Maken

   

   U kunt een paar verschillende opties kiezen die de toolkit biedt voor het creëren van agenten.

3. Selecteer voor deze procedure Weeragent>Next om de SDK voor Microsoft 365-agenten te gebruiken. Dit voorgebouwde voorbeeld implementeert Semantic Kernel voor indeling met Azure AI Foundry- of Azure OpenAI-modellen. U kunt ook het Lege agent-voorbeeld gebruiken als u wilt beginnen zonder model of orchestrator.

   

   

   Er verschijnt een dialoogvenster waarin u de LLM-dienst kunt kiezen.

4. Selecteer voor deze procedure scenario Azure OpenAI.

   Deze informatie is te vinden in Azure AI Foundry onder Modellen en eindpunten.

   

5. Vul de vereiste invoer in: Azure OpenAI-servicesleutel, Azure OpenAI-eindpunt en Azure OpenAI-implementatienaam.

6. Selecteer Maken. De toolkit maakt het project voor u aan vanuit een sjabloon.

7. Binnen korte tijd zou u een nieuw project moeten hebben gemaakt met de Agents SDK.

   

Uw agent testen in Microsoft 365 Agents Playground

Om te beginnen kunt u lokaal testen met de Microsoft 365 Agents Playground in de Toolkit.

Om te beginnen met testen, stelt u het debugdoel in uw project in op Microsoft 365 Agents Playground."

De playground wordt geopend zodat u kunt testen in een nieuw browservenster met uw lokale host en toont de playground klaar om te testen. Begin berichten te sturen naar uw agent om het gedrag ervan te testen.

Debug en test uw agent in Microsoft Teams of Microsoft 365 Copilot

U kunt het debugdoel ook direct instellen in Microsoft Teams of Microsoft 365 Copilot.

1. Selecteer een van de debugging-opties als debugdoel uit de lijst met doelen.

   

   Het duurt even om over te schakelen naar Microsoft Teams. U wordt gevraagd uw agent toe te voegen aan de Teams-client die wordt geopend.

   

2. Selecteer Toevoegen. Er verschijnt een meldingspaneel dat aangeeft dat de agent succesvol is toegevoegd.

   

3. Selecteer Openen op uw nieuwe agent om te openen in Teams. U kunt uw agent rechtstreeks in Teams vragen stellen. U kunt onderbrekingspunten zo instellen dat u fouten in uw ervaring kunt opsporen wanneer dat nodig is.

   

Overzicht

U hebt nu het volgende gedaan:

• Ik ben een nieuw Microsoft 365 Agents-project en nieuwe agent gestart met behulp van de Agents Toolkit
• De agent is lokaal getest met behulp van de Microsoft 365 Agents Playground
• Agent rechtstreeks geïmplementeerd voor foutopsporing in het Teams- of Microsoft 365-kanaal