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.

Voraussetzungen

• Wenn Sie beabsichtigen, Visual Studio Code zu verwenden, muss .NET installiert sein. (.NET 8.0 wird empfohlen.)
• Node.js (Version 18 oder höher)
• LangChain
• Agents Playground
• Der Zugriff auf Npm (Node Package Manager) wird mit NodeJS installiert.
• Zugriff auf GitHub
• Ein vorhandenes KI-Agent-Projekt. Diese Schnellstartanleitung verwendet einen Agent 365-Beispiel-Agent aus dem Microsoft 365 Agent-Toolkit, das in VS Code auch als ATK 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 das Grundgerü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.

1. Öffnen Sie Visual Studio Code. Öffnen Sie dann den Bereich Erweiterungen und wählen Sie Strg+Umschalt+X.

2. Geben Sie in der Suchleiste Agents Toolkit ein.
   Das Ergebnis sollte hier im Screenshot angezeigt werden:

   

3. Wählen Sie Microsoft 365 Agents Toolkit aus.

4. Wählen Sie Installieren aus.

   VS Code zeigt die Detailansicht der Erweiterung an, ähnlich wie folgt:

   

5. Nach der Installation wird das Symbol M365 Agents Toolkit in der linken Navigationsleiste angezeigt.

6. 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:

   

7. Wählen Sie Beispiele anzeigen aus.

8. Scrollen Sie in der Beispielliste nach unten bis zum Beispiel-Agent LangChain + Node.js.

9. Wählen Sie ihn aus.

   Es werden zwei Optionen angezeigt: Erstellen (lokales Grundgerüst) oder Auf GitHub anzeigen.

10. Wählen Sie Erstellen.

11. 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 diese Einträge bereits.

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

Hinzufügen von Microsoft 365-Tools (MCP-Server)

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

Beim Arbeiten mit MCP-Servern können Sie Folgendes tun:

• 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
}

Einblick

Dieser Codeausschnitt zeigt die minimalen Änderungen, die erforderlich sind, um Beobachtbarkeit im Beispiel zu ermöglichen. Das Agent 365 Observability SDK wird initialisiert und jeder Agent-Aufruf in einem InferenceScope wird umschlossen, 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 Codeausschnitt zeigt das Kernmuster zur Aktivierung von Beobachtbarkeit im Beispiel Node.js + LangChain. Informationen zur vollständigen Beobachtbarkeitseinrichtung finden Sie unter Weitere Informationen zur Beobachtbarkeit

Ihren Agent testen

Legen Sie die erforderlichen Umgebungsvariablen fest, wählen Sie einen Authentifizierungsmodus aus, und starten Sie den Agent lokal. Sie können alles durchgängig 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 Agent lokal, wodurch er Tools wie Agents Playground verfügbar gemacht wird.
• Verwenden Sie Agents Playground, um Meldungen, Tools und Benachrichtigungen zu testen, ohne einen Mandanten einzurichten oder etwas bereitzustellen.
• Wenn Sie bereit für die Praxis sind, veröffentlichen Sie einen Microsoft 365-Mandanten, und testen Sie den Agent innerhalb von Teams, Outlook oder anderen Microsoft 365-Oberflächen.

Agent veröffentlichen

Wenn Ihr Agent für tatsächliche Microsoft 365-Erlebnisse wie Teams-Diagramme, Outlook-Nachrichten oder Word @mentions bereit ist, veröffentlichen Sie ihn in einem Microsoft 365-Mandanten. Der Agent 365 CLIpublish-Befehl behandelt die Verpackung: Er aktualisiert Ihr Manifest, verpackt alles und lädt den Agent in das Microsoft Admin Center 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 ist Ihr Agent innerhalb des Mandanten auffindbar und installierbar.

Von Bedeutung

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

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

Weitere Informationen über den vollständigen Workflow und schrittweise Anleitungen