Schnellstartanleitung: Einrichten und Ausführen des Beispiel-Agents JavaScript Claude Agent SDK

Von Bedeutung

Sie müssen Teil des Frontier-Vorschauversionsprogramms sein, um Vorabzugriff auf Microsoft Agent 365 zu erhalten. Frontier verbindet Sie direkt mit den neuesten KI-Innovationen von Microsoft. Frontier-Vorschauversionen unterliegen den bestehenden Vorschauversionsbedingungen Ihrer Kundenvereinbarungen. Da sich diese Funktionen noch in der Entwicklung befinden, können sich ihre Verfügbarkeit und Merkmale im Laufe der Zeit ändern.

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

Voraussetzungen

• 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)
• Claude Agent SDK-Pakete und ein Anthropic-API-Schlüssel
• Agents Playground
• Zugriff auf npm (Node Package Manager) Installationen
• Zugriff auf GitHub
• Ein vorhandenes KI-Agent-Projekt. In dieser Schnellstartanleitung wird ein Claude-Beispiel-Agent aus dem Microsoft 365 Agents Toolkit Gallery (ATK in VS Code) verwendet.
• A365 CLI
• Agent-Identitätsauthentifizierung

Einrichten des Claude + 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 Gerüst für das Claude + Node.js Beispiel lokal, damit Sie es später konfigurieren und ausführen können. Die folgenden Screenshots zeigen, was Sie zu erwarten haben, während Sie den Ablauf durchlaufen.

1. Öffnen Sie in Visual Studio Code das Extensions Panel (Ctrl+Shift+X), suchen Sie nach Microsoft 365 Agents Toolkit, und wählen Sie Install aus.

   

2. Öffnen Sie die Ansicht M365 Agents Toolkit von der VS Code-Aktivitätsleiste, und wählen Sie Beispiele anzeigen aus.

   

3. Wählen Sie das Beispiel Claude + Node.js aus, wählen Sie Erstellen aus, und wählen (oder erstellen) Sie den Ordner, in dem das Projektgerüst angelegt werden soll (z. B. C:\A365-Ignite-Demo). Das Toolkit erstellt einen Unterordner (z. B. sample_agent) und öffnet ihn in VS Code.

   

Nachdem Sie das Grundgerüst angelegt haben, haben Sie ein ausführbares Projekt. Die nächsten Schritte werden im neuen Beispielordner ausgeführt.

Abhängigkeiten installieren und die Umgebung konfigurieren

Das generierte package.json listet bereits die Pakete auf, die die Beispielanforderungen erfüllen, installieren Sie also alles in einem Durchgang:

npm install

Überprüfen Sie nach der Installation die Projektbuilds und -ausführungen durch Starten des Dev-Servers.

npm run dev

Der Dev-Server überwacht den im Beispiel konfigurierten Port (standardmäßig localhost:3978) und ist bereit, Anforderungen vom Agents Playground oder der CLI zu akzeptieren.

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

Sie können MCP-Server mithilfe der A365-Entwicklungsbefehle in der CLI erkunden und verwalten. Das @microsoft/agents-a365-tooling-extensions-claude-Paket integriert diese MCP-Server in Ihren Claude-Orchestrator, damit das Agent SDK Microsoft 365 Tools im Einklang mit den in Ihrem Claude-Agent-Plan definierten Fähigkeiten aufrufen kann.

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
}

Beobachtbarkeit

Dieser Codeausschnitt zeigt die minimalen Änderungen, die erforderlich sind, um Beobachtbarkeit im Beispiel zu ermöglichen. Aktualisieren Sie src/client.ts, um das Agent 365 Observability SDK zu initialisieren und jeden Agent-Aufruf in einem InferenceScope zu umschließen, sodass Eingaben, Ausgaben und Metadaten automatisch erfasst werden können.

import {
  InferenceOperationType,
  InferenceScope,
  ObservabilityManager
} from '@microsoft/agents-a365-observability';

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 Code stellt die vollständige Einrichtung der Beobachtbarkeit dar, die für das Node.js + Claude-Beispiel erforderlich ist. Ersetzen Sie die Platzhaltermetadaten durch die Werte, die Sie bereits für den Agent konfiguriert haben. 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 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.

Übersicht über Testschritte

• Fügen Sie Ihren ANTHROPIC_API_KEY und die Modelleinstellungen zu einer .env-Datei hinzu, damit das Beispiel mit Claude kommunizieren 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.

Weitere Informationen zum Testen

Ihren Agenten 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 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 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. 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