Planifier une flotte d’agents sur un runtime partagé

Une flotte d’agents est un ensemble d’agents qui s’exécutent sur un runtime cloud partagé. Par exemple, une plateforme qui permet aux équipes ou aux clients de déployer leurs propres agents héberge chaque nouvel agent sur la même base de calcul et de code. Chaque agent de la flotte obtient son propre identité d’agent, de sorte que ses connexions, ses autorisations et ses enregistrements d’audit restent distincts des autres agents.

Le runtime contient un seul jeu d’informations d’identification de modèle d’identité d’agent et l’utilise pour acquérir des jetons pour toute identité d’agent créée à partir de ce modèle. Le runtime choisit l’identité de l’agent à utiliser sur chaque demande de jeton.

Choisir entre un seul agent et une flotte

Considérations Agent individuel Flotte d’agents
Nombre d’agents par déploiement Une Nombreux, ajoutés et supprimés au moment de l’exécution
Lorsque des identités d’agent sont créées Avant le déploiement de l’agent, par un développeur ou un administrateur Lorsque chaque agent est déployé, par le runtime ou par Agent 365
Où provient l’ID d’identité de l’agent Configuration Recherche sur chaque requête
Mode d’octroi de l’accès À l’identité de l’agent, avant le déploiement de l’agent Pour chaque identité de l’agent, lorsque l’agent est approvisionné
Conseils Créer des agents cloud avec ASP.NET Core ou le side-car du Kit de développement logiciel (SDK) Auth Cet article et les articles de flotte qui le suivent

Le runtime de flotte sélectionne l’identité d’un agent pour chaque opération. Suivez les exemples de flotte tout au long de ce parcours : les didacticiels sur l’agent cloud utilisent une identité configurée et omettent la sélection d’identité par demande requise par une flotte.

Components

Component Purpose Cardinality
Blueprint d’identité de l’agent Définit les autorisations, l’étendue entrante et les rôles d’application de la flotte. Crée et supprime des identités d’agent. Un par flotte, ou un par type d’agent
Informations d’identification de Blueprint Authentifie le runtime en tant que blueprint. Utilisez des informations d’identification fédérées d’identité managée en production. Un par plan
Identité de l’agent Représente un agent. Reçoit les jetons d’accès utilisés pour appeler des API. Un par agent
Compte d’utilisateur de l’agent Donne à un agent un objet utilisateur pour les charges de travail Microsoft 365 telles qu’une boîte aux lettres ou une appartenance à une équipe Teams. Facultatif, au plus un par identité d’agent
Répertoire des agents Magasin du runtime qui mappe chaque agent à son identité d’agent et au compte d’utilisateur de l’agent. Un élément par flotte
Service de provisionnement Crée et supprime des identités lorsque les agents sont déployés et mis hors service. Un par parc
Courtier de jetons Obtient des jetons pour une identité d’agent donnée. Microsoft.Identity.Web dans le processus d’exécution ou le side-car du Kit de développement logiciel (SDK) Auth. Un ou plusieurs par runtime

Cycle de vie de l’agent

  1. Déployer. Un utilisateur ou un pipeline déploie un nouvel agent sur le runtime.
  2. Disposition. Le service de provisionnement crée une identité d’agent à partir du modèle. Si l'agent a besoin des fonctionnalités utilisateur de Microsoft 365, il crée également le compte d'utilisateur d'un agent. Il enregistre les ID dans le répertoire de l’agent et l’identité de l’agent reçoit l’accès dont cet agent a besoin.
  3. Courir. Pour chaque opération, le runtime recherche l’identité de l’agent dans le répertoire de l’agent et la transmet au répartiteur de jetons.
  4. Retirer. Le service d’approvisionnement supprime le compte d’utilisateur de l’agent, puis l’identité de l’agent, puis supprime l’entrée d’annuaire de l’agent.

Choisir la façon dont les agents sont provisionnés

Option Fonctionnement Utilisez-le quand
Le runtime provisionne des identités Le service de provisionnement s'authentifie en tant que plan et appelle Microsoft Graph pour créer et supprimer des identités d'agent et des comptes d'utilisateur de l'agent. Le runtime contrôle le déploiement de l’agent.
Agent 365 provisionne des identités Agent 365 crée l’identité de l’agent lorsqu’un agent est provisionné. Le runtime écoute les événements de provisionnement de l’agent, qui incluent l’ID d’identité de l’agent, et enregistre cet ID dans le répertoire de l’agent. Les agents sont créés via des expériences Microsoft 365. Pour plus d’informations, consultez la documentation du développeur Agent 365.

Les deux options produisent la même entrée de répertoire d’agent. Le reste des conseils sur la flotte s’applique à l’une ou l’autre des options.

Sélectionnez l’identité de l’agent sur chaque requête

Les identifiants du blueprint peuvent acquérir des jetons pour chaque identité d’agent créée à partir du blueprint. Le code d’exécution qui choisit l’identité de l’agent est donc une limite de sécurité.

  • Résolvez l’identité de l’agent à partir du répertoire de l’agent à l’aide d’une clé que le runtime contrôle, telle que son propre ID d’agent.
  • N’acceptez pas l’ID client d’identité de l’agent ou l’ID de compte d’utilisateur de l’agent à partir d’une requête, d’une invite ou d’une sortie d’outil.
  • Vérifiez que l’appelant est autorisé à utiliser l’agent cible avant de demander un jeton.

Planifier les limites de confiance

  • Gardez les informations d’identification hors du code de l’agent. Maintenez les informations d’identification du blueprint dans le runtime ou dans le side-car, jamais dans le code que contrôle un auteur d’agent ou un modèle.
  • Isoler le répartiteur de jetons. Si les agents exécutent du code non approuvé ou fourni par le client, ne laissez pas ce code appeler directement le broker de jetons. Un processus qui peut atteindre le broker peut demander un jeton pour n’importe quel agent dans la flotte.
  • Séparez le provisionnement de l’acquisition de jetons. Le service de provisionnement utilise des jetons de modèle qui peuvent créer et supprimer des identités. Exécutez-le avec son propre chemin d’accès afin que le code de l’agent ne puisse pas demander ces jetons.
  • Limitez le périmètre d’impact. Utilisez plusieurs blueprints lorsque des groupes d’agents s’exécutent dans différentes zones de confiance ou appartiennent à différents clients.

Planification des limites

Un principal de blueprint peut créer au maximum 250 identités d’agent. Pour une flotte plus grande, créez davantage de blueprints et affectez chaque agent à un blueprint lorsqu’il est approvisionné. Enregistrez le blueprint dans l’entrée de répertoire de l’agent. Pour plus d’informations, consultez Principals du blueprint d’identité d’agent.

Les articles d’implémentation qui suivent utilisent un blueprint par configuration d’exécution. Si vous les étendez à plusieurs blueprints, résolvez également la configuration et les informations d’identification correspondantes pour chaque agent ; La sélection d’un ID d’agent seul ne sélectionne pas un autre blueprint. L’exemple d’enregistrement de répertoire doit être étendu pour ce modèle.

Accorder l’accès à chaque agent

Donnez à chaque identité de l’agent uniquement l’accès dont cet agent a besoin. Accordez des autorisations d’application, des autorisations déléguées, des attributions de rôles Azure et un accès à d’autres ressources directement à l’identité de l’agent, dans le cadre de l’approvisionnement ou peu après. Les subventions par agent conservent l’accès de chaque agent séparément. Vous pouvez donc passer en revue, modifier ou révoquer l’accès d’un agent sans affecter le reste de la flotte. Pour connaître les façons d’accorder l’accès, consultez Accorder des autorisations d’application et accorder des autorisations déléguées.

Pour les autorisations dont chaque agent de la flotte a besoin, vous pouvez utiliser des autorisations pouvant être héritées comme commodité. Un administrateur accorde ces autorisations une fois sur le principal du plan, et chaque identité d’agent créée à partir du plan les reçoit dans ses jetons. Les autorisations héritées n’apparaissent pas sur l’identité de l’agent. Par conséquent, les autorisations accordées par agent sont plus faciles à auditer.

Acheminer les demandes des utilisateurs vers les agents

Les utilisateurs contactent un agent de flotte avec un jeton d’accès pour la portée du blueprint access_agent. Chaque agent dans la flotte partage ce public, de sorte que le jeton prouve qui est l’utilisateur, mais n’identifie pas l’agent. Le runtime doit :

  1. Déterminez l’agent cible à partir de la requête, par exemple à partir d’un segment de routage.
  2. Vérifiez que l’utilisateur est autorisé à utiliser cet agent. Les rôles d’application sur le blueprint s’appliquent à l’ensemble de la flotte. Par conséquent, appliquez l’accès par agent dans le runtime.
  3. Utilisez l’identité de l’agent cible pour toute demande de jeton OBO (On-Behalf-Of).

Étape suivante

Configurer un blueprint d’identité d’agent pour une flotte