Intégrez un assistant unique avec la CLI Agent 365

Utilisez la CLI Agent 365 pour créer les objets d’identité Microsoft Entra pour un agent et enregistrez l’agent auprès de l’Agent 365. Commencez par un agent hors production pour pouvoir valider l’identité, les autorisations, le consentement et l’enregistrement avant d’intégrer des agents en masse.

Cet article utilise Vérification des notes de frais comme nom de base d’un assistant standard qui examine les notes de frais au nom d’un employé connecté. Il utilise l’authentification au nom de (OBO) et n’a pas besoin de son propre compte d’utilisateur Microsoft Entra, de sa propre boîte aux lettres ni d’une présence Teams.

Le flux de travail sans configuration crée :

• Un blueprint d’identité d’agent nommé Expense Review Blueprint.
• Une identité d’agent nommée Expense Review Agent.
• Octroi de permissions déléguées pour l’authentification OBO.
• Un enregistrement Agent 365 pour l’agent.
• Un a365.generated.config.json fichier qui enregistre les identifiants générés et le statut de configuration.

Pour une explication des objets identité, voir Agent 365 identité.

Prerequisites

Avant de commencer, assurez-vous d’avoir :

• Un locataire Microsoft avec l’Agent 365 activé. Utilisez un locataire non-production ou un environnement de test pour cette procédure guidée.
• Un abonnement Azure dans le même tenant.
• Le rôle Contributeur sur l’abonnement Azure.
• Le rôle Agent ID Developer dans Microsoft Entra ID est au minimum requis pour créer le blueprint et l’identité de l’agent.
• Un administrateur global disponible pour accorder les autorisations OAuth. Si vous occupez ce poste, vous pouvez terminer le flux de travail en une seule session. Sinon, la CLI fournit des URL de consentement à envoyer à un Administrateur Global.
• Utilisez le rôle Administrateur d’Application ou Administrateur général si vous modifiez le scénario pour utiliser l’authentification service à service (S2S).
• .NET 8.0 ou plus récent.
• Azure CLI, connecté au locataire et à l’abonnement que vous souhaitez utiliser.
• The Agent 365 CLI.

La configuration de l'Agent 365 utilise l'application Agent 365 Enterprise Business, gérée par Microsoft, lorsqu'elle est disponible dans votre locataire. Son identifiant d’application (client) est f54280f4-395e-4ea8-9e48-bf2d4952aa14. Si l’application n’est pas disponible, la CLI recherche une application détenue par le locataire nommée Agent 365 CLI. Un administrateur global peut créer et configurer une application appartenant au locataire à partir de l’invite CLI. Pour plus d’informations sur la solution de secours, consultez Inscription d’une application cliente personnalisée pour l’interface CLI d’Agent 365.

Installer l’Agent 365 CLI

Installez le CLI comme un outil .NET global :

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli

Si la CLI est déjà installée, mettez-la à jour :

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

Vérifiez l’installation :

a365 --version

Pour le dépannage de l’installation et les emplacements de fichiers pris en charge, consultez Installer et utiliser la CLI de l’Agent 365.

Sélectionnez le tenant et l’abonnement

Connectez-vous à Azure :

az login

Liste des abonnements disponibles sur votre compte :

az account list --output table

Sélectionnez l’abonnement dans le locataire où vous souhaitez intégrer l’assistant :

az account set --subscription "<subscription-id-or-name>"

Confirmez le locataire actif et l’abonnement :

az account show --query "{tenantId:tenantId, subscriptionId:id, subscriptionName:name}" --output table

Notez l’identifiant locataire. La CLI le détecte depuis le compte Azure CLI actif. Vous pouvez aussi le fournir explicitement en utilisant --tenant-id.

Validez les prérequis

Effectuez la vérification des exigences depuis n’importe quel répertoire :

a365 setup requirements

La commande vérifie l’authentification, l’accès Azure, l’inscription du locataire, les rôles et l’application cliente. Cela continue après un échec de vérification afin que vous puissiez examiner tous les problèmes détectés ensemble.

Corrigez toutes les vérifications obligatoires ayant échoué avant de continuer. Si l'application d'entreprise gérée par Microsoft n'est pas disponible, suivez l'invite pour sélectionner ou créer une application client détenue par un locataire, puis relancez la commande.

Prévisualiser les changements d’intégration

Créez un répertoire de travail vide pour la configuration générée, puis placez-vous dans ce répertoire :

New-Item -ItemType Directory -Path .\expense-review-agent
Set-Location .\expense-review-agent

Prévisualisez les changements sans créer d’objets de locataire:

a365 setup all `
    --agent-name "Expense Review" `
    --aiteammate false `
    --dry-run

Examinez l’identifiant du locataire, les noms d’objets dérivés, l’application client sélectionnée, les permissions et le mode d’authentification. Ce scénario utilise le mode d’authentification par défaut obo car l’agent agit pour un employé connecté.

Si le locataire détecté n’est pas correct, spécifiez-le explicitement :

a365 setup all `
    --agent-name "Expense Review" `
    --tenant-id "<tenant-id>" `
    --aiteammate false `
    --dry-run

Intégrer l’agent

Exécutez la même commande sans --dry-run:

a365 setup all `
    --agent-name "Expense Review" `
    --aiteammate false

La CLI valide à nouveau les exigences, crée le blueprint et l’identité de l’agent, configure les permissions déléguées, enregistre l’agent et écrit a365.generated.config.json.

Si vous vous connectez en tant qu’administrateur global, remplissez toute invite de consentement qui s’ouvre lors de la configuration. Si vous utilisez plutôt les rôles Agent ID Developer ou Agent ID Administrator, la CLI complète les étapes autorisées par votre rôle et imprime les actions de consentement pour un Administrateur général. Envoyez les URL de consentement générées à l’Administrateur général et demandez-lui de compléter chaque octroi.

Vérifiez le résultat de l’onboarding

Consultez le résumé de la configuration. Chaque étape requise doit s’afficher comme terminée. Si un administrateur général doit encore accorder son consentement, veillez à ce que cette étape soit effectuée avant de considérer l’intégration comme terminée.

Inspectez la configuration générée :

Get-Content .\a365.generated.config.json | ConvertFrom-Json

Confirmez que la sortie contient :

• Un ID de blueprint d’agent.
• Un statut de configuration terminée, sans aucune action de consentement en cours.

Confirmez que le résumé de configuration indique la création réussie de l’identité d’agent et l’enregistrement de l’agent.

Ensuite, vérifiez l’inscription dans le centre d’administration Microsoft 365 :

1. Accédez au Centre d’administration de Microsoft 365.
2. Sélectionner les agents>Tous les agents.
3. Trouvez Expense Review Agent.
4. Ouvrez l’agent et confirmez que son identité et ses informations d’enregistrement correspondent à la configuration générée.

Résoudre les problèmes d’intégration

Pour des solutions plus spécifiques à la CLI, voir dépannage d’Agent 365.

Étapes suivantes

• Intégrer plusieurs agents avec PowerShell.
• Validez l’intégration de votre Agent 365.
• Vérifiez la commande de configuration de la CLI Agent 365.