Que fait entra-agent-user ?
Créez des utilisateurs agents dans Microsoft Entra ID à partir d'identités d'agents, permettant aux agents IA d'agir en tant que travailleurs numériques avec des capacités d'identité utilisateur dans les environnements Microsoft 365 et Azure.
Vue d'ensemble
Cette compétence automatise la création d'utilisateurs agents dans Microsoft Entra ID en utilisant des identités d'agents IA. Chaque agent se voit attribuer une identité utilisateur complète, comprenant un nom d'utilisateur, un mot de passe, une adresse e-mail (si activée) et des licences appropriées (par exemple, Exchange Online, SharePoint, Teams). Cela permet aux agents d'opérer comme des membres à part entière du locataire Microsoft 365, avec des capacités telles que :
- Envoi et réception d'e-mails
- Gestion des calendriers
- Accès aux fichiers et documents
- Participation aux réunions Teams
- Utilisation des APIs Microsoft Graph avec une authentification utilisateur
Utilisation
Pour créer un utilisateur agent, exécutez la commande suivante :
entra-agent-user create --display-name "Agent Support" --user-principal-name "[email protected]" --password "SecurePass123!"
Vous pouvez également spécifier des paramètres supplémentaires :
--mail-enabled: Activer la boîte aux lettres--license-sku: SKU de licence à attribuer (ex :O365_BUSINESS_ESSENTIALS)--role: Rôle Azure AD à attribuer (ex :User Administrator)
Configuration requise
- Un locataire Microsoft Entra ID actif
- Permissions d'administrateur utilisateur ou équivalent
- Applications inscrites avec les permissions Graph appropriées (
User.ReadWrite.All,Directory.ReadWrite.All) - Un agent IA compatible (Claude Code, Cursor, Codex, etc.)
Fonctionnement
- L'agent appelle la fonction
create_agent_useravec les paramètres requis. - Le script utilise Microsoft Graph API pour créer un objet utilisateur dans Entra ID.
- Si spécifié, une boîte aux lettres Exchange Online est provisionnée.
- Des licences et rôles sont attribués selon la configuration.
- L'utilisateur agent est prêt à être utilisé immédiatement.
Dépannage
- Erreur d'authentification : Assurez-vous que l'application a les permissions Graph appropriées.
- Échec de création : Vérifiez que le nom d'utilisateur principal (UPN) n'existe pas déjà.
- Boîte aux lettres non créée : L'activation de la messagerie peut prendre quelques minutes.