Schnellstartanleitung: Einrichten und Ausführen des Beispiel-Agents JavaScript LangChain

In dieser Schnellstartanleitung werden Sie schrittweise durch die Einrichtung eines funktionierenden JavaScript LangChain-Agents mithilfe von Agent 365-Tools, -Benachrichtigungen, -Beobachtbarkeit und durch das Testen des Agents mit Agents Playground und Teams geführt.

Prerequisites

Wenn Sie Visual Studio Code verwenden möchten, müssen Sie .NET installiert haben. (.NET 8.0 wird empfohlen.)
Node.js (Version 18 oder höher)
LangChain
Agents Playground
Der Zugriff auf Npm (Node Paket-Manager) wird mit NodeJS installiert.
Zugriff auf GitHub
Ein vorhandenes KI-Agent-Projekt. Dieser Schnellstart verwendet einen Agent365-Beispielagenten aus Microsoft 365 Agent Toolkit, der auch als ATK in VS Code bezeichnet wird.
A365 CLI
Agent-Identitätsauthentifizierung

Einrichten des LangChain + Node.js-Beispiels aus dem Microsoft 365 Agents Toolkit

Um alles vorbereiten zu können, installieren Sie das Microsoft 365 Agents Toolkit in VS Code, öffnen Sie den Beispielkatalog, und erstellen Sie ein Gerüst für das LangChain + Node.js-Beispiel lokal, damit Sie es später konfigurieren und ausführen können. Die folgenden Screenshots zeigen, was erwartungsgemäß angezeigt werden sollte.

Öffnen Sie Visual Studio Code, öffnen Sie dann Extensions Panel Ctrl+Shift+X.
Geben Sie in der Suchleiste Agents Toolkit ein.
Sie sollten das Ergebnis wie hier im Screenshot dargestellt sehen.
Wählen Sie Microsoft 365 Agents Toolkit aus.
Wählen Sie Installieren aus.

VS Code zeigt die Detailansicht der Erweiterung an, ähnlich wie folgt:
Nach der Installation wird das Symbol M365 Agents Toolkit in der linken Navigationsleiste angezeigt.
Wählen Sie es aus, um den Willkommensbildschirm zu öffnen.

Nun sollten Optionen wie Deklarativen Agent erstellen, Neuen Agent/App erstellen und Beispiele anzeigen angezeigt werden, wie hier dargestellt:
Wählen Sie Beispiele anzeigen aus.
Scrollen Sie in der Beispielliste, um das Beispiel LangChain + Node.js-Agent zu finden.
Wählen Sie es aus.

Es werden zwei Optionen angezeigt: "Erstellen" (lokal ein Gerüst erstellen) oder "Auf GitHub anzeigen".
Wählen Sie Erstellen aus.
Wenn Sie dazu aufgefordert werden, wählen Sie einen Ordner auf Ihrem Computer aus, in dem das Beispiel generiert werden soll. Beispiel: C:\A365-Ignite-Demo

Das Toolkit erstellt ein Grundgerüst für das Beispiel LangChain + Node.js in einem Unterordner (z. B. sample_agent) und öffnet es dann automatisch in VS Code.

Nach Abschluss der Gerüsterstellung verfügen Sie jetzt über ein voll funktionsfähiges LangChain + Node.js-Agent-Projekt auf Ihrem Computer.

Installieren der erforderlichen Agent 365-Pakete

Öffnen Sie vor dem Ausführen des Beispiels package.json in Ihrem Projekt, und vergewissern Sie sich, dass alle erforderlichen Agent 365- und Agent-Framework-Abhängigkeiten aufgelistet sind. Das vom Microsoft 365 Agents Toolkit generierte Beispiel enthält bereits diese Einträge.

Nachdem Sie package.json überprüft haben, installieren Sie alles, indem Sie Folgendes ausführen:

npm install

Dadurch werden alle Agent 365-Bibliotheken, Agent-Framework-Abhängigkeiten, Hostingkomponenten und alle anderen im Beispiel definierten Abhängigkeiten abgerufen. Überprüfen Sie nach der Installation die Projektbuilds und -ausführungen durch Starten des Dev-Servers.

npm run dev

Fügen Sie die Microsoft 365-Tools (MCP-Server) hinzu.

Sie können MCP-Server mithilfe der A365-Entwicklungsbefehle in der CLI erkunden und verwalten.

Wenn Sie mit Microsoft MCP-Tools arbeiten, können Sie:

Ermitteln, welche MCP-Server zur Verwendung verfügbar sind
Einen oder mehrere MCP-Server zur Konfiguration Ihres Agents hinzufügen
Die derzeit konfigurierten MCP-Server überprüfen
MCP-Server entfernen, die Sie nicht mehr benötigen

Nachdem MCP-Server hinzugefügt wurden, wird das Toolmanifest Ihres Agents erweitert, um Einträge wie folgt einzuschließen:

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

Erfahren Sie, wie Sie Tools hinzufügen und verwalten

Benachrichtigungsabonnement und -verwaltung

Der Beispiel-Agent abonniert alle Agent 365-Benachrichtigungen mithilfe von onAgentNotification("*") und leitet sie an einen einzelnen Handler weiter. Dieser Handler ermöglicht es dem Agent, auf Hintergrund- oder Systemereignisse zu reagieren, nicht nur auf direkte Benutzernachrichten.

Erfahren Sie, wie Sie Agents benachrichtigen

Der folgende Code zeigt, wie die Benachrichtigung in der Datei agent.ts konfiguriert ist.

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
}

Observability

Important

Dieses Beispiel verwendet das veraltete Agent 365 Observability SDK. Verwenden Sie dieses Muster nicht für eine neue Observabilitätsintegration. Verwenden Sie stattdessen die Microsoft OpenTelemetry Distro.

Der folgende Ausschnitt initialisiert das veraltete Agent 365 Observability SDK und umschließt jeden Agentenaufruf mit einem InferenceScope, sodass Eingaben, Ausgaben und Metadaten automatisch erfasst werden können.

Der folgende Code zeigt ein optimiertes Beispiel für Beobachtbarkeit in der Datei 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;

}

Dieser Ausschnitt zeigt das veraltete Agent 365 Observability SDK-Muster, das vom Node.js + LangChain-Beispiel verwendet wird. Für die vollständige Anleitung zur Einrichtung und Migration siehe die veraltete SDK-Dokumentation.

Testen Sie Ihren Agenten

Legen Sie die erforderlichen Umgebungsvariablen fest, wählen Sie einen Authentifizierungsmodus aus, und starten Sie den Agent lokal. Sie können alles end-to-End mit Agents Playground testen, ohne einen Microsoft 365 Mandanten zu benötigen, es sei denn, Sie möchten den Agent veröffentlichen und in Apps wie Teams oder Outlook verwenden. Ausführliche Schritte finden Sie unter Weitere Informationen zum Testen zum Konfigurieren der Tests des Agents mit Agents Playground.

Übersicht über Testschritte

Fügen Sie Ihre API-Schlüssel und die Modelleinstellungen zu einer .env-Datei hinzu, damit das Beispiel mit einem LLM sprechen kann.
Wählen Sie Ihren Authentifizierungsmodus aus. Für die lokale Entwicklung unterstützt das Beispiel die agentische Authentifizierung mithilfe von Werten, die aus Ihrem Agent-Blueprint erstellt wurden.
Starten Sie den Agenten lokal, wodurch er für Tools wie den Agents Playground zugänglich wird.
Verwenden Sie Agents Playground, um Meldungen, Tools und Benachrichtigungen zu testen, ohne einen Mandanten einzurichten oder etwas bereitzustellen.
Wenn Sie für das reale Verhalten bereit sind, veröffentlichen Sie einen Microsoft 365 Mandanten, und testen Sie den Agent in Teams, Outlook oder anderen Microsoft 365 Oberflächen.

Ihren Agenten veröffentlichen

Wenn Ihr Agent für echte Microsoft 365-Erfahrungen wie Teams-Chats, Outlook-Nachrichten, Word @mentions bereit ist, veröffentlichen Sie ihn in einem Microsoft 365-Mandanten. Der CLI-Befehl publish Agent 365 übernimmt die Verpackung: Er aktualisiert dein Manifest, bündelt alles und lädt den Agenten ins Microsoft-Verwaltungszentrum hoch.

Überprüfen Sie während der Veröffentlichung den Namen, die Beschreibung, die Symbole und die Version des Agents und passen Sie diese an, bevor Sie den Upload abschließen. Nach der Veröffentlichung wird Ihr Agent im Mandanten registriert und zur Installation verfügbar.

Important

Nach der Veröffentlichung deines Agenten musst du den Agenten-Blueprint im Developer Portal konfigurieren, bevor du Instanzen erstellst. Lernen Sie, wie Sie den Agenten-Blueprint im Developer Portal konfigurieren

Hier können Sie veröffentlichte Agenten anzeigen: https://admin.cloud.microsoft/#/agents/all

Erfahren Sie mehr über den vollständigen Workflow und Schritt-für-Schritt-Anleitungen

Feedback

War diese Seite hilfreich?

Zuletzt aktualisiert um 2026-10-13