Partager des agents depuis la console Google Cloud

Cette page explique comment partager des agents avec les utilisateurs de votre organisation et comment les administrateurs peuvent transférer la propriété des agents partagés. En tant qu'administrateur, vous pouvez partager les agents disponibles (créés par Google, par des employés ou personnalisés) avec des utilisateurs individuels, des groupes, des groupes de pools d'identités des employés ou tous les utilisateurs de votre organisation. Vous pouvez également transférer la propriété des agents créés par des employés que vous avez partagés à vous-même ou à un autre utilisateur. Pour en savoir plus sur les différents types d'agents disponibles dans Gemini Enterprise, consultez Présentation des agents.

Remarque : Pour partager des agents créés par des employés, vous devez avoir créé un ou plusieurs agents à l'aide de Workflow Builder dans votre application Web Gemini Enterprise. Pour savoir comment créer des agents à l'aide de Workflow Builder, consultez Créer un agent à l'aide de Workflow Builder.

Avant de commencer

Avant de pouvoir partager un agent, vous devez remplir les conditions suivantes :

1. Vous devez disposer d'une application Web Gemini Enterprise existante. Pour en créer une, consultez Créer une application.

2. Pour partager des agents personnalisés, vous devez les avoir enregistrés ou ajoutés à Gemini Enterprise à l'aide de l'une des options suivantes :

   • Enregistrer et gérer des agents A2A
   • Enregistrer et gérer les agents ADK hébergés sur Agent Runtime dans Gemini Enterprise Agent Platform
   • Ajouter et gérer des agents A2A depuis Google Cloud Marketplace
   • Enregistrer et gérer des agents Dialogflow

Partager un agent

Pour partager un agent, procédez comme suit :

Console

1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

Accéder à Gemini Enterprise

1. Sélectionnez votre projet.

2. Cliquez sur votre application dans la colonne Nom. Le menu de navigation est mis à jour.

3. Dans le menu de navigation, cliquez sur Agents.

4. Cliquez sur le nom à afficher de l'agent que vous souhaitez partager.

5. Cliquez sur l'onglet Autorisations utilisateur. La page Utilisateurs autorisés s'affiche.

6. Cliquez sur Ajouter un utilisateur. La boîte de dialogue Ajouter des rôles avec des autorisations utilisateur à l'agent s'affiche.

7. Configurez les détails de l'autorisation :

   1. Sélectionnez l'une des options suivantes dans la section Type de membre :

      • Utilisateur : un utilisateur final individuel. Pour que ce type de membre fonctionne, vous devez inclure le rôle IAM approprié. Pour en savoir plus, consultez Rôles et autorisations IAM.

      • Groupe : ensemble d'utilisateurs finaux. Pour que ce type de membre fonctionne, vous devez inclure le rôle IAM approprié. Pour en savoir plus, consultez Rôles et autorisations IAM.

      • Principal : identité unique dans un groupe de pool d'identités de personnel, qui inclut les groupes externes non gérés par Google.

      • Pool d'identités de personnel : toutes les identités d'un pool d'identités de personnel.

      • Tous les utilisateurs : tous les utilisateurs de l'organisation.

   2. Saisissez l'identifiant unique du membre et sélectionnez un rôle :

      Type de membre	Description
      Utilisateur	Saisissez les adresses e-mail des membres dans le champ Membre. Sélectionnez un rôle dans le champ Attribuer un rôle.
      Groupe	Saisissez les adresses e-mail des membres dans le champ Membre.  Sélectionnez un rôle dans le champ Attribuer un rôle.
      Principal	Une identité unique dans un pool d'identités de charge de travail.
      Pool d'identités de personnel	Saisissez l'identifiant du compte principal dans le champ Membre.  Sélectionnez un rôle dans le champ Attribuer un rôle. Pour obtenir des exemples d'ensembles de comptes principaux, consultez Ensembles de comptes principaux.
      Tous les utilisateurs	Sélectionnez un rôle dans le champ Attribuer un rôle.

8. Cliquez sur Enregistrer.

Ensembles de principaux

Voici des exemples d'ensembles de principaux que vous pouvez spécifier pour le type de membre Pool d'identités de personnel :

Ensemble principal	Description
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID	Identité unique dans un pool d'identités de charge de travail.
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/group/GROUP_ID	Toutes les identités d'employés d'un groupe.
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE	Toutes les identités d'employés porteuses d'une valeur d'attribut spécifique.
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/*	Toutes les identités d'un pool d'identités de personnel.

Remplacez les espaces réservés suivants par des valeurs dans l'exemple de code :

• PROJECT_NUMBER : numéro utilisé dans le chemin d'accès aux ressources pour identifier un projet Google Cloud spécifique.
• GROUP_ID : identifiant de groupe spécifique provenant d'un fournisseur d'identité (IdP) externe, qui vous permet d'accorder l'accès à tous les membres de ce groupe.
• POOL_ID : ID unique du pool d'identités de personnel que vous créez dans Google Cloud.
• SUBJECT_ID : identifiant de sujet unique pour une identité unique dans un pool d'identités de personnel.
• ATTRIBUTE_NAME : nom défini par l'utilisateur d'un attribut personnalisé que vous avez mappé à partir d'un fournisseur d'identité externe.
• ATTRIBUTE_VALUE : valeur spécifique de ATTRIBUTE_NAME utilisée pour restreindre l'accès.

Transférer la propriété d'un agent

En tant qu'administrateur, vous pouvez transférer la propriété d'un agent partagé à un autre utilisateur de votre organisation ou à vous-même. Cette fonctionnalité est utile dans les scénarios suivants :

• Employés sur le départ : transférez les agents créés par les employés qui quittent l'organisation aux membres actifs de l'équipe pour assurer une maintenance continue.
• Transfert de prestataires : transfert des agents créés par des employés temporaires ou contractuels au personnel à temps plein.
• Restructuration de l'équipe : réaffectation des responsabilités des agents à mesure que les rôles ou les projets évoluent.

Remarques et limites

Avant de transférer la propriété d'un agent, tenez compte des points et des limites suivants :

• Autorisation d'administrateur : seuls les administrateurs disposant du rôle Administrateur Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) ou Administrateur Discovery Engine (roles/discoveryengine.admin) peuvent transférer la propriété d'un agent. Le propriétaire actuel de l'agent ne peut pas transférer la propriété, sauf s'il est également administrateur.
• Agents partagés uniquement : vous ne pouvez transférer la propriété que des agents déjà partagés. Sur la page Agents de la console Google Cloud , la colonne Partage de l'agent doit afficher Activé. Les agents privés (non partagés) ne peuvent pas être transférés.
• Propriétaire unique : chaque agent ne peut avoir qu'un seul propriétaire. Lorsque la propriété est transférée, le destinataire sélectionné devient le seul propriétaire de l'agent.
• Accès de l'ancien propriétaire : lorsque la propriété est transférée, l'ancien propriétaire est rétrogradé au rôle agentUser sur l'agent. Ils conservent l'autorisation d'interroger et d'exécuter l'agent, mais ne peuvent plus modifier sa configuration ni ses paramètres.
• Types d'agents compatibles : le transfert de propriété est compatible avec les agents créés par les employés (agents low-code et de workflow créés dans l'application Web).
• Agents avec des programmations ou des déclencheurs : si l'agent transféré possède un déclencheur de programmation ou d'événement, l'opération de transfert les marque comme programmations ou événements désactivés. Le nouveau propriétaire doit activer le déclencheur de programmation ou d'événement avant de pouvoir utiliser l'agent.

Transférer la propriété d'un agent

Pour transférer la propriété d'un agent, procédez comme suit :

Console

1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

   Accéder à Gemini Enterprise

2. Sélectionnez votre projet.

3. Cliquez sur votre application dans la colonne Nom. Le menu de navigation est mis à jour.

4. Dans le menu de navigation, cliquez sur Agents.

5. Cliquez sur le nom à afficher de l'agent partagé.

6. Cliquez sur l'onglet Autorisations de l'utilisateur. La liste Utilisateurs autorisés s'affiche.

7. Cliquez sur Transférer la propriété. La boîte de dialogue Transférer la propriété s'ouvre.

8. Sous Transférer la propriété à, choisissez l'une des options suivantes :

   • Moi-même : transférez la propriété de l'agent vers votre compte administrateur actuel. Cette option est désactivée si vous possédez déjà l'agent.
   • Un autre utilisateur : transférez la propriété à un autre utilisateur de votre organisation.

9. Si vous avez sélectionné Un autre utilisateur, spécifiez le nouveau propriétaire :

   • Google Identity et Cloud Identity : saisissez l'adresse e-mail de l'utilisateur dans le champ Adresse e-mail du nouveau propriétaire (par exemple, [e-mail]).
   • Comptes de fédération des identités des employés (WIF) : saisissez l'identifiant du compte principal unique dans le champ Nouveau compte principal propriétaire :

   //iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID
   

   Vous pouvez également inclure le préfixe principal: :

   principal://iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID
   

   Remplacez les éléments suivants :

   • POOL_ID : ID unique de votre pool d'identités de personnel.
   • SUBJECT_ID : identifiant du sujet de l'utilisateur dans le pool d'identités de personnel.
   Remarque : Les identifiants principaux de la fédération d'identité de personnel sont sensibles à la casse. Assurez-vous que l'identifiant correspond exactement à la casse configurée dans le mappage google.subject de votre fournisseur d'identité.

10. Cliquez sur Transférer la propriété.

    Le propriétaire de l'agent est mis à jour. L'ancien propriétaire est conservé en tant qu'utilisateur autorisé avec le rôle agentUser.

    Remarque : Si l'agent transféré dispose d'un déclencheur de planification ou d'événement, l'opération de transfert les marque comme des planifications ou des événements désactivés. Le nouveau propriétaire doit activer le déclencheur avant de pouvoir utiliser l'agent.