Lag JavaScript-agenter i Visual Studio Code med Microsoft 365 Agents Toolkit

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

Forutsetning

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

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

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

  Finn ut hvordan du legger til og konfigurerer modeller i Azure AI Foundry-modeller

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.

1. I Visual Studio Code åpner du sidepanelet for utvidelsen Microsoft 365 Agents Toolkit ved å klikke på ikonet for Microsoft 365-agenter i sidepanelet.

2. Du bygger et nytt agentprosjekt ved å velge Opprett en ny agent/app. Du kan begynne fra en mal i verktøysettet eller fra eksempler i SDK for agenter. Denne veiledningen viser hvordan du kommer i gang med Agents Toolkit.

1. Du kommer i gang med å bygge en agent med SDK for agenter ved å velge Egendefinert motoragent:

Opprett en ny agent

Når egendefinert motoragent er valgt som alternativ, blir du veiledet gjennom en rekke instrukser for å legge til dine egne KI-tjenester.

Du har to maler du kan velge mellom:

• Grunnleggende egendefinert motoragent
• Væragent.

Den grunnleggende egendefinerte motoragenten er en agent uten noe forhåndsbygd. Du må legge til en KI-iverksetter, for eksempel Semantic Kernel eller LangChain, og kunnskapen din for at agenten skal være nyttig.

1. I dette eksemplet velger du Væragent for å lage en agent som bruker LangChain og Azure AI Foundry, avhengig av hvilket språk du har valgt.

Du blir bedt om å velge en LLM-tjeneste.

1. Velg Azure OpenAI som modell.

   

   Du blir bedt om å oppgi Nøkkel, Mål-URI og Navn for Azure OpenAI-modellen fra Microsoft Foundry-portalen. Du finner disse opplysningene under Mine ressurser og Modeller og endepunkter i Foundry-portalen.

2. Skriv inn modelldetaljene, der du begynner med nøkkelen for Azure OpenAI-tjenesten.

   

3. Velg JavaScript eller TypeScript, velg Standardmappe, og skriv inn et Programnavn for å lagre prosjektets rotmappe i standardplasseringen.

   Det nye prosjektet åpnes.

   

4. Bekreft at du er logget på med utvidelsen ved å velge Microsoft 365-logoen på verktøylinjen i Visual Studio Code. Pass på at du er logget på leietakeren du vil koble til.

   

Feilsøk og test agenten lokalt på lekeplassen for agenter

Du kan feilsøke og teste koden med den nye lekeplassen for Microsoft 365-agenter som er tilgjengelig i verktøysettet. Lekeplassen hjelper deg å feilsøke koden enkelt og uten at du må gå gjennom en komplett distribusjonssyklus.

1. Velg Feilsøk på lekeplassen for Microsoft 365-agenter.

   Når du velger lekeplassen, venter du en liten stund mens den forbereder den lokale maskinen med de nødvendige komponentene. Forberedelsene tar noen minutter.

   

2. Mens du venter på distribusjonen, ser du i mappen etter koden, og ser gjennom den for å gjøre deg kjent med den.

   

3. Når lekeplassen for feilsøking og testing er ferdig lastet, åpnes en nettleser, og du er klar til å samhandle med agenten din ved hjelp av lekeplassen. Hvis du følger veiledningen og bruker den forhåndsbygde malen med LangChain og Azure AI Foundry, kan du stille spørsmålet: «Hva er værmeldingen for {stedet ditt} i morgen?» Agenten svarer med et dynamisk kort med værmeldingen og bruker den valgte KI-tjenesten din.

   

   

Feilsøk og test agenten din i Microsoft 365 Copilot

Når du er ferdig å teste lokalt på lekeplassen for agenter, kan du distribuere i Azure Bot Service og konfigurere for Microsoft 365 Copilot-kanalen. Sørg for at du er logget på en leietaker som har tilgang til Microsoft 365 Copilot.

1. Endre feilsøkingsmålet til Copilot, slik at du kan feilsøke ved hjelp av Microsoft 365 Copilot. Trykk på F5 på tastaturet, eller velg Feilsøk for å teste. Det tar noen minutter med forberedelser for å gjøre agenten tilgjengelig for Microsoft 365. I bakgrunnen oppretter verktøysettet en appregistrering og en Azure Bot Service-oppføring i Azure Bot Service, og distribuerer prosjektet ditt i leietakeren din sammen med et manifest.

   

2. Når prosjektet ditt er distribuert, skal du se at Microsoft 365 Copilot starter, og du kan stille spørsmål, legge til stoppunkter og feilsøke etter behov – direkte i Microsoft 365 Copilot:

   

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
• Distribuert agenten for feilsøking direkte i Microsoft 365-kanalen