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

I denne artikkelen lærer du hvordan du oppretter et nytt Agents SDK JavaScript-prosjekt i Visual Studio ved hjelp av Microsoft 365 Agents Toolkit.

Forutsetninger

• 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 Models

Opprette et nytt prosjekt

Agents Toolkit tilbyr en prosjektmal som hjelper deg med å komme i gang med å bygge en agent. Du kan starte fra en mal i verktøysettet eller fra eksempler i Agents SDK.

1. I Visual Studio Code åpner du sidepanelet for Microsoft 365 Agents Toolkit-utvidelse ved å velge ikonet Microsoft 365 Agents på sidepanelet.

2. Hvis du vil bygge et nytt agentprosjekt, velger du Opprett en ny agent/app. Du kan starte fra en mal i verktøysettet eller fra eksempler i Agents SDK. Denne veiledningen dekker å starte med Agents Toolkit.

1. Hvis du vil begynne med å bygge en agent med Agents SDK, velger du Custom Engine Agent:

Opprett en ny agent

Med egendefinert motoragent valgt som et alternativ, blir du veiledet ned en rekke ledetekster for å legge til dine egne AI-tjenester.

Du har to maler å velge mellom:

• Grunnleggende egendefinert systemagent
• Væragent

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

Velg mal

1. I dette eksemplet velger du Weather Agent for å opprette 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 for modellen din.

   Velg Azure OpenAI for LLM

   Du blir bedt om Key, Target URI og Name for Azure OpenAI-modellen fra Microsoft Foundry-portalen. Du finner disse informasjonsdelene under Mine aktiva og Modeller og endepunkter i Foundry-portalen.

2. Skriv inn modelldetaljene, og begynn med Azure OpenAI-tjenestenøkkelen.

   

3. Velg JavaScript eller TypeScript, velg standardmappen, og skriv inn et programnavn for å lagre prosjektrotmappen på standardplasseringen.

   Det nye prosjektet åpnes.

   

4. Bekreft at du er logget på ved hjelp av utvidelsen ved å velge Microsoft 365-logoen på verktøylinjen i Visual Studio Code. Sørg for at du er logget inn på leieren du vil koble til.

   

Feilsøke og teste agenten din i Agents Playground

Du kan feilsøke og teste koden med den nye Microsoft 365 Agent Playground tilgjengelig i verktøysettet. Lekeplassen hjelper deg med å feilsøke koden enkelt og uten å måtte gå gjennom en fullstendig distribusjonssyklus.

1. Velg Feilsøking i Microsoft 365 Agents Playground.

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

   

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

   

3. Når lekeplassen for feilsøking og testing er ferdig med innlastingen, å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 spørre «Hva er været i {din plassering} i morgen?» Agenten svarer med et adaptivt kort med været ved hjelp av den valgte AI-tjenesten.

   

   

Feilsøke og teste agenten din i Microsoft 365 Copilot

Når du er ferdig med testingen lokalt i Agents Playground, kan du distribuere til Azure Bot Service og konfigurere for Microsoft 365 Copilot-kanalen. Sørg for at du er logget på en leier 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. Velg F5 på tastaturet eller Feilsøking for å teste. Det tar noen minutter med forberedelser for å gjøre agenten tilgjengelig for Microsoft 365. Bak kulissene oppretter verktøysettet en appregistrering og Azure Bot Service oppføring i Azure Bot Service, og distribuerer prosjektet til leieren sammen med et manifest.

   

2. Når prosjektet er distribuert, skal du se Microsoft 365 Copilot laste inn og kunne stille spørsmål, legge til breakpoints og feilsøke, etter behov, direkte i Microsoft 365 Copilot:

   

Sammendrag

Du har nå fullført:

• Startet et nytt Microsoft 365 Agents-prosjekt og -agent ved hjelp av Agents Toolkit
• Testet agenten lokalt ved hjelp av Microsoft 365 Agents Playground
• Distribuerte agenten for feilsøking direkte i Microsoft 365-kanalen