Partager via

Configuration de l’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 d’IA de Microsoft. Les versions préliminaires Frontier sont soumises aux conditions existantes de vos contrats clients qui régissent les versions préliminaires. Comme ces fonctionnalités sont encore en cours de développement, leur disponibilité et leurs capacités peuvent évoluer au fil du temps.

La CLI de l’Agent 365 doit connaître votre locataire, votre abonnement et d’autres détails pour créer les ressources nécessaires comme Agent Blueprint. La CLI stocke ces informations dans un fichier de configuration central appelé a365.config.json dans votre répertoire de travail. Toutes les commandes de la CLI utilisent ce fichier de configuration.

Prerequisites

Avant de commencer, vérifiez que vous disposez des conditions préalables suivantes :

Autorisations requises :

  • Utilisateur tenant Microsoft Entra valide avec l’un des rôles suivants :
    • Administrateur général
    • Administrateur d’ID d’agent
    • Développeur Agent ID
  • Avoir un accès à un abonnement Azure avec des autorisations adéquates pour créer des ressources

Configurez la ligne de commande Agent 365

La a365 config init commande crée a365.config.json, le fichier de configuration central utilisé par toutes les commandes CLI de l’Agent 365, dans votre répertoire de travail. La CLI propose un assistant interactif intégrant Azure CLI et utilisant des valeurs par défaut intelligentes afin de réduire les saisies manuelles.

S’authentifier auprès d’Azure

Avant d’initialiser la configuration, authentifiez avec Azure en utilisant la az login commande suivante :

az login

Sélectionnez l’abonnement approprié lorsque vous y êtes invité(e). L’assistant Configuration utilise Azure CLI pour interroger les abonnements, groupes de ressources et plans App Service disponibles. Pour une expérience de développement fluide, configurez votre compte utilisateur locataire avec le bon rôle et les bonnes permissions, abonnement et plan de service d’application avant de commencer.

Initialiser la configuration

Exécutez la a365 config init commande pour lancer l’assistant de configuration interactif :

a365 config init

L’assistant utilise l’intégration d’Azure CLI et les valeurs par défaut intelligentes pour réduire les entrées manuelles. On vous invite à :

Terrain Descriptif Example
ID d’application client Votre identifiant d’enregistrement personnalisé pour votre application client 00001111-aaaa-2222-bbbb-3333cccc4444
Chemin d’accès du projet de déploiement Chemin d’accès au répertoire de votre projet d’assistant C:\MyAgent\sample-agent
Adresse e-mail du responsable Adresse e-mail du responsable qui supervise cet assistant manager@yourtenant.com
Abonnement Azure Sélectionnez parmi les abonnements Azure disponibles Sélection interactive
Groupe de ressources Sélectionnez ou créez un nouveau groupe de ressources existant Sélection interactive
Plan de service App Sélectionnez un plan existant ou créez un nouveau plan de service applicatif Sélection interactive
Lieu Azure region for deployment eastus, canadacentral

L’assistant génère automatiquement les noms de ressources associés (application web, identité de l’agent, blueprint, utilisateur agent) et valide le type de projet de votre équipe.

En savoir plus sur la structure des fichiers de configuration

Verify Agent 365 fichiers de configuration

L’Agent 365 utilise plusieurs fichiers de configuration tout au long du cycle de développement :

Fichier Objectif Date de création Modifier manuellement ?
a365.config.json Paramètres fournis par l’utilisateur Après a365 config init Oui
a365.generated.config.json Valeurs générées par CLI (ID d’agent, identifiants de ressources) Après a365 setup Non
.env ou appsettings.json Variables de l’environnement d’exécution Vous créez pour le développement local Oui

Après avoir terminé la configuration, vérifiez que vous avez les éléments suivants :

Vérifier la création du a365.config.json fichier

Vérifiez visuellement que le a365.config.json fichier existe. Ou bien, utilisez la commande PowerShell Test-Path dans un script pour automatiser cette vérification.

# Check file exists in current working directory
Test-Path a365.config.json
# Should return: True

Vérifier a365.config.json les données de configuration

Exécutez la a365 config display commande pour visualiser la configuration actuelle de la CLI de l’Agent 365.

a365 config display

Le résultat de cette commande ressemble à ceci :

{
  "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
  "resourceGroup": "your-resource-group",
  "location": "location-of-your-azure-resources",
  "environment": "prod",
  "needDeployment": true,
  "clientAppId": "00001111-aaaa-2222-bbbb-3333cccc4444",
  "appServicePlanName": "your-app-service-plan",
  "appServicePlanSku": "service-plan-sku",
  "webAppName": "your-web-app",
  "agentIdentityDisplayName": "your-agent-name Identity",
  "agentBlueprintDisplayName": "your-agent-name Blueprint",
  "agentUserPrincipalName": "youragent@yourtenant.onmicrosoft.com",
  "agentUserDisplayName": "your-agent-name Agent User",
  "managerEmail": "manager@yourtenant.com",
  "agentUserUsageLocation": "usage-location",
  "deploymentProjectPath": "C:\\path\\to\\your\\project",
  "agentDescription": "your-agent-name - Agent 365 Agent"
}

Liste de contrôle de la vérification

✅ Tous les champs ont des valeurs valides (pas de chaînes vides ni de nulls)
✅ tenantId et subscriptionId sont des GUID valides
✅ clientAppId est un GUID valide (votre enregistrement personnalisé de l’application client)
✅ resourceGroup et appServicePlanName existent dans votre abonnement Azure
✅ managerEmail Utilise votre domaine locataire
✅ deploymentProjectPath pointe vers votre répertoire de codes d’agent
✅ agentUserPrincipalName suit le format agentname@tenant.com
✅ environment est défini (typiquement prod)
✅ needDeployment est true pour la configuration initiale. Si vous n’avez pas besoin de déploiement, apprenez à définir un point de terminaison de messagerie agent.

Si votre configuration ne correspond pas à la sortie attendue, consultez la section Dépannage pour des solutions détaillées.

Conseil / Astuce

Gardez une sauvegarde de votre a365.config.json dossier. Vous pouvez le soumettre au contrôle de version (il ne contient pas de secrets).

Étape suivante

Si tout est en ordre, vous êtes prêt à continuer.

Plan d’agent de configuration

Résolution des problèmes

Utilisez ces étapes pour diagnostiquer rapidement et résoudre les problèmes courants avec a365.config.json l’interface de l’Agent 365 CLI.

Le fichier de configuration n’existe pas

Symptôme: Les commandes CLI échouent avec « Configuration non trouvée » ou Test-Path a365.config.json retournent False.

Solution : Créez un nouveau a365.config.json fichier.

Complétez les étapes pour authentifier avec Azure et initialiser la configuration.

Valeurs de configuration manquantes ou invalides

Symptôme: Le fichier de configuration existe mais comporte des champs vides ou des erreurs de validation.

Solution : Suivez les étapes pour vérifier a365.config.json les données de configuration.

Si un champ est incorrect :

  • Option 1 : Relancez le magicien en utilisant la a365 config init commande.
  • Option 2 : Éditez a365.config.json manuellement avec les bonnes valeurs.

Locataire invalide ou abonnement

Symptôme: La CLI échoue avec des erreurs d’authentification ou d’autorisation.

Solution:

Utilisez ces commandes pour réauthentifier avec Azure, vérifier le compte connecté, passer à l’abonnement correct et réinitialiser la configuration de la CLI de l’Agent 365.

# Re-authenticate with Azure
az login

# Verify you're logged into the correct account
az account show

# If needed, switch to the correct subscription
az account set --subscription "<subscription-name-or-id>"

# Re-initialize configuration
a365 config init

Échec de validation d’application client personnalisée

Symptôme: L’assistant de configuration échoue lors de la validation de l’ID client personnalisé.

Solution : Examinez l’enregistrement personnalisé de votre application client pour vous assurer que votre inscription dispose de toutes les autorisations requises et de l’autorisation de l’administrateur.

  • Last updated on