Snabbstart: Konfigurera och köra JavaScript LangChain-exempelagenten

I den här snabbstarten går du igenom hur du konfigurerar en fungerande JavaScript LangChain-agent med hjälp av Agent 365-verktyg, meddelanden, observerbarhet och testning av agenten med agenterna Playground och Teams.

Förutsättningar

Om du planerar att använda Visual Studio Code måste du ha .NET installerat. TLS 1.2 rekommenderas.
Node.js version 20 eller senare
LangChain
Testplats för agenter
Åtkomst till Npm (Node Package Manager) installeras med NodeJS
Åtkomst till GitHub
Ett befintligt AI Agent-projekt. Den här snabbstarten använder en Agent 365-exempelagent från Microsoft 365-agentverktyget , även kallat ATK i VS Code.
A365 CLI
Agentidentitetsautentisering

Konfigurera Exemplet LangChain + Node.js från Microsoft 365 Agents Toolkit

För att göra allt klart installerar du Microsoft 365 Agents Toolkit i VS Code, öppnar exempelgalleriet och skapar ett exempel på LangChain + Node.js lokalt så att du kan konfigurera och köra det senare. Följande skärmbilder visar vad du bör förvänta dig att se när du går.

Öppna Visual Studio Code och öppna sedan panelen Tillägg Ctrl+Skift+X.
I sökfältet skriver du "Agents Toolkit".
Du bör se resultatet som visas på skärmbilden här:
Välj Microsoft 365 Agents Toolkit.
Välj Installera.

VS Code visar tilläggsinformationsvyn som liknar:
När M365 Agents Toolkit-ikonen har installerats visas den i det vänstra navigeringsfältet.
Välj den för att öppna välkomstupplevelsen.

Du bör nu se alternativ som Skapa en deklarativ agent, Skapa en ny agent/app och Visa exempel, som du ser här:
Välj Visa exempel.
I exempellistan bläddrar du för att hitta exemplet LangChain + Node.js agent.
Välj den.

Du ser två alternativ: Skapa (autogenerera lokalt) eller Visa på GitHub.
Välj Skapa.
När du uppmanas till det väljer du en mapp på datorn där exemplet ska genereras. Till exempel: C:\A365-Ignite-Demo

Verktygslådan skapar exemplet LangChain + Node.js i en undermapp (till exempel sample_agent) och öppnar det sedan automatiskt i VS Code.

När byggnadsställningen är klar har du nu ett fullt fungerande LangChain + Node.js agentprojekt på datorn

Installera nödvändiga Agent 365-paket

Innan du kör exemplet öppnar package.json du i projektet och bekräftar att alla nödvändiga agent-365- och agentramverksberoenden visas. Exemplet som genereras av Microsoft 365 Agents Toolkit innehåller redan dessa poster.

När du har granskat package.jsoninstallerar du allt genom att köra:

npm install

Detta hämtar alla Agent 365-bibliotek, Beroenden för agentramverk, värdkomponenter och andra beroenden som definieras i exemplet. Efter installationen kontrollerar du att projektet bygger och körs genom att starta utvecklingsservern

npm run dev

Lägg till Microsoft 365-verktyg (MCP-servrar)

Du kan utforska och hantera MCP-servrar med hjälp av a365 utveckla kommandon i CLI.

När du arbetar med MCP-servrar kan du:

Identifiera vilka MCP-servrar som är tillgängliga för användning
Lägga till en eller flera MCP-servrar i agentens konfiguration
Granska de MCP-servrar som för närvarande är konfigurerade
Ta bort MCP-servrar som du inte längre behöver

När MCP-servrar har lagts till expanderas agentens verktygsmanifest till att omfatta poster som liknar:

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

Lär dig hur du lägger till och hanterar verktyg

Meddelandeprenumeration och hantering

Exempelagenten prenumererar på alla Agent 365-meddelanden med och onAgentNotification("*") dirigerar dem till en enda hanterare. Med den här hanteraren kan agenten reagera på bakgrunds- eller systemhändelser, inte bara direktanvändarmeddelanden.

Lär dig hur du meddelar agenter

Följande kod visar hur meddelandet konfigureras 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
}

Överskådlighet

Det här kodfragmentet visar de minimala ändringar som krävs för att möjliggöra observerbarhet i exemplet. Den initierar Agent 365 Observability SDK och omsluter varje agentanrop i så InferenceScope att indata, utdata och metadata kan samlas in automatiskt.

Följande kod visar ett förenklat exempel 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;

}

Det här kodfragmentet visar kärnmönstret för att aktivera observerbarhet i exemplet Node.js + LangChain. Fullständig observabilitetskonfiguration finns i Läs mer om observerbarhet

Testa din agent

Ange nödvändiga miljövariabler, välj ett autentiseringsläge och starta agenten lokalt. Du kan testa allt från slutpunkt till slutpunkt med Agents Playground utan att behöva en Microsoft 365-klientorganisation om du inte vill publicera agenten och använda den i appar som Teams eller Outlook. Se detaljerade steg i Läs mer om testning för att konfigurera testning av agenten med agenten playground.

Översikt över testningssteg

Lägg till dina API-nycklar och modellinställningar i en .env fil så att exemplet kan kommunicera med en LLM.
Välj autentiseringsläge. För lokal utveckling stöder exemplet Agentic Auth med värden som skapats från din agentritning.
Starta agenten lokalt, vilket gör den tillgänglig för verktyg som Agents Playground.
Använd Agents Playground för att testa meddelanden, verktyg och meddelanden utan att konfigurera en klientorganisation eller distribuera något.
När du är redo för verkligt beteende publicerar du en Microsoft 365-klientorganisation och testar agenten i Teams, Outlook eller andra Microsoft 365-ytor.

Publicera agenten

När din agent är redo för faktiska Microsoft 365-funktioner som Teams-chattar, Outlook-meddelanden, Word @mentions, publicerar du den till en Microsoft 365-klientorganisation. Kommandot Agent 365 CLI publish hanterar paketeringen: det uppdaterar ditt manifest, paketerar allt och laddar upp agenten till Microsoft Admin Center.

Under publiceringen granskar och anpassar du agentens namn, beskrivning, ikoner och version innan du slutför uppladdningen. När agenten har publicerats blir den identifierad och kan installeras i klientorganisationen.

Du kan visa publicerade agenter här: https://admin.cloud.microsoft/#/agents/all

Läs mer om det fullständiga arbetsflödet och stegvisa instruktioner

Feedback

Var den här sidan hjälpsam?

Last updated on 2025-12-02