Serveur d’outils mock

Important

Vous devez faire partie du programme Frontier en version préliminaire pour obtenir un accès anticipé à Microsoft Agent 365. Frontier vous connecte directement aux dernières innovations d’IA de Microsoft. Les versions préliminaires Frontier sont soumises aux conditions existantes de vos contrats clients qui régissent les versions préliminaires. Comme ces fonctionnalités sont encore en cours de développement, leur disponibilité et leurs capacités peuvent évoluer au fil du temps.

La CLI Agent 365 inclut un serveur d’outils fictifs pour les tests et le développement. Ce serveur simule les interactions MCP (Model Context Protocol), vous permettant de tester localement les capacités de votre agent sans avoir besoin d’implémentations réelles du serveur. Il ne couvre aucune autre fonctionnalité de l’Agent 365.

Avantages d’utiliser le serveur simulé

Le serveur mock offre les avantages suivants pour le développement local et les tests :

Développement hors ligne : Testez votre agent sans connexion internet ni dépendances externes.
Tests cohérents : Recevez des réponses prévisibles pour tester des cas limites.
Débogage : Voir toutes les requêtes et réponses en temps réel
Itération rapide : pas besoin d’attendre des appels API externes ni de configurer des environnements de test complexes.

Prerequisites

Avant d’utiliser le serveur d’outils de simulation, assurez-vous de respecter les prérequis suivants :

CLI de l’agent 365 installé - Utilisez le serveur de mock tooling à côté de la CLI. Consultez les instructions d’installation de l’Agent 365 CLI.
- Vous devriez avoir au moins la version 1.1.25-preview pour utiliser le serveur d’outils de simulation.
Projet d’agent d’exemple - Un projet d’agent local qui peut se connecter aux serveurs MCP. Consultez notre dépôtAgent365-Samples pour les points de départ disponibles.

Démarrez le serveur d’outils mocks

Utilisez la commande a365 develop-mock-tooling-server pour lancer le serveur d’outils mock.

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

# Short alias
a365 develop mts

Options de commande

Le serveur d’outils mock prend en charge les options suivantes :

Choix	Descriptif	Par défaut
`-p, --port <port>`	Numéro de port pour le serveur fictif	5309
`-v, --verbose`	Activez la journalisation commentée	false
`-?, -h, --help`	Afficher les informations d’aide et d’utilisation	-
`-bg`	Faites tourner le serveur sur un nouveau terminal	-

Examples

Les exemples suivants montrent des méthodes courantes pour démarrer le serveur d’outils de simulation :

Commencez par les paramètres par défaut :

a365 develop start-mock-tooling-server

Commencez par un portage personnalisé :

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

Commencez par un journal de longue durée :

a365 develop start-mock-tooling-server -v

Lorsque vous exécutez la commande, elle :

Démarre le serveur fictif sur le port spécifié (par défaut : localhost :5309).
Affiche les journaux du serveur et les requêtes entrantes dans le terminal.

Utilisez un serveur simulé avec des agents d’exemple

Pour connecter votre agent d’échantillonnage au serveur d’outils de simulation :

Étape 1 : Démarrez le serveur simulé

a365 develop start-mock-tooling-server

Le serveur démarre et affiche une sortie similaire à l’exemple suivant :

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

Étape 2 : Configurez votre agent

Réglez la variable d’environnement MCP_PLATFORM_ENDPOINT dans votre agent d’échantillonnage pour qu’elle pointe vers le serveur mock :

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Si vous utilisez un port personnalisé, remplacez-le 5309 par le numéro de port choisi.

Étape 3 : Faites tourner votre agent

Commencez votre agent d’échantillonnage comme d’habitude. L’agent se connecte désormais au serveur fictif au lieu des véritables serveurs MCP.

Étape 4 : Surveillez l’activité des serveurs

Le terminal serveur fictif affiche :

Demandes entrantes de votre agent
Des réponses moquées sont renvoyées
État de la connexion et erreurs (le cas échéant)

Exemples de journaux serveur :

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

Arrêter le serveur simulé

Pour arrêter le serveur fictif, utilisez Ctrl+C dans le terminal où le serveur tourne, ou fermez la fenêtre du terminal.

Résolution des problèmes

Cette section contient des informations sur la manière de résoudre les problèmes courants avec le serveur d’outils de simulation.

Conseil / Astuce

Le Guide de dépannage de l’Agent 365 contient des recommandations générales de dépannage, les meilleures pratiques et des liens vers du contenu de dépannage pour chaque étape du cycle de développement de l’Agent 365.

Le serveur simulé ne démarre pas

Symptôme:Error: Address already in use

Cause : Un autre processus utilise déjà le port par défaut (5309) ou le port que vous avez spécifié.

Solution:

Utilise un autre port.

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

Ou arrêtez le processus via le port et réessayez.

L’agent ne peut pas se connecter au serveur simulé

Symptôme: Les journaux des agents montrent des erreurs de connexion ou des délais d’attente lors de la tentative d’accès au serveur fictif.

Cause :

Le serveur fictif ne tourne pas.
Variable d’environnement incorrecte MCP_PLATFORM_ENDPOINT .
Problèmes de pare-feu ou de configuration réseau.