Jaa

Pikaopas: JavaScript LangChain -malliagentin määrittäminen ja suorittaminen

Tässä pikaoppaassa käydään läpi toimivan JavaScript LangChain -agentin määrittäminen Agent 365-työkalujen avulla, ilmoitukset, havaittavuus ja agentin testaaminen Agents Playgroundin ja Teamsin avulla.

Edellytykset

  • Jos aiot käyttää Visual Studio Codea, sinulla on oltava .NET asennettuna. (.NET 8.0 on suositus.)
  • Node.js (versio 18 tai uudempi versio)
  • LangChain
  • Agenttien leikkikenttä
  • Npm:n (Node Package Manager) käyttöoikeus asennetaan NodeJS:n avulla
  • Pääsy GitHubiin
  • Aiemmin luotu tekoälyagenttiprojekti. Tässä pikaoppaassa käytetään Agentti 365 -malliagenttia Microsoft 365 -agenttityökalupaketista, joka tunnetaan myös nimellä ATK VS Codessa.
  • A365 CLI
  • Agentin käyttäjätietojen todennus

LangChain + Node.js -mallin määrittäminen Microsoft 365 -agenttityökalupaketista

Saat kaiken valmiiksi asentamalla Microsoft 365 Agent -työkalupaketin VS Codeen, avaamalla mallivalikoiman ja luomalla LangChain + Node.js -mallin paikallisesti, jotta voit määrittää sen ja suorittaa sen myöhemmin. Seuraavissa näyttökuvissa näkyy, mitä sinun pitäisi odottaa näiltäessäsi.

  1. Avaa Visual Studio Code ja avaa sitten Laajennukset-paneeliCtrl+Vaihto+X.

  2. Kirjoita hakupalkkiin "Agents Toolkit".
    Sinun pitäisi nähdä tässä näyttökuvassa näkyvä tulos:

    Näyttökuva Extensions Marketplacen agentteja Toolkit -hausta.

  3. Valitse Microsoft 365 Agentit Toolkit.

  4. Valitse Asenna.

    VS Code näyttää laajennuksen tietonäkymän seuraavasti:

    Näyttökuva Laajennuksen tietosivusta, jossa on Asenna- ja Ota käyttöön -painikkeet.

  5. Asennuksen jälkeen M365 Agents Toolkit -kuvake näkyy vasemmassa siirtymispalkissa.

  6. Valitsemalla sen voit avata tervetulokokemuksen.

    Sinun pitäisi nyt nähdä vaihtoehdot, kuten Deklaratiivisen agentin luominen, Uuden agentin/sovelluksen luominen ja Näytä mallit, kuten tässä:

    Näyttökuva Toolkitin tervetulonäkymästä, jossa on määrittävän agentin luominen, uuden agentin tai sovelluksen luominen ja Näytä mallit -vaihtoehdot.

  7. Valitse Näytä mallit.

  8. Etsi malliluettelosta LangChain + Node.js -agenttimalli.

  9. Valitse se.

    Näet kaksi vaihtoehtoa: Luo (rakenne paikallisesti) tai Näytä GitHubissa.

  10. Valitse Luo.

  11. Valitse pyydettäessä tietokoneessasi kansio, johon näyte luodaan. Esimerkki: C:\A365-Ignite-Demo

    Työkalupakettirakenne muodostaa LangChain + Node.js -mallin alikansioon (kuten sample_agent) ja avaa sen sitten automaattisesti VS Codessa.

    Kun rakenne on valmis, sinulla on nyt täysin toimiva LangChain + Node.js agent -projekti tietokoneessasi

Asenna tarvittavat Agent 365 -paketit

Ennen mallin suorittamista avaa projektissasi - package.json ja varmista, että kaikki tarvittavat Agent 365- ja Agent Framework -riippuvuudet luetellaan. Microsoft 365 -agenttityökalupaketin luoma näyte sisältää jo nämä merkinnät.

Kun olet tarkistanut kohteen package.json, asenna kaikki suorittamalla:

npm install

Tämä hakee kaikki Agent 365 -kirjastot, Agenttikehyksen riippuvuudet, isännöintikomponentit ja muut mallissa määritetyt riippuvuudet. Asennuksen jälkeen voit tarkistaa projektin koontiversiot ja suoritukset käynnistämällä kehityspalvelimen.

npm run dev

Lisää Microsoft 365 -työkaluja (MCP-palvelimet)

Voit tutkia ja hallita MCP-palvelimia komentorivikäyttöliittymän a365-kehityskomennoilla .

Kun käytät MCP-palvelimia, voit tehdä seuraavaa:

  • Selvitä, mitkä MCP-palvelimet ovat käytettävissä
  • Lisää yksi tai useampi MCP-palvelin agenttisi kokoonpanoon
  • Tarkista mcp-palvelimet, jotka on tällä hetkellä määritetty
  • Poista MCP-palvelimet, joita et enää tarvitse

Kun MCP-palvelimet on lisätty, agenttisi työkaluluettelo laajenee sisältämään seuraavanlaisia merkintöjä:

{
   "mcpServers": [
      {
         "mcpServerName": "mcp_MailTools",
         "mcpServerUniqueName": "mcp_MailTools",
         "scope": "McpServers.Mail.All",
         "audience": "api://00001111-aaaa-2222-bbbb-3333cccc4444"
      }
   ]
}

Opi lisäämään ja hallitsemaan työkaluja

Ilmoitusten tilaus ja käsittely

Malliagentti tilaa kaikki Agent 365 -ilmoitukset käyttämällä onAgentNotification("*") ja reitittää ne yksittäiselle käsittelijälle. Tämän käsittelijän avulla agentti voi reagoida tausta- tai järjestelmätapahtumiin, ei pelkästään suoriin käyttäjäviesteihin.

Lue, miten voit ilmoittaa agenteille

Seuraava koodi näyttää, miten ilmoitus määritetään tiedostossa agent.ts .

constructor() {
   super();

   this.onAgentNotification("agents:*", async(context, state, activity) => {

      await this.handleAgentNotificationActivity(context, state, activity);

   });
}

async handleAgentNotificationActivity(context, state, activity)
{
   await context.sendActivity("Received an AgentNotification!");

   // Add custom handling here
}

Näkyvyys

Tämä katkelma näyttää vain ne vähimmäismuutokset, jotka tarvitaan näytteessä havaittavuuden mahdollistamiseen. Se alustaa Agent 365 Observability SDK:n ja rivittää kunkin agentin kutsun, InferenceScope jotta syötteet, tulosteet ja metatiedot voidaan siepata automaattisesti.

Seuraava koodi näyttää virtaviivaistetun havaittavuusesimerkin tiedostossa client.ts .

const sdk = ObservabilityManager.configure(b =>
   b.withService('<service-name>', '<version>')
);

sdk.start();

async invokeAgentWithScope(prompt: string) {

   const scope = InferenceScope.start(
      { 
         operationName: InferenceOperationType.CHAT, 
         model: '<llm-name>' 
      },
      { 
         agentId: '<agent-id>', 
         agentName: '<agent-name>', 
         conversationId: '<conv-id>' 
      },
      { tenantId: '<tenant-id>' }
   );

   const response = await this.invokeAgent(prompt);
   scope?.recordInputMessages([prompt]);
   scope?.recordOutputMessages([response]);
   scope?.recordResponseId(`resp-${Date.now()}`);
   return response;

}

Tämä katkelma näyttää perusmallin, jonka avulla havaittavuus on mahdollista Node.js + LangChain -mallissa. Täydelliset havainnoitavuuden määritykset ovat kohdassa Lisätietoja havaittavuudesta

Agentin testaaminen

Määritä tarvittavat ympäristömuuttujat, valitse todennustila ja käynnistä agentti paikallisesti. Voit testata kaiken loppuun Agent Playgroundin avulla tarvitsematta Microsoft 365 -vuokraajaa, ellet halua julkaista agenttia ja käyttää sitä Teamsin tai Outlookin kaltaisissa sovelluksissa. Katso lisäohjeet kohdasta Lisätietoja testauksesta agentin testauksen määrittämiseksi agenttien leikkikentällä.

Testausvaiheiden yleiskatsaus

  • Lisää ohjelmointirajapinta-avaimet ja malliasetukset tiedostoon, .env jotta malli voi puhua LLM:lle.
  • Valitse todentamistilasi. Paikallisessa kehitystyössä malli tukee Agentic Authia agentti Blueprintistä luotujen arvojen avulla.
  • Käynnistä agentti paikallisesti, jolloin se paljastuu Agentit Playgroundin kaltaisille työkaluille.
  • Agenttien leikkikentän avulla voit testata viestejä, työkaluja ja ilmoituksia määrittämättä vuokraajaa tai ottamalla käyttöön mitään.
  • Kun olet valmis todelliseen toimintaan, julkaise Microsoft 365 -vuokraaja ja testaa agenttia Teamsin, Outlookin tai muiden Microsoft 365 -pintojen sisällä.

Agentin julkaiseminen

Kun agenttisi on valmis todellisiin Microsoft 365 -käyttökokemuksiin, kuten Teams-keskusteluihin, Outlook-viesteihin, Wordiin @mentions, julkaiset sen Microsoft 365 -vuokraajaan. Agent 365 CLI publish -komento käsittelee pakkaukset: se päivittää kokoonpanotiedot, niputtaa kaiken ja lataa agentin Microsoftin hallintakeskukseen.

Tarkista julkaisun aikana agentin nimi, kuvaus, kuvakkeet ja versio sekä mukauta sitä ennen latauksen valmistumista. Julkaisun jälkeen agenttisi on löydettävissä ja asennettavissa vuokraajan sisällä.

Voit tarkastella julkaistuja agentteja täällä: https://admin.cloud.microsoft/#/agents/all

Lue lisätietoja täydellisestä työnkulusta ja vaiheittaiset ohjeet

  • Last updated on