Mock-Tooling-Server

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.

Die Agent 365 CLI beinhaltet einen Mock-Tooling-Server für Test- und Entwicklungszwecke. Dieser Server simuliert MCP-Serverinteraktionen (Model Context Protocol), sodass Sie die Werkzeugfähigkeiten Ihres Agenten lokal testen können, ohne dass tatsächlich Serverimplementierungen erforderlich sind. Es deckt keine anderen Agent-365-Funktionen ab.

Vorteile der Nutzung des Mock-Servers

Der Mock-Server bietet folgende Vorteile für lokale Entwicklung und Testung:

Offline-Entwicklung: Testen Sie Ihren Agent ohne Internetverbindung oder externe Abhängigkeiten.
Konsistente Tests: Erhalten Sie vorhersehbare Antworten für Tests von Randfällen.
Debugging: Alle Anfragen und Antworten in Echtzeit ansehen
Schnelle Iteration: Kein Warten auf externe API-Aufrufe oder das Einrichten komplexer Testumgebungen.

Voraussetzungen

Bevor Sie den Mock-Tooling-Server nutzen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen:

Agent 365 CLI installiert – Verwenden Sie den Mock-Tooling-Server zusammen mit der CLI. Siehe Agent 365 CLI für Installationsanweisungen.
- Du solltest mindestens Version 1.1.25-Vorschau haben, um den Mock-Tooling-Server zu nutzen.
Beispiel-Agentenprojekt – Ein lokales Agentenprojekt, das sich mit MCP-Servern verbinden kann. Siehe unser Agent365-Samples Repository für verfügbare Startpunkte.

Starte den Mock-Tooling-Server

Verwenden Sie den Befehl a365 develop start-mock-tooling-server, um den Mock-Tooling-Server zu starten.

# Full command
a365 develop start-mock-tooling-server

# Short alias
a365 develop mts

Befehlsoptionen

Der Mock-Tooling-Server unterstützt folgende Optionen:

Option	Description	Standard
`-p, --port <port>`	Portnummer für den Pseudoserver	5309
`-v, --verbose`	Aktivieren der ausführlichen Protokollierung	Falsch
`-?, -h, --help`	Anzeigen von Hilfe- und Nutzungsinformationen	-
`-bg`	Ausführen des Servers auf einem neuen Terminal	-

Examples

Die folgenden Beispiele zeigen gängige Möglichkeiten, den Mock-Tooling-Server zu starten:

Beginnen Sie mit den Standardeinstellungen:

a365 develop start-mock-tooling-server

Beginnen Sie mit einem benutzerdefinierten Port:

a365 develop start-mock-tooling-server -p 8080

Beginnen Sie mit dem Verbose-Logging:

a365 develop start-mock-tooling-server -v

Wenn du den Befehl ausführst, dann:

Startet den Mock-Server auf dem angegebenen Port (Standard: localhost:5309).
Zeigt Serverprotokolle und eingehende Anfragen im Terminal an.

Verwenden Sie den Mock-Server mit Beispielagenten

Um Ihren Sample-Agent mit dem Mock-Tooling-Server zu verbinden:

Schritt 1: Starte den Mock-Server

a365 develop start-mock-tooling-server

Der Server startet und zeigt eine Ausgabe ähnlich wie im folgenden Beispiel an:

info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5309
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.

Schritt 2: Konfigurieren Sie Ihren Agenten

Stelle die Umgebungsvariable in deinem Sample-Agenten so ein, dass sie MCP_PLATFORM_ENDPOINT auf den Mock-Server zeigt:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Wenn du einen benutzerdefinierten Port verwendest, ersetze 5309 sie durch deine gewählte Portnummer.

Schritt 3: Führen Sie Ihren Makler an

Beginnen Sie wie üblich mit Ihrem Musteragenten. Der Agent verbindet sich jetzt mit dem Mock-Server statt mit den echten MCP-Servern.

Schritt 4: Überwachen Sie die Serveraktivität

Das simulierte Serverterminal zeigt an:

Eingehende Anfragen von Ihrem Agenten
Verspottete Antworten werden zurückgeschickt
Verbindungsstatus und Fehler (falls vorhanden)

Beispiel-Serverprotokolle:

info: Microsoft.AspNetCore.Hosting.Diagnostics[1]
      Request starting HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - application/json 351
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[0]
      Executing endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Http.Result.JsonResult[3]
      Writing value of type '<>f__AnonymousType14`3' as Json.
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[1]
      Executed endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Hosting.Diagnostics[2]
      Request finished HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - 200 - application/json;+charset=utf-8 399.1814ms

Stoppen des Mock-Servers

Um den Mock-Server zu stoppen, verwenden Sie Strg+C im Terminal, in dem der Server läuft, oder schließen Sie das Terminalfenster.

Problembehandlung

Dieser Abschnitt enthält Informationen darüber, wie häufige Probleme mit dem Mock-Tooling-Server behoben werden können.

Tipp

Der Agent 365 Troubleshooting Guide enthält übergeordnete Empfehlungen zur Fehlerbehebung, Best Practices und Links zu Inhalten zur Fehlerbehebung für jeden Teil des Entwicklungszyklus von Agent 365.

Mock-Server startet nicht

Symptom:Error: Address already in use

Ursache: Ein anderer Prozess verwendet bereits den Standardport (5309) oder deinen angegebenen Port.

Solution:

Verwende einen anderen Port.

a365 develop start-mock-tooling-server -p 8080

Oder stoppe den Prozess über den Port und versuche es erneut.

Agent kann sich nicht mit dem Mock-Server verbinden

Symptom: Agentenprotokolle zeigen Verbindungsfehler oder Timeouts beim Versuch, den Mock-Server zu erreichen.

Ursache:

Der Mock-Server läuft nicht.
Falsche Umgebungsvariable MCP_PLATFORM_ENDPOINT .
Probleme mit der Firewall- oder Netzwerkkonfiguration.