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

I denne artikel lærer du, hvordan du opretter et nyt Agents SDK JavaScript-projekt i Visual Studio ved hjælp af Microsoft 365 Agents Toolkit.

Forudsætninger

• Installér Agents Toolkit-udvidelsen til Visual Studio Code.

• Du skal bruge en Azure OpenAI-model fra Microsoft Foundry-portalen. Du skal bruge følgende data om modellen:

  • Navn
  • Destinations URI-adresse
  • Nøgle

  Lær, hvordan du tilføjer og konfigurerer modeller i Azure AI Foundry Models

Opret et nyt projekt

Agents Toolkit tilbyder en projektskabelon, der hjælper dig med at komme i gang med at bygge en agent. Du kan starte fra en skabelon i værktøjssættet eller fra eksempler i Agents SDK.

1. I Visual Studio Code åbner du sidepanelet i Microsoft 365 Agentværktøjskasse-udvidelsen ved at vælge Microsoft 365 Agents-ikonet i sidebaren.

2. For at bygge et nyt agentprojekt, vælg Opret en ny agent/app. Du kan starte fra en skabelon i værktøjssættet eller fra eksempler i Agents SDK. Denne guide beskriver, hvordan man starter med Agents Toolkit.

1. For at komme i gang med at bygge en agent med Agents SDK, vælg Custom Engine Agent:

Opret en ny agent

Når du har valgt custom engine agent som mulighed, bliver du ledt gennem en række trin for at tilføje dine egne AI-tjenester.

Du har to skabeloner at vælge imellem:

• Grundlæggende Custom Engine-agent
• Vejragent.

Den grundlæggende custom engine-agent er en agent uden noget forudbygget. Du skal tilføje en AI-organisator, såsom Semantic Kernel eller LangChain, og din viden, for at agenten kan være nyttig.

1. I dette eksempel skal du vælge Vejragent for at oprette en agent, der bruger LangChain og Azure AI Foundry, afhængigt af hvilket sprog du har valgt.

Du bliver bedt om at vælge en LLM-tjeneste.

1. Vælg Azure OpenAI til din model.

   

   Du bliver bedt om at indtaste din nøgle, mål-URI og navnet på din Azure OpenAI-model fra Microsoft Foundry-portalen. Du kan finde disse oplysninger under Mine aktiver og Modeller og endpoints i Foundry-portalen.

2. Indtast modeldetaljerne, først Azure OpenAI Service-nøglen.

   

3. Vælg JavaScript eller TypeScript, vælg Standardmappe, og angiv et Programnavn for at gemme din projektrodsmappe i standardplaceringen.

   Dit nye projekt er nu åbnet.

   

4. Bekræft, at du er logget ind via udvidelsen ved at vælge Microsoft 365-logoet på værktøjslinjen i Visual Studio Code. Sørg for, at du er logget ind på den lejer, du ønsker at forbinde til.

   

Fejlfind og test din agent i Agents Playground

Du kan fejlfinde og teste din kode med den nye Microsoft 365 Agent Playground, som findes i værktøjssættet. Playground hjælper dig med nemt at fejlfinde din kode uden at skulle igennem en fuld udrulningscyklus.

1. Vælg Debug i Microsoft 365 Agents Playground.

   Når du vælger Playground, skal du vente et øjeblik, mens din lokale maskine forberedes med de nødvendige komponenter. Forberedelsen tager et par minutter.

   

2. Mens du venter på udrulningen, tjek din mappe for koden og gennemgå den for at blive fortrolig med den.

   

3. Når Agents Playground til fejlfinding og test er færdig med at indlæse, åbner en browser, og du er klar til at interagere med din agent i Agents Playground. Hvis du følger guiden og bruger den foruddefinerede skabelon med LangChain og Azure AI Foundry, kan du spørge "Hvordan er vejret i {din placering} i morgen?" Agenten svarer med et adaptivt kort med vejret og bruger din valgte AI-tjeneste.

   

   

Fejlfind og test din agent i Microsoft 365 Copilot

Når du er færdig med at teste lokalt i Agents Playground, kan du udrulle til Azure Bot Service og konfigurere til Microsoft 365 Copilot-kanalen. Sørg for, at du er logget ind på en lejer, der har adgang til Microsoft 365 Copilot.

1. Skift debug-målet til Copilot, så du kan fejlfinde i Microsoft 365 Copilot. Vælg F5 på tastaturet eller Fejlfind for at teste. Det tager et par minutters forberedelse at gøre agenten tilgængelig for Microsoft 365. Bag kulisserne opretter Agents Toolkit en app-registrering og en Azure Bot Service-registrering i Azure Bot Service og udruller dit projekt til din lejer sammen med et manifest.

   

2. Når dit projekt er udrullet, bør du kunne se Microsoft 365 Copilot åbnes og være i stand til at stille spørgsmål, tilføje breakpoints og fejlfinde efter behov direkte i Microsoft 365 Copilot:

   

Opsamling

Du har nu fuldført:

• Startede et nyt Microsoft 365 Agents-projekt og agent ved brug af Agents Toolkit
• Testede agenten lokalt ved hjælp af Microsoft 365 Agents Playground
• Udrulte agenten direkte til fejlfinding i Microsoft 365-kanalen