Skapa .NET-agenter i Visual Studio med verktygslådan för Microsoft 365-agenter

I den här artikeln lär du dig hur du skapar ett nytt Agents SDK .NET-projekt i Visual Studio, med hjälp av Microsoft 365 Agents Toolkit.

Krav

• Installera Agents Toolkit-tillägget för Visual Studio för Visual Studio.

• En Azure OpenAI-modell från Azure AI Foundry-portalen. Du behöver följande data om modellen:

  • Namn
  • Mål-URI
  • Nyckel

Skapa ett nytt projekt

Verktygslådan för Agents erbjuder en projektmall som hjälper dig att komma igång med att skapa en agent. Du kan börja från en mall i verktygslådan eller från exempel i SDK för Agents. Detta dokument fokuserar på mallarna som finns tillgängliga i Agents Toolkit. Det finns olika mallar och alternativ i verktygslådan för att skapa Agents SDK-projekt. Denna genomgång fokuserar på att skapa en väderagent med hjälp av Semantic Kernel och Azure AI Foundry.

1. Öppna Visual Studio och välj Skapa ett nytt projekt. Sök efter "agent" för att hitta nya mallar med Microsoft 365 Agents Toolkit och Agents SDK. Välj Microsoft 365 Agents>Nästa.

   

   En dialogruta visas så att du kan namnge agenten. Du kan också ändra plats och lösningens namn om du vill.

2. När du är klar väljer du Skapa

   

   Du kan välja några olika alternativ som verktygslådan erbjuder för att skapa agenter.

3. För denna genomgång, välj Väderagent>Nästa-exemplet för att använda SDK för Microsoft 365-agenter. Detta fördefinierade exempel implementerar Semantic Kernel för orkestrering med Azure AI Foundry eller Azure OpenAI-modeller. Du kan också använda exemplet Tom agent om du vill komma igång utan en modell eller initierare.

   

   

   En dialogruta ber dig att välja en LLM-tjänst.

4. I den här genomgången väljer du Azure OpenAI.

   Denna information finns i Azure AI Foundry under Modeller och ändpunkter.

   

5. Fyll i de nödvändiga fälten: Azure OpenAI-tjänstenyckel, Azure OpenAI endpoint och Azure OpenAI distributionsnamn.

6. Välj Skapa. Toolkit skapar projektet från en mall åt dig.

7. Inom kort bör du ha ett nytt projekt skapat med hjälp av Agents SDK.

   

Testa din agent i Microsoft 365 Agents Playground

För att komma igång kan du testa lokalt i Microsoft 365 Agents Playground i Toolkit.

För att börja testa, ställ in debug-målet i ditt projekt till Microsoft 365 Agents Playground.

Testplatsen öppnas i ett nytt webbläsarfönster med din lokala värd och visar verktyget redo att testas. Börja skicka meddelanden till din agent för att testa dess beteende.

Felsök och testa din agent i Microsoft Teams eller Microsoft 365 Copilot

Du kan också ställa in felsökningsmålet direkt i Microsoft Teams eller Microsoft 365 Copilot.

1. Välj ett av felsökningsalternativen som felsökningsmål från listan över mål.

   

   Det tar några ögonblick att växla till Microsoft Teams. Du blir ombedd att lägga till din agent i Teams-klienten som öppnas.

   

2. Välj Lägg till. En meddelandepanel visas som indikerar att agenten har lagts till med framgång.

   

3. Välj Öppna på din nya agent för att öppna i Teams. Du kan ställa frågor till din agent direkt i Teams. Du kan sätta upp brytpunkter för att felsöka din upplevelse när det behövs.

   

Översikt

Du har nu lyckats:

• Startade ett nytt Microsoft 365 Agents-projekt och agent med verktygslådan för Agents
• Testade agenten lokalt med Microsoft 365 Agents-testplatsen
• Distribuerade agenten för felsökning direkt i Teams- eller Microsoft 365-kanalen