Informations de référence sur la commande CLI create-instance agent 365

Important

Vous devez faire partie du programme de préversion Frontier pour obtenir un accès arly à Microsoft Agent 365. Frontier vous connecte directement avec les dernières innovations 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.

Créez l’identité de l’agent et l’utilisateur de l’agent, puis ajoutez des autorisations à l’identité et aux licences à l’utilisateur. La create-instance commande crée des instances d’agent avec des identités, des licences et des autorisations nécessaires. Utilisez cette commande pour configurer des instances d’agent complètes, notamment la création de l’identité de l’agent, l’attribution de licences nécessaires et l’octroi d’autorisations à l’identité.

La create-instance commande effectue ces opérations :

  1. Creates Agent Identity : inscrit un principal du service d’identité d’agent dans Microsoft Entra via le Graph API.
  2. Crée un utilisateur agent : crée un compte d’utilisateur d’agent associé à l’identité.
  3. Affecte le responsable et le sponsor : définit l’utilisateur actuel en tant que responsable et sponsor de l’utilisateur et de l’identité de l’agent.
  4. Attribue des licences : attribue les licences agent 365 requises à l’utilisateur de l’agent.

Rôle minimal requis : Administrateur général

Note

Si vous n’avez pas encore les licences Agent 365 requises à attribuer, vous pouvez continuer à utiliser create-instance identity , puis utiliser create-instance licenses ensuite pour attribuer les licences lorsque vous les avez.

Syntaxe

L’exemple suivant montre la syntaxe de la create-instance commande et de ses sous-commandes facultatives.

a365 create-instance [command] [options]

Lorsque vous exécutez create-instance sans sous-commande, il exécute les deux étapes en séquence : il crée l’identité de l’agent et l’utilisateur de l’agent, puis affecte des licences.

Options

Utilisez ces options avec la create-instance commande ou les create-instance identitycreate-instance licenses sous-commandes.

Choix Descriptif
-c, --config <config> Chemin d’accès du fichier de configuration (par défaut : a365.config.json)
-v, --verbose Afficher la sortie détaillée
--dry-run Afficher ce qui serait fait sans exécuter
-?, , -h--help Afficher les informations d’aide et d’utilisation

Prerequisites

Avant d’exécuter create-instance, vérifiez que vous :

  • Terminé l’étape de blueprint de l’agent d’installation (a365 setup).
  • Publication de votre agent à l’aide a365 publishde .
  • Disposez d’un répertoire de travail valide a365.config.json et a365.generated.config.json dans votre répertoire de travail.
  • Connecté avec un compte disposant d’autorisations d’administrateur général.

Exemples create-instance

Ces exemples montrent comment utiliser la create-instance commande sans sous-commandes.

Créer une instance d’agent complète

Exécutez create-instance sans options pour créer une instance d’agent complète à l’aide de la configuration par défaut.

a365 create-instance

Créer avec un fichier de configuration spécifique

Utilisez l’option --config pour spécifier un chemin d’accès de fichier de configuration personnalisé.

a365 create-instance --config path/to/a365.config.json

Afficher un aperçu des modifications

Utilisez l’option --dry-run pour voir ce que create-instance faire sans apporter de modifications.

a365 create-instance --dry-run

create-instance identity

Créez l’identité de l’agent et l’utilisateur de l’agent, mais n’attribuez pas de licences.

Utilisez cette commande pour ignorer les licences lors de la création d’une identité.

Note

Si vous n’avez pas encore de licences disponibles, utilisez cette commande pour que vous ne soyez pas bloqué. Vous pouvez exécuter create-instance licenses lorsque vous disposez de licences.

a365 create-instance identity

create-instance licenses

Ajoutez des licences à un utilisateur agent existant.

Utilisez cette commande pour créer les licences lorsque l’identité existe déjà.

Note

Si vous avez utilisé create-instance identity précédemment, utilisez cette commande lorsque des licences sont disponibles.

a365 create-instance licenses

Utilisez ces commandes avec create-instance pour gérer le cycle de vie complet de votre agent.

  • Last updated on