Partager via


Informations de référence sur la commande CLI config 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 la configuration de l’interface CLI Agent 365. Fournit des options pour gérer les paramètres de configuration de l’interface CLI Agent 365. Vous pouvez initialiser de nouvelles configurations de manière interactive ou afficher les paramètres de configuration actuels.

Rôle minimal requis : Aucun (configuration locale)

Syntaxe

a365 config [command] [options]

Options

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

config init

Configurez interactivement l’interface CLI Agent 365 ou importez à partir d’un fichier.

a365 config init [options]

Utilisez cette commande pour configurer votre configuration cli Agent 365 via un processus interactif ou en important des paramètres à partir d’un fichier de configuration existant.

Options init

Choix Descriptif
-c, --configfile <configfile> Chemin d’accès à un fichier de configuration existant à importer
-g, --global Créer une configuration dans un répertoire global (AppData) au lieu d’un répertoire actif
-?, , -h--help Afficher les informations d’aide et d’utilisation

Remarques

La config init commande lance un Assistant interactif qui réduit l’entrée manuelle :

  • Azure CLI intégration : détecte automatiquement votre abonnement, locataire, groupes de ressources, plans App Service et régions.
  • Valeurs par défaut intelligentes : génère des noms de ressources à partir du nom de votre agent et d’un horodatage (par exemple, myagent-webapp-11140916). Vous pouvez personnaliser ces noms avant d’enregistrer.
  • Détection de plateforme : détecte votre type de projet (.NET, Node.js, Python) à partir du chemin du projet de déploiement et avertit si aucun type pris en charge n’est trouvé.
  • Validation de l’application cliente : valide votre ID d’application cliente sur votre locataire Entra, en vérifiant que les autorisations requises sont configurées et que le consentement de l’administrateur est accordé. Vous avez jusqu’à trois tentatives avant la sortie de l’Assistant.

Custom blueprint permissions (facultatif) : l’Assistant inclut une étape facultative pour configurer des autorisations pour des ressources externes supplémentaires, telles que la présence de Teams ou les fichiers OneDrive. La plupart des agents ne nécessitent pas cela. Vous pouvez également configurer des autorisations après l’installation initiale à l’aide a365 config permissionsde .

Mise à jour de la configuration existante : la réexécutation a365 config init charge votre actif a365.config.json par défaut. Appuyez sur Entrée à chaque invite pour conserver la valeur actuelle, ou tapez une nouvelle valeur pour la mettre à jour.

config display

Afficher la configuration actuelle de l’interface CLI de l’agent 365.

a365 config display [options]

Cette commande affiche les paramètres de configuration actuels de l’interface CLI Agent 365. Vous pouvez donc passer en revue votre configuration actuelle.

Options display

Choix Descriptif
-g, --generated Afficher la configuration générée (a365.generated.config.json)
-a, --all Afficher à la fois la configuration statique et générée
-?, , -h--help Afficher les informations d’aide et d’utilisation

Structure de fichiers de configuration

L’interface CLI utilise un fichier de configuration JSON (a365.config.json) avec les propriétés de clé suivantes :

{
  "$schema": "./a365.config.schema.json",
  "tenantId": "your-tenant-id",
  "subscriptionId": "your-subscription-id",
  "resourceGroup": "rg-Agent 365-example",
  "location": "westus",
  "appServicePlanName": "asp-Agent 365-example",
  "appServicePlanSku": "B1",
  "webAppName": "webapp-Agent 365-example",
  "agentBlueprintDisplayName": "My Agent 365 Blueprint",
  "agentIdentityDisplayName": "My Agent 365 Agent",
  "agentUserPrincipalName": "agent@contoso.onmicrosoft.com",
  "agentUserDisplayName": "My Agent 365 User",
  "managerEmail": "manager@contoso.onmicrosoft.com",
  "agentUserUsageLocation": "US",
  "agentIdentityScopes": [
    "User.Read",
    "Mail.Send",
    "Calendars.ReadWrite",
    "Files.ReadWrite"
  ],
  "agentApplicationScopes": [
    "Mail.ReadWrite",
    "Chat.ReadWrite",
    "Sites.Read.All"
  ],
  "deploymentProjectPath": ".",
  "deploymentProjectFile": "YourProject.csproj",
  "botName": "my-Agent 365-bot",
  "botDescription": "My AI-powered agent for Microsoft 365 tasks"
}