Partager via

Informations de référence sur la commande CLI develop agent 365

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 en IA de Microsoft. Les aperçus Frontier sont soumis aux conditions d’aperçu existantes de vos contrats clients. Comme ces fonctionnalités sont encore en développement, leur disponibilité et leurs capacités peuvent évoluer avec le temps.

Gérer les serveurs d’outils MCP pour le développement d’agents. La develop commande fournit des options pour gérer les serveurs d’outils MCP (Model Context Protocol) pour le développement d’agents. Vous pouvez répertorier les serveurs disponibles, afficher les serveurs configurés et ajouter ou supprimer des serveurs MCP de votre configuration de l’agent.

Rôle minimal requis : Aucun (gestion des manifestes locaux)

Syntaxe

a365 develop [command] [options]

Options

Choix Descriptif
-c, --config <config> Chemin du fichier de configuration. Par défaut : a365.config.json
-v, --verbose Activez la journalisation commentée
-?, , -h--help Affichez les informations d’aide et d’utilisation.

develop list-available

Répertoriez tous les serveurs MCP disponibles dans le catalogue (ce que vous pouvez installer).

a365 develop list-available [options]

Cette commande affiche tous les serveurs MCP disponibles dans le catalogue et vous pouvez les installer pour une utilisation avec votre développement d’agent.

Options list-available

Choix Descriptif
-c, --config <config> Chemin du fichier de configuration. Par défaut : a365.config.json
--dry-run Afficher ce que la commande ferait sans l’exécuter.
--skip-auth Ignorez l’authentification. Pour les tests uniquement. La commande échoue probablement sans authentification valide.
-?, , -h--help Affichez les informations d’aide et d’utilisation.

develop list-configured

Répertoriez les serveurs MCP actuellement configurés à partir de votre serveur local ToolingManifest.json.

a365 develop list-configured [options]

Cette commande affiche tous les serveurs MCP que vous avez actuellement configurés dans votre fichier de ToolingManifest.json local.

Options list-configured

Choix Descriptif
-c, --config <config> Chemin du fichier de configuration. Par défaut : a365.config.json
--dry-run Afficher ce que la commande ferait sans l’exécuter.
-?, , -h--help Affichez les informations d’aide et d’utilisation.

develop add-mcp-servers

Ajoutez des serveurs MCP à la configuration actuelle de l’agent.

a365 develop add-mcp-servers [<servers>...] [options]

Cette commande ajoute les serveurs MCP spécifiés dans ToolingManifest.json votre dossier de projet. Il n’accorde pas d’autorisations au blueprint de l’agent.

Important

Cette commande ne met à jour ToolingManifest.json que : elle n’accorde pas d’autorisations au blueprint de l’agent. La façon dont les autorisations sont appliquées dépend de l’emplacement où vous êtes dans le processus d’installation :

  • Avant la configuration initiale : Passez à a365 setup all. Les autorisations MCP sont appliquées dans le cadre de la création initiale du blueprint.
  • Une fois le blueprint déjà existant : un administrateur général doit s’exécuter a365 setup permissions mcp séparément. L’administrateur doit d’abord s’exécuter a365 config display pour vérifier que deploymentProjectPath , dans ses a365.config.json points, le dossier du projet contenant la mise à jour ToolingManifest.json.

Arguments add-mcp-servers

Spécifiez un ou plusieurs noms de serveur MCP à ajouter à votre configuration de l’agent. Vous pouvez fournir plusieurs noms de serveur séparés par des espaces.

Argument Descriptif
<servers> Noms des serveurs MCP à ajouter

Options add-mcp-servers

Utilisez ces options pour personnaliser le comportement de la add-mcp-servers commande, y compris la sélection du fichier de configuration et les tests à exécution sèche.

Choix Descriptif
-c, --config <config> Chemin du fichier de configuration. Par défaut : a365.config.json
--dry-run Afficher ce que la commande ferait sans l’exécuter.
-?, , -h--help Affichez les informations d’aide et d’utilisation.

develop remove-mcp-servers

Supprimez les serveurs MCP de la configuration actuelle de l’agent.

a365 develop remove-mcp-servers [<servers>...] [options]

Cette commande supprime les serveurs MCP spécifiés de la configuration de votre agent actuel.

Arguments remove-mcp-servers

Argument Descriptif
<servers> Noms des serveurs MCP à supprimer

Options remove-mcp-servers

Choix Descriptif
-c, --config <config> Chemin du fichier de configuration. Par défaut : a365.config.json
--dry-run Afficher ce que la commande ferait sans l’exécuter.
-?, , -h--help Affichez les informations d’aide et d’utilisation.

develop add-permissions

Ajoutez des autorisations d’API de serveur MCP pour Microsoft Entra applications pour les scénarios de développement où vous devez configurer des applications personnalisées pour accéder aux serveurs MCP.

a365 develop add-permissions [options]

Options add-permissions

Utilisez ces options pour ajouter des autorisations et des étendues d’API requises à votre inscription d’application, en tirant parti des valeurs du manifeste d’outils.

Choix Descriptif
-c, --config <config> Chemin d’accès du fichier de configuration (par défaut : a365.config.json)
-m, --manifest <manifest> Chemin d’accès ( ToolingManifest.json par défaut : <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id> ID d’application (client) pour ajouter des autorisations à (par défaut : clientAppId à partir de la configuration)
--scopes <scopes> Étendues spécifiques à ajouter (séparées par l’espace) (valeur par défaut : Toutes les étendues de ToolingManifest.json)
--dry-run Afficher ce que la commande ferait sans apporter de modifications
-v, --verbose Afficher la sortie détaillée
-?, , -h--help Affichez les informations d’aide et d’utilisation.

Important

L’application spécifiée par --app-id ou clientAppId doit disposer de l’autorisation Application.ReadWrite.All dans Microsoft Entra. Cette commande concerne les applications clientes personnalisées. Pour configurer des autorisations pour les blueprints d’agent, utilisez a365 setup permissions mcp à la place.

develop get-token

Récupérez les jetons du porteur pour tester les serveurs MCP pendant le développement à l’aide de l’authentification interactive du navigateur.

a365 develop get-token [options]

Options get-token

Utilisez ces options pour demander un jeton d’accès, contrôler les étendues, actualiser le comportement et choisir le format de sortie.

Choix Descriptif
-c, --config <config> Chemin d’accès du fichier de configuration (par défaut : a365.config.json)
--app-id <app-id> ID d’application (client) pour l’authentification (par défaut : clientAppId à partir de la configuration)
-m, --manifest <manifest> Chemin d’accès ( ToolingManifest.json par défaut : <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes> Étendues spécifiques à demander (séparées par l’espace) (valeur par défaut : Lecture à partir de ToolingManifest.json)
-o, --output <output> Format de sortie : table, jsonou raw (par défaut : table)
--force-refresh Forcer l’actualisation du jeton contournant le cache
--resource <resource> Mot clé de ressource pour obtenir le jeton pour : mcp (par défaut) ou powerplatform
--resource-id <resource-id> ID d’application de ressource personnalisé (GUID) pour les ressources non couvertes par des --resource mots clés
-v, --verbose Afficher la sortie détaillée, y compris le jeton complet
-?, , -h--help Affichez les informations d’aide et d’utilisation.

get-token options de ressource

Utilisez les options --resource et --resource-id pour obtenir des jetons pour différentes ressources Azure :

  • --resource: Utilisez un mot clé pour sélectionner une ressource prédéfinie :
    • mcp (par défaut) : Outils agent 365 pour les serveurs MCP
    • powerplatform: API Power Platform
  • --resource-id: entrez un ID d’application de ressource personnalisé (GUID) pour les ressources non couvertes par des mots clés

Important

--resource et --resource-id ne peut pas être utilisé ensemble. Lorsque vous utilisez l’une ou l’autre option, incluez --scopes. Seul le flux MCP par défaut prend en charge la résolution d’étendue basée sur un manifeste.

develop start-mock-tooling-server

Démarrez un serveur d’outils fictif à des fins de test et de développement.

a365 develop start-mock-tooling-server [options]

Cette commande démarre un serveur d’outils fictif à des fins de test et de développement. À l’aide de ce serveur, vous pouvez simuler des interactions de serveur MCP sans nécessiter d’implémentations de serveur réelles.

Options start-mock-tooling-server

Utilisez ces options pour personnaliser le comportement de la start-mock-tooling-server commande.

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 -
  • Last updated on