.JavaScript-agenttien luominen Visual Studio Codessa Microsoft 365 -agenttien työkalupaketin avulla

Tässä artikkelissa opit, miten voit luoda uuden Agents SDK JavaScript-projektin Visual Studiossa Microsoft 365 -agenttien työkalupaketin avulla.

Edellytykset

Luo uusi projekti

Agents Toolkit tarjoaa projektipohjan, jonka avulla pääset alkuun agentin rakentamisessa. Voit aloittaa työkalupakin mallista tai Agenttien SDK:n esimerkeistä.

Muistiinpano

Seuraava menettely toimii tällä hetkellä vain JavaScriptille ja TypeScriptille. Python-tuki on suunnitteilla.

  1. Avaa Visual Studio Codessa Microsoft 365 Agents Toolkit -laajennuksen sivupaneeli valitsemalla sivupalkista Microsoft 365 Agents -kuvake.

  2. Uuden agenttiprojektin rakentamiseksi valitse Luo uusi agentti/sovellus. Voit aloittaa työkalupakin mallista tai Agenttien SDK:n esimerkeistä. Tämä opas opastaa alkuun Agents Toolkitin kanssa.

Agents Toolkit -laajennuksen aloitussivu

  1. Aloita agentin rakentaminen Agenttien SDK:lla valitsemalla Mukautetun moduulin agentti:

Valitse luotava agenttityyppi

Uuden agentin luominen

Kun valitset mukautetun moduulin agentin, järjestelmä ohjaa sinut vaihe vaiheelta lisäämään omat tekoälypalvelusi.

Voit valita kahdesta mallipohjasta:

  • Mukautetun moduulin perusagentti
  • Sääagentti.

Mukautetun moduulin perusagentti on agentti, jossa ei ole mitään valmiiksi rakennettua. Jotta agentti olisi hyödyllinen, sinun täytyy lisätä tekoälyorkestroija, kuten Semantic Kernel tai LangChain, sekä tietoja.

Mallin valitseminen

  1. Valitse tässä esimerkissä Sääagentti luodaksesi agentin, joka käyttää LangChainia ja Azure AI Foundrya, valitsemastasi kielestä riippuen.

Sinua pyydetään valitsemaan LLM-palvelu.

  1. Valitse mallillesi Azure OpenAI.

    Valitse LLM-palveluksi Azure OpenAI

    Sinua pyydetään syöttämään Azure OpenAI -mallisi avain, kohde-URI ja nimi Microsoft Foundry -portaalista. Nämä tiedot löydät Foundry-portaalin kohdasta Omat resurssit ja Mallit ja päätepisteet.

  2. Syötä mallin tiedot, alkaen Azure OpenAI -palveluavaimesta.

    Syötä Azure OpenAI -avain tunnistautumista varten

  3. Valitse JavaScript tai TypeScript, valitse Oletuskansio ja anna Sovelluksen nimi tallentaaksesi projektin juurikansion oletussijaintiin.

    Uusi projektisi avautuu.

    Uuden projektin tiedostonäkymä

  4. Varmista, että olet kirjautunut sisään laajennuksen kautta valitsemalla Microsoft 365 -logo työkalupalkista Visual Studio Codessa. Varmista, että olet kirjautuneena siihen vuokraajaan, johon haluat yhdistää.

    Näytä tilit ja kirjaudu sisään

Agentin vianetsintä ja testaaminen agenttien testausalustalla

Voit tehdä vianetsintää ja testata koodiasi uudessa Microsoft 365 -agenttitestausalustalla, joka on saatavilla työkalupakissa. Agenttitestausalusta auttaa sinua tekemään vianetsintää koodillesi helposti ilman, että sinun tarvitsee käydä läpi koko käyttöönottoprosessia.

  1. Valitse Agentin vianetsintä Microsoft 365 -agenttitestausalustalla.

    Kun valitset testausalustan, odota hetki, kun tarvittavat komponentit asennetaan paikalliselle koneellesi. Valmistelu kestää muutaman minuutin.

    Valitse Agentin vianetsintä Microsoft 365 -agenttitestausalustalla

  2. Kun odotat käyttöönottoa, tarkista projektikansiostasi koodi ja tutustu siihen.

    Generoidun mallipohjakoodin tarkastelu

  3. Kun vianetsintä- ja testausalusta on latautunut, selain avautuu ja olet valmis vuorovaikutukseen agenttisi kanssa testausalustalla. Jos noudatat ohjetta ja käytät valmista mallipohjaa LangChainin ja Azure AI Foundryn kanssa, voit kysyä "Millainen sää on huomenna {paikkakunnallasi}?" Agentti vastaa mukautuvalla kortilla, jossa näkyy sää, käyttäen valitsemaasi tekoälypalvelua.

    Tee sovellukselle vianetsintää Teams-sovellustestaustyökalussa

    Teams-sovellustestaustyökalu ja mukautuva kortti chatissa

Tee agentille vianetsintää ja testaa sitä Microsoft 365 Copilotissa

Kun olet saanut agentin testattua paikallisesti agenttitestausalustalla, voit julkaista agentin Azure Bot Service -palveluun ja määrittää sen Microsoft 365 Copilot -kanavalle. Varmista, että olet kirjautuneena vuokraajaan, jolla on pääsy Microsoft 365 Copilotiin.

  1. Vaihda vianetsintäkohteeksi Copilot, jotta voit tehdä vianetsintää Microsoft 365 Copilotilla. Valitse F5 näppäimistöltä tai Suorita vianetsintä jotta voit testata. Agentin tuominen saataville Microsoft 365:een vie muutaman minuutin. Taustalla työkalupakki luo sovellusrekisteröinnin ja Azure Bot Service -tietueen Azure Bot Servicessa ja julkaisee projektisi vuokraajaasi yhdessä luettelotiedoston kanssa.

    Valitse vianetsintä Copilotissa (Edge)

  2. Kun projektisi on otettu käyttöön, näet Microsoft 365 Copilotin latautuvan ja voit esittää kysymyksiä, lisätä keskeytyspisteitä sekä tehdä vianetsintää tarvittaessa suoraan Microsoft 365 Copilotissa:

    Testaus ja virheenkorjaus Microsoft 365 Copilotissa

Yhteenveto

Olet nyt onnistuneesti:

  • Aloittanut uuden Microsoft 365 Agents -projektin ja agentin Agents Toolkitin avulla
  • Testannut agenttia paikallisesti Microsoft 365 -agenttitestausalustalla
  • Ottanut agentin käyttöön suoraan Microsoft 365 -kanavassa virheenkorjausta varten