Hurtigstart: Konfigurere og kjøre eksempelagenten JavaScript LangChain

I denne hurtigstarten går du gjennom konfigurasjonen av en fungerende JavaScript LangChain-agent ved hjelp av Agent 365-verktøy, varsler, observerbarhet og testing av agenten ved hjelp av Agents Playground og Teams.

Forutsetning

Hvis du planlegger å bruke Visual Studio Code, må du ha .NET installert. (.NET 8.0 anbefales.)
Node.js (versjon 18 eller nyere)
LangChain
Agentlekeplass
Tilgang til NPM (Node Pakkebehandling) er installert med NodeJS
Tilgang til GitHub
Et eksisterende AI Agent-prosjekt. Denne hurtigstarten bruker en agent 365-eksempelagent fra Microsoft 365-agentverktøysettet også kjent som ATK i VS Code.
A365 CLI
Godkjenning av agentidentitet

Konfigurer LangChain + Node.js-eksemplet fra Microsoft 365 Agents Toolkit

Hvis du vil gjøre alt klart, installerer du Microsoft 365 Agents Toolkit i VS Code, åpner eksempelgalleriet og stillaser LangChain + Node.js eksempel lokalt, slik at du kan konfigurere og kjøre det senere. Følgende skjermbilder viser hva du bør forvente å se mens du går.

Åpne Visual Studio Code, og åpne deretter utvidelsespanelet CTRL+SKIFT+X.
Skriv inn «Agents Toolkit» i søkefeltet.
Du skal se resultatet som vises i skjermbildet her:
Velg Microsoft 365 Agents Toolkit.
Velg Installer.

VS Code viser utvidelsesdetaljene som ligner på:
Når det er installert, vises M365 Agents Toolkit-ikonet i venstre navigasjonsfelt.
Velg den for å åpne velkomstopplevelsen.

Nå skal du se alternativer som Bygg en deklarativ agent, Opprett en ny agent/app og Vis eksempler, som vist her:
Velg Vis eksempler.
Bla i eksempellisten for å finne eksempelet på LangChain + Node.js agent.
Velg den.

Du vil se to valg: Opprett (stillas lokalt) eller Vis på GitHub.
Velg Opprett.
Når du blir bedt om det, velger du en mappe på maskinen der eksemplet skal genereres. Eksempel: C:\A365-Ignite-Demo

Verktøysettet stillas langchain + Node.js eksempel i en undermappe (for eksempel sample_agent) og deretter åpne den automatisk i VS Code.

Når stillaset er fullført, har du nå et fullt funksjonelt LangChain + Node.js agentprosjekt på maskinen

Installer nødvendige Agent 365-pakker

Før du kjører eksemplet, åpner package.json du i prosjektet og bekrefter at alle nødvendige agent 365- og Agent-rammeverkavhengigheter er oppført. Eksemplet som genereres av Microsoft 365 Agents Toolkit, inneholder allerede disse oppføringene.

Når du har gjennomgått package.json, installerer du alt ved å kjøre:

npm install

Dette trekker ned alle Agent 365-biblioteker, agentrammeverkavhengigheter, vertskomponenter og eventuelle andre avhengigheter som er definert i eksemplet. Etter installasjonen må du kontrollere prosjektbyggene og kjøres ved å starte utviklingsserveren

npm run dev

Legg til Microsoft 365-verktøy (MCP-servere)

Du kan utforske og administrere MCP-servere ved hjelp av a365-utviklingskommandoene i CLI.

Når du arbeider med MCP-servere, kan du:

Finn ut hvilke MCP-servere som er tilgjengelige for bruk
Legg til én eller flere MCP-servere i agentens konfigurasjon
Se gjennom MCP-serverne som er konfigurert for øyeblikket
Fjern MCP-servere du ikke trenger lenger

Når MCP-servere er lagt til, utvides agentens verktøymanifest for å inkludere oppføringer som ligner på:

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

Lær hvordan du legger til og administrerer verktøy

Varslingsabonnement og -håndtering

Eksempelagenten abonnerer på alle Agent 365-varsler ved hjelp av onAgentNotification("*") og ruter dem til én enkelt behandler. Med denne behandleren kan agenten reagere på bakgrunns- eller systemhendelser, ikke bare direkte brukermeldinger.

Finn ut hvordan du varsler agenter

Følgende kode viser hvordan varsling er konfigurert i agent.ts filen.

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
}

Observerbarhet

Denne kodesnutten viser de minimale endringene som kreves for å muliggjøre observerbarhet i eksemplet. Den initialiserer Agent 365 Observability SDK og bryter hver agent-aktivering i en InferenceScope slik inndata, utdata og metadata kan registreres automatisk.

Følgende kode viser et strømlinjeformet eksempel på client.ts observerbarhet i filen.

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;

}

Denne kodesnutten viser kjernemønsteret for å muliggjøre observerbarhet i Node.js + LangChain-eksempelet. Se Mer informasjon om overholdelse av den fullstendige observabilitetskonfigurasjonen

Test agenten

Angi de nødvendige miljøvariablene, velg en godkjenningsmodus, og start agenten lokalt. Du kan teste alt fra ende til ende med Agents Playground uten å trenge en Microsoft 365-leier med mindre du vil publisere agenten og bruke den i apper som Teams eller Outlook. Se for detaljerte trinn i Mer informasjon om testing for å konfigurere testing av agenten med agentlekeplass.

Oversikt over testingstrinn

Legg til API-tastene og modellinnstillingene i en .env fil, slik at eksemplet kan snakke med en LLM.
Velg godkjenningsmodus. For lokal utvikling støtter eksemplet Agentic Auth ved hjelp av verdier som er opprettet fra Agent Blueprint.
Start agenten lokalt, som eksponerer den for verktøy som Agents Playground.
Bruk Agents Playground til å teste meldinger, verktøy og varsler uten å konfigurere en leier eller distribuere noe.
Når du er klar for ekte atferd, publiserer du en Microsoft 365-leier og tester agenten i Teams, Outlook eller andre Microsoft 365-overflater.

Publisere agenten din

Når agenten er klar for faktiske Microsoft 365-opplevelser som Teams-chatter, Outlook-meldinger, Word @mentions, publiserer du det til en Microsoft 365-leier. Agent 365 CLI-kommandoen publish håndterer emballasjen: Den oppdaterer manifestet ditt, samler alt og laster opp agenten til administrasjonssenteret for Microsoft.

Under publisering, se gjennom og tilpass agentens navn, beskrivelse, ikoner og versjon før du fullfører opplastingen. Når den er publisert, blir agenten din synlig og installerbar i leieren.

Du kan vise publiserte agenter her: https://admin.cloud.microsoft/#/agents/all

Mer informasjon om hele arbeidsflyten og trinnvise instruksjoner

Tilbakemeldinger

Var denne siden nyttig?

Last updated on 2025-12-02