Serveur d’outils fictifs

Agent 365 CLI inclut un serveur d’outils fictif pour les tests et le développement. Ce serveur simule les interactions du serveur Model Context Protocol (MCP), ce qui vous permet de tester en local les capacités de votre assistant sans recours à des implémentations serveur réelles. Il ne couvre aucune autre fonctionnalité d’Agent 365.

Avantages d’utiliser le serveur simulé

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

Développement hors ligne : testez votre assistant 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.

Configuration requise

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

Agent 365 CLI installé : utilisez le serveur d’outils fictifs ainsi que la CLI. Consultez les instructions d’installation d’Agent 365 CLI.
- Vous devriez avoir au moins la version 1.1.25-version préliminaire pour utiliser le serveur d’outils de simulation.
Exemple de projet d’assistant : un projet d’assistant local qui peut se connecter aux serveurs MCP. Voir notre référentiel Agent365-Exemples pour les points de départ disponibles.

Démarrer le serveur de simulation d’outils

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

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

# Short alias
a365 develop mts

Options de commande

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

Option	Description	Par défaut
`-p, --port <port>`	Numéro de port du serveur de simulation	5309
`-v, --verbose`	Activez la journalisation commentée	false
`-?, -h, --help`	Afficher l’aide et des informations d’utilisation	-
`-bg`	Exécutez le serveur dans un nouveau terminal	-

Examples

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

Démarrer avec les paramètres par défaut :

a365 develop start-mock-tooling-server

Démarrez sur un port personnalisé :

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

Démarrez avec la journalisation détaillée :

a365 develop start-mock-tooling-server -v

Lorsque vous exécutez la commande, elle :

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

Utiliser le serveur simulé avec des assistants d’exemple

Pour connecter votre assistant d’exemple au serveur simulé d’outils :

Étape 1 : démarrer le serveur de simulation

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 : configurer votre assistant

Définissez la variable d’environnement MCP_PLATFORM_ENDPOINT dans votre assistant d’exemple pour qu’elle pointe vers le serveur fictif :

MCP_PLATFORM_ENDPOINT=http://localhost:5309

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

Étape 3 : exécuter votre assistant

Lancez votre exemple d’assistant, comme vous le feriez d’habitude. L’assistant se connecte désormais au serveur fictif au lieu des véritables serveurs MCP.

Étape 4 : surveillez l’activité du serveur

La console du serveur fictif affiche :

Requêtes entrantes provenant de votre assistant
Des réponses fictives sont renvoyées
Statut de connexion et toutes erreurs (le cas échéant)

Exemples de journaux de 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 simulé, utilisez Ctrl+C dans le terminal où le serveur est en cours d’exécution, 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.

Astuce

Le Guide de dépannage 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 fictif 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 :

Utilisez un autre port.

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

Ou terminez le processus qui utilise le port, puis réessayez.

L’assistant ne peut pas se connecter au serveur fictif

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.

Motif :

Le serveur fictif n’est pas en cours d’exécution.
Variable d’environnement MCP_PLATFORM_ENDPOINT incorrecte.
Problèmes de pare-feu ou de configuration réseau.