Opprett .NET-agenter i Visual Studio med verktøysettet for Microsoft 365-agenter

I denne artikkelen lærer du hvordan du oppretter et nytt Agents SDK .NET-prosjekt i Visual Studio ved å bruke Microsoft 365 Agents Toolkit.

Forutsetning

• Installer utvidelsen Verktøysett for agenter for Visual Studio for Visual Studio.

• En Azure OpenAI-modell fra Azure AI Foundry-portalen. Du trenger følgende data om modellen:

  • Navn
  • Mål-URI
  • Nøkkel

Opprette et nytt prosjekt

Agents Toolkit har en prosjektmal som hjelper deg å komme i gang med å bygge en agent. Du kan begynne fra en mal i verktøysettet eller fra eksempler i SDK for agenter. Dette dokumentet fokuserer på de tilgjengelige malene i Agents Toolkit. Det finnes ulike maler og alternativer tilgjengelig for å opprette Agents SDK-prosjekter med Agents Toolkit. Denne veiledningen fokuserer på å opprette en væragent ved bruk av Semantic Kernel og Azure AI Foundry.

1. Åpne Visual Studio, og velg Opprett et nytt prosjekt. Søk etter "agent" for å finne nye maler ved hjelp av Microsoft 365 Agents Toolkit og Agents SDK. Velg Microsoft 365 Agents>Neste.

   

   En dialogboks dukker opp slik at du kan navngi agenten. Du kan også endre plassering og løsningsnavn hvis du vil.

2. Velg Opprett når du er ferdig

   

   Du kan velge mellom flere alternativer som verktøysettet tilbyr for å opprette agenter.

3. I denne veiledningen, velg eksempelet Væragent>Neste for å bruke SDK for Microsoft 365-agenter. Dette forhåndsbygde eksempelet implementerer Semantic Kernel for orkestrering med Azure kunstig intelligens Foundry eller Azure OpenAI-modeller. Du kan også bruke Empty agent-eksempelet hvis du vil komme i gang uten modell eller iverksetter.

   

   

   Et dialogvindu ber deg om å velge en LLM-tjeneste.

4. Velg Azure OpenAI for denne gjennomgangen.

   Denne informasjonen finnes i Azure kunstig intelligens Foundry under Modeller og endepunkter.

   

5. Fyll inn de nødvendige inndataene: Azure OpenAI tjenestenøkkel, Azure OpenAI endepunkt og Azure OpenAI distribusjonsnavn.

6. Velg Opprett. Verktøysettet oppretter prosjektet basert på en mal for deg.

7. Om kort tid bør du ha et nytt prosjekt opprettet ved hjelp av Agents SDK.

   

Test agenten i Microsoft 365 på lekeplassen for agenter

For å komme i gang kan du teste lokalt ved å bruke Microsoft 365 Agents Playground i Toolkit.

For å starte testingen, angi debug-mål i prosjektet ditt til å være Microsoft 365 Agents Playground.

Playground åpnes i et nytt nettleservindu med localhost, og viser Playground som er klar til testing. Begynn å sende meldinger til agenten din for å teste dens oppførsel.

Feilsøk og test agenten din i Microsoft Teams eller Microsoft 365 Copilot

Du kan også velge Microsoft Teams eller Microsoft 365 Copilot som feilsøkingsmål.

1. Velg ett av feilsøkingsalternativene som feilsøkingsmål fra listen over mål.

   

   Det tar noen øyeblikk å bytte til Microsoft Teams. Du blir bedt om å legge til agenten din i Teams-klienten som åpnes.

   

2. Velg Legg til. Et varslingspanel vises, som indikerer at agenten er lagt til vellykket.

   

3. Velg Åpne på din nye agent for å åpne den i Teams. Du kan stille spørsmål til agenten din, direkte i Teams. Du kan angi at stoppunkter skal fungere gjennom feilsøking av opplevelsen når det er nødvendig.

   

Sammendrag

Du har nå fullført følgende:

• Opprettet et nytt prosjekt for Microsoft 365-agenter og en ny agent med Agents Toolkit
• Testet agenten lokalt med lekeplassen for Microsoft 365-agenter
• Distribuerte agenten for feilsøking direkte i Teams- eller Microsoft 365-kanalen