Partager un agent de chat

Partagez les agents de chat que vous avez créés et lancés à l'aide de Workflow Builder avec d'autres utilisateurs de votre organisation. Selon les configurations de contrôle des fonctionnalités de votre application Web, vous aurez peut-être besoin qu'un administrateur de l'application Gemini Enterprise examine et approuve le partage d'un agent de chat.

Attention : Lorsque vous partagez un agent, tenez compte des comportements d'accès aux données suivants :

• Fichiers de connaissances : tout utilisateur ayant accès à l'agent partagé peut interroger et afficher les informations des fichiers importés dans la section Connaissances de l'agent, même s'il n'a pas d'accès direct ni d'autorisations sur les fichiers sources. Par exemple, si vous importez un fichier confidentiel dans la section Connaissances, tous les utilisateurs ayant accès à l'agent partagé peuvent poser des questions sur le contenu de ce fichier.
• Connecteurs et datastores : lorsqu'un agent accède à des données via des connecteurs, les listes de contrôle d'accès (LCA) et les autorisations des utilisateurs sont conservées. Les utilisateurs ne peuvent interroger et récupérer des données qu'à partir des datastores et des connecteurs auxquels leurs comptes utilisateur individuels sont autorisés à accéder.

Partager un agent de chat

Pour partager un agent de chat, procédez comme suit :

Application

1. Ouvrez l'application Gemini Enterprise et accédez à la page Agent Gallery.

   La page Galerie d'agents s'affiche. Elle présente tous les agents prédéfinis et personnalisés.

2. Dans la section Vos agents, recherchez l'agent de chat que vous souhaitez partager.

   Remarque : Vous ne pouvez pas partager un agent de chat qui est à l'état draft.

3. Cliquez sur Menu d'actions, puis sélectionnez Partager.

4. Dans la boîte de dialogue de partage, saisissez les adresses e-mail des utilisateurs avec lesquels vous souhaitez partager l'agent. Vous pouvez également cliquer sur Copier le lien pour générer un lien partageable.

   Remarques :

   • Vous pouvez partager votre agent de chat avec des adresses e-mail d'utilisateurs individuels. Le partage avec des groupes Google n'est pas possible.
   • Si votre application Web est connectée à un datastore de recherche de personnes avec la saisie semi-automatique configurée pour les données utilisateur, la boîte de dialogue de partage fournit des suggestions de saisie automatique lorsque vous saisissez des adresses e-mail d'utilisateurs.

5. Cliquez sur OK.

   L'agent de chat est partagé avec les utilisateurs de votre liste d'accès.

   Remarque : Si l'administrateur de votre application Web a activé l'examen par l'administrateur pour le partage d'agents, une demande de partage est envoyée à l'administrateur de l'application pour examen et approbation. Une fois que l'administrateur de l'application a approuvé la demande, l'agent de chat est partagé avec les utilisateurs de la liste d'accès. Vous pouvez à tout moment modifier la demande de partage pour ajouter ou supprimer des utilisateurs, ou l'annuler.

Contrôle de l'examen par l'administrateur

Par défaut, les propriétaires d'agents peuvent partager leurs agents avec n'importe quel utilisateur de leur organisation sans l'approbation d'un administrateur d'application. Toutefois, les administrateurs de l'application peuvent modifier les configurations de contrôle des fonctionnalités de l'application pour exiger l'examen et l'approbation d'un administrateur pour le partage d'agents dans l'application.

Le partage d'agents suit un processus en deux étapes lorsque l'examen par l'administrateur est activé :

1. Le propriétaire de l'agent partage l'agent avec un ou plusieurs utilisateurs.
2. L'administrateur de l'application examine la demande de partage, puis l'approuve ou la refuse.

Examiner une demande de partage

Les administrateurs d'applications sont chargés d'examiner et de gérer les demandes de partage d'agents.

Remarques :

• Cette section ne s'applique que si la fonctionnalité Activer le partage d'agent sans l'approbation de l'administrateur est désactivée dans les contrôles des fonctionnalités de l'application.
• Seuls les administrateurs d'application disposant du rôle IAM Administrateur Gemini Enterprise peuvent examiner et approuver les demandes de partage.

Console

Pour examiner une demande de partage en tant qu'administrateur d'application, procédez comme suit :

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

   Gemini Enterprise

2. Cliquez sur le nom de l'application contenant l'agent.

3. Dans le menu de navigation de l'application, cliquez sur Agents.

4. Recherchez l'agent avec l'action Examiner la demande de partage dans la colonne Autorisations utilisateur.

   

5. Cliquez sur Examiner la demande de partage.

6. Dans le volet Demande de partage :

   • Examinez la liste d'accès sous Demande de partage avec les utilisateurs suivants.
   • Facultatif : Modifiez la liste d'accès pour ajouter ou supprimer des comptes utilisateur, des groupes Google ou des pools d'identités Workforce Identity Federation (WIF).

7. Pour approuver la demande et accorder l'accès, cliquez sur Approuver et activer.

8. Pour refuser la demande, cliquez sur Refuser.

Limites de partage

Lorsque vous partagez un agent de chat, les limites suivantes s'appliquent :

• Maximum de 1 500 comptes individuels : Gemini Enterprise gère l'accès des agents à l'aide des stratégies d'autorisation IAM Google Cloud sous-jacentes, qui appliquent une limite stricte de 1 500 membres par stratégie. Si vous partagez un agent avec plus de 1 500 comptes utilisateur individuels,l'opération échoue avec l'erreur suivante :

  The number of members in the policy (1,501) is larger than the maximum allowed size 1,500.
  

Pour obtenir la liste complète des contraintes du système, consultez Quotas et limites de Workflow Builder.

Remarques

• Lorsque vous partagez un agent de chat, les utilisateurs peuvent interroger le contenu des fichiers importés dans la section Connaissances, qu'ils aient ou non un accès direct à ces fichiers. En revanche, les données accessibles via des connecteurs continuent de respecter les autorisations de l'utilisateur et les listes de contrôle d'accès (LCA).
• Les administrateurs de l'application peuvent ajouter et supprimer des utilisateurs de la liste d'accès à tout moment.
• Seuls les administrateurs de l'application peuvent partager l'agent avec des groupes Google et des pools d'identités de fédération d'identité de personnel (WIF) de votre organisation.
• Les propriétaires d'agents peuvent supprimer n'importe quel utilisateur de la liste d'accès à tout moment (y compris ceux ajoutés par l'administrateur de l'application).
• Les administrateurs d'application peuvent transférer la propriété d'un agent de chat partagé à un autre utilisateur ou à eux-mêmes dans la console Google Cloud . Pour en savoir plus, consultez Transférer la propriété d'un agent.
• Vous pouvez également partager un agent de chat depuis le canevas du générateur d'agents de chat.

Étapes suivantes

• Découvrez comment utiliser un agent de chat.
• Découvrez comment planifier des exécutions d'agent de chat.
• Découvrez comment modifier un agent de chat.
• Découvrez comment supprimer un agent de chat.
• Consultez les quotas et limites de Workflow Builder.