Partager via

Informations de référence sur la commande CLI setup 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.

Configurez votre environnement Agent 365 avec un contrôle granulaire sur chaque étape. Cette commande gère le flux de travail d’installation initial pour les blueprints Agent 365.

rôle Minimum requis : Azure Contributeur + Administrateur global

Syntaxe

a365 setup [command] [options]

Options

Choix Descriptif
-?, , -h--help Affiche les informations d’aide et d’utilisation. 
# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create infrastructure (or skip if infrastructure exists)
a365 setup infrastructure

# 2. Create blueprint
a365 setup blueprint

# 3. Configure MCP permissions
a365 setup permissions mcp

# 4. Configure bot permissions
a365 setup permissions bot

# 5. Configure CopilotStudio permissions (if needed)
a365 setup permissions copilotstudio

# 6. Configure custom permissions (if needed)
a365 setup permissions custom

Ou exécutez toutes les étapes en même temps :

# Full setup (includes infrastructure)
a365 setup all

# Skip infrastructure if it already exists
a365 setup all --skip-infrastructure

setup requirements

Valider les prérequis pour la configuration de l’agent 365. Exécute des vérifications des exigences modulaires et fournit des conseils pour tous les problèmes qu’il trouve.

a365 setup requirements [options]

Cette commande exécute les étapes suivantes :

  • Vérifie toutes les conditions préalables requises pour la configuration de l’agent 365.
  • Signale les problèmes liés aux conseils de résolution détaillés.
  • Continue à vérifier toutes les exigences, même si certaines vérifications échouent.
  • Fournit un résumé de toutes les vérifications à la fin.

Options requirements

Choix Descriptif
-c, --config <config> Chemin du fichier de configuration. La valeur par défaut est a365.config.json.
-v, --verbose Affiche une sortie détaillée pour toutes les vérifications.
--category <category> Exécute des vérifications pour une catégorie spécifique uniquement, comme Azure, Authentication ou Configuration.
-?, , -h--help Affiche les informations d’aide et d’utilisation.

setup infrastructure

Créez une infrastructure Azure.

Minimum autorisations requises : contributeur ou propriétaire d’abonnement Azure

a365 setup infrastructure [options]

Options infrastructure

Choix Descriptif
-c, --config <config> Chemin du fichier de configuration. La valeur par défaut est a365.config.json.
-v, --verbose Afficher une sortie détaillée.
--dry-run Affichez ce qui serait fait sans exécuter.
-?, , -h--help Affiche les informations d’aide et d’utilisation.

setup blueprint

Créer un blueprint d’agent (inscription d’application Entra ID).

Autorisations minimales requises : rôle développeur d’ID d’agent

a365 setup blueprint [options]

Options blueprint

Choix Descriptif
-c, --config <config> Chemin du fichier de configuration. La valeur par défaut est a365.config.json.
-v, --verbose Afficher une sortie détaillée.
--dry-run Affichez ce qui serait fait sans exécuter.
--no-endpoint N’inscrivez pas le point de terminaison de messagerie (blueprint uniquement).
--endpoint-only Inscrivez uniquement le point de terminaison de messagerie. Nécessite un blueprint existant.
-?, , -h--help Affiche les informations d’aide et d’utilisation.

setup permissions

Configurez les autorisations OAuth2 et les autorisations héritées.

Autorisations minimales requises : Administrateur général

a365 setup permissions [command] [options]

Options

Choix Descriptif
-?, , -h--help Affiche les informations d’aide et d’utilisation.

Sous-commandes

Sous-commande Descriptif
mcp Configurez le serveur MCP OAuth2 accorde et hérite des autorisations.
bot Configurez l’API de bot de messagerie OAuth2 accorde et hérite des autorisations.
custom Applique des autorisations d’API personnalisées à votre blueprint d’agent qui dépassent les autorisations standard requises pour l’opération de l’agent.
copilotstudio Configure les autorisations OAuth2 accorde et hérite des autorisations pour que le blueprint de l’agent appelle Copilot copilotes Studio via l’API Power Platform.

setup permissions mcp

Configurez le serveur MCP OAuth2 accorde et hérite des autorisations.

Autorisations minimales requises : Administrateur général

a365 setup permissions mcp [options]

Cette commande :

  • ToolingManifest.json Lit à partir du deploymentProjectPath fichier spécifié dans a365.config.json.
  • Accorde des autorisations déléguées OAuth2 pour chaque étendue de serveur MCP au blueprint de l’agent.
  • Configure les autorisations héritées afin que les instances d’agent puissent accéder aux outils MCP.
  • Est idempotent et sûr à exécuter plusieurs fois.

Important

  • Avant d’exécuter cette commande, exécutez a365 config display pour vérifier qu’il deploymentProjectPath pointe vers le dossier du projet contenant la mise à jour ToolingManifest.json. Si le développeur ajoute des serveurs MCP sur un autre ordinateur, partagez d’abord la mise à jour ToolingManifest.json avec l’administrateur général. L’exécution sans correction ToolingManifest.json n’ajoute pas les nouvelles autorisations de serveur MCP au blueprint.
  • Exécutez cette commande après l’exécution a365 develop add-mcp-serversdu développeur . L’ajout de serveurs MCP au manifeste et l’octroi d’autorisations au blueprint sont deux étapes distinctes. Une fois cette commande terminée, les autorisations du serveur MCP sont visibles dans le blueprint de l’agent.

Options permissions mcp

Choix Descriptif
-c, --config <config> Chemin du fichier de configuration. La valeur par défaut est a365.config.json.
-v, --verbose Afficher une sortie détaillée.
--dry-run Affichez ce qui serait fait sans exécuter.
-?, , -h--help Affiche les informations d’aide et d’utilisation.

setup permissions bot

Configurez l’API de bot de messagerie OAuth2 accorde et hérite des autorisations.

Autorisations minimales requises : Administrateur général

Prérequis : Autorisations Blueprint et MCP (exécuter en a365 setup permissions mcp premier)

étape Next : Déployer votre agent (exécutez a365 deploy si vous hébergez sur Azure)

a365 setup permissions bot [options]

Options permissions bot

Choix Descriptif
-c, --config <config> Chemin du fichier de configuration. La valeur par défaut est a365.config.json.
-v, --verbose Afficher une sortie détaillée.
--dry-run Affichez ce qui serait fait sans exécuter.
-?, , -h--help Affiche les informations d’aide et d’utilisation.

setup permissions custom

Applique des autorisations d’API personnalisées à votre blueprint d’agent qui dépassent les autorisations standard requises pour l’opération de l’agent. À l'aide de cette commande, vous accordez à votre agent l'accès à des étendues de Microsoft Graph supplémentaires, telles que présence, fichiers et conversations, ou aux API personnalisées inscrites dans le locataire Entra ID de votre organisation.

Autorisations minimales requises : Administrateur général

Conditions préalables : Exécuter a365 setup blueprint en premier. Ajoutez des autorisations personnalisées à a365.config.json l’aide a365 config permissions avant d’exécuter cette commande.

a365 setup permissions custom [options]

Cette commande :

  • Configure les octrois d’autorisations déléguées OAuth2 avec le consentement administrateur pour chaque ressource configurée.
  • Définit des autorisations héritantes afin que les utilisateurs de l’agent puissent hériter de l’accès à partir du blueprint.
  • Rapproche Microsoft Entra avec la configuration actuelle en ajoutant de nouvelles autorisations et en supprimant les autorisations qui ont été supprimées de la configuration.
  • Est idempotent et sûr à exécuter plusieurs fois.

Options permissions custom

Choix Descriptif
-c, --config <config> Chemin du fichier de configuration. La valeur par défaut est a365.config.json.
-v, --verbose Afficher une sortie détaillée.
--dry-run Affichez ce qui serait fait sans exécuter.
-?, , -h--help Affiche les informations d’aide et d’utilisation.

Configurer des autorisations personnalisées

Permet a365 config permissions d’ajouter des autorisations personnalisées à votre configuration avant d’exécuter cette commande :

# Add Microsoft Graph extended permissions
a365 config permissions `
  --resource-app-id 00000003-0000-0000-c000-000000000000 `
  --scopes Presence.ReadWrite,Files.Read.All,Chat.Read

# Add custom API permissions
a365 config permissions `
  --resource-app-id <your-api-app-id> `
  --scopes CustomScope.Read,CustomScope.Write

# Apply all configured custom permissions
a365 setup permissions custom

Le nom de la ressource est résolu automatiquement à partir de Azure pendant l’installation. Vous n’avez pas besoin de le spécifier dans la configuration.

Supprimer des autorisations personnalisées

Pour supprimer les autorisations personnalisées de la configuration et de l’Microsoft Entra :

# Step 1: Remove from config
a365 config permissions --reset

# Step 2: Reconcile Microsoft Entra with updated config
a365 setup permissions custom

Intégration à setup all

Lorsque votre configuration inclut des autorisations personnalisées, l’exécution a365 setup all les configure automatiquement. L’ordre d’installation complet est le suivant :

  1. Infrastructure
  2. Schéma
  3. Autorisations MCP
  4. Autorisations de l’API bot
  5. Autorisations de blueprint personnalisées (si configurées)
  6. Point de terminaison de messagerie

setup permissions copilotstudio

Configure les autorisations OAuth2 accorde et hérite des autorisations pour que le blueprint de l’agent appelle Copilot copilotes Studio via l’API Power Platform.

Autorisations minimales requises : Administrateur général

Conditions préalables : Exécuter a365 setup blueprint en premier.

a365 setup permissions copilotstudio [options]

Cette commande :

  • Vérifie que le principal du service d’API Power Platform existe dans votre locataire.
  • Crée une autorisation OAuth2 à partir du blueprint vers l’API Power Platform avec l’étendue CopilotStudio.Copilots.Invoke .
  • Définit des autorisations héritantes afin que les instances d’agent puissent appeler Copilot copilotes Studio.

Options permissions copilotstudio

Choix Descriptif
-c, --config <config> Chemin du fichier de configuration. La valeur par défaut est a365.config.json.
-v, --verbose Afficher une sortie détaillée.
--dry-run Affichez ce qui serait fait sans exécuter.
-?, , -h--help Affiche les informations d’aide et d’utilisation.

Utilisez cette commande lorsque votre agent doit appeler Copilot Copilots Studio au moment de l’exécution ou appeler des API Power Platform qui nécessitent des autorisations CopilotStudio.

setup all

Effectuer toutes les étapes de configuration pour configurer votre environnement Agent 365

a365 setup all [options]

Exécute la configuration complète de l’agent 365, toutes les étapes en séquence.

Inclut : Infrastructure, Blueprint, Autorisations et point de terminaison.

Autorisations minimales requises (l’administrateur général dispose de toutes ces autorisations) :

  • contributeur d’abonnement Azure (pour l’infrastructure et le point de terminaison)
  • Rôle développeur d’ID d’agent (pour la création de blueprints)
  • Administrateur général (pour les octrois d’autorisations et le consentement de l’administrateur)

Options setup all

Choix Descriptif
-c, --config <config> Chemin du fichier de configuration. La valeur par défaut est a365.config.json.
-v, --verbose Afficher une sortie détaillée.
--dry-run Affichez ce qui serait fait sans exécuter.
--skip-infrastructure Ignorez Azure création d’infrastructure (utilisez si l’infrastructure existe déjà). Cette option crée toujours : Blueprint, Autorisations et point de terminaison.
--skip-requirements Ignorez la vérification de validation des exigences. Utilisez la prudence : le programme d’installation peut échouer si les prérequis ne sont pas remplis.
-?, , -h--help Affiche les informations d’aide et d’utilisation.
  • Last updated on