Cómo compartir un agente de chat

Comparte los agentes de chat que creaste y lanzaste con Workflow Builder con otros usuarios de tu organización. Según las configuraciones de control de funciones de tu app web, es posible que necesites que un administrador de la app de Gemini Enterprise revise y apruebe el uso compartido de un agente de chat.

Precaución: Cuando compartes un agente, ten en cuenta los siguientes comportamientos de acceso a los datos:

• Archivos de conocimiento: Cualquier usuario con acceso al agente compartido puede consultar y ver información de los archivos subidos a la sección Conocimiento del agente, incluso si no tiene acceso directo ni permisos para los archivos fuente. Por ejemplo, si subes un archivo confidencial a la sección Conocimiento, todos los usuarios con acceso al agente compartido pueden hacer preguntas sobre el contenido de ese archivo.
• Conectores y almacenes de datos: Cuando un agente accede a los datos a través de conectores, se conservan las listas de control de acceso (ACL) y los permisos de los usuarios. Los usuarios solo pueden consultar y recuperar datos de almacenes de datos y los conectores a los que sus cuentas de usuario individuales tienen autorización para acceder.

Cómo compartir un agente de chat

Para compartir un agente de chat, haz lo siguiente:

App

1. Abre tu app de Gemini Enterprise y ve a la página Galería de agentes.

   Aparecerá la página Galería de agentes , en la que se muestran todos los agentes precompilados y personalizados.

2. En la sección Tus agentes, busca el agente de chat que deseas compartir.

   Nota: No puedes compartir un agente de chat que esté en estado draft.

3. Haz clic en Menú Acciones y selecciona Compartir.

4. En el diálogo para compartir, ingresa las direcciones de correo electrónico de los usuarios con los que deseas compartir el agente. También puedes hacer clic en Copiar enlace para generar un vínculo para compartir.

   Notas:

   • Puedes compartir tu agente de chat con direcciones de correo electrónico de usuarios individuales. No se admite el uso compartido con Grupos de Google.
   • Si tu app web está conectada a un almacén de datos de Búsqueda de personas con la función de autocompletar configurada para los datos del usuario, el diálogo para compartir proporciona sugerencias de autocompletado a medida que ingresas las direcciones de correo electrónico de los usuarios.

5. Haz clic en Listo.

   El agente de chat se comparte con los usuarios de tu lista de acceso.

   Nota: Si el administrador de tu app web habilitó la revisión del administrador para el uso compartido de agentes, se enviará una solicitud de uso compartido al administrador de la app para su revisión y aprobación. Después de que el administrador de la app apruebe la solicitud, el agente de chat se compartirá con los usuarios de la lista de acceso. Puedes editar la solicitud de uso compartido en cualquier momento para agregar o quitar usuarios, o bien cancelar la solicitud.

Control de revisión del administrador

De forma predeterminada, los propietarios de los agentes pueden compartirlos con cualquier usuario de su organización sin la aprobación de un administrador de la app. Sin embargo, los administradores de la app pueden cambiar las configuraciones de control de funciones de la app para requerir la revisión y la aprobación del administrador para compartir agentes en la app.

El uso compartido de agentes sigue un proceso de dos pasos cuando se habilita la revisión del administrador:

1. El propietario del agente comparte el agente con uno o más usuarios.
2. El administrador de la app revisa la solicitud de uso compartido y la aprueba o rechaza.

Cómo revisar una solicitud de uso compartido

Los administradores de la app son responsables de revisar y administrar las solicitudes de uso compartido de agentes.

Notas:

• Esta sección solo se aplica si la función Habilitar el uso compartido de agentes sin la aprobación del administrador está inhabilitada en los controles de funciones de la app.
• Solo los administradores de la app con el rol de IAM de administrador de Gemini Enterprise pueden revisar y aprobar las solicitudes de uso compartido.

Console

Para revisar una solicitud de uso compartido como administrador de la app, haz lo siguiente:

1. En la Google Cloud consola de, ve a la página Gemini Enterprise > Apps.

   Gemini Enterprise

2. Haz clic en el nombre de la app que contiene el agente.

3. En el menú de navegación de la app, haz clic en Agentes.

4. Busca el agente con la acción Revisar solicitud de uso compartido en la columna Permisos del usuario.

   

5. Haz clic en Revisar solicitud de uso compartido.

6. En el panel Solicitud de uso compartido , haz lo siguiente:

   • Revisa la lista de acceso en Se solicitó compartir con los siguientes usuarios.
   • Opcional: Modifica la lista de acceso para agregar o quitar cuentas de usuario, Grupos de Google o grupos de identidades de la federación de identidades de personal (WIF).

7. Para aprobar la solicitud y otorgar acceso, haz clic en Aprobar y habilitar.

8. Para rechazar la solicitud, haz clic en Rechazar.

Límites de uso compartido

Cuando se comparte un agente de chat, se aplican los siguientes límites:

• Máximo de 1,500 cuentas individuales: Gemini Enterprise administra el acceso de los agentes con las políticas de permisos de Google Cloud IAM subyacentes, que aplican un límite máximo de 1,500 miembros por política. Si compartes un agente con más de 1,500 cuentas de usuario individuales, la operación fallará con el siguiente error:

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

Para obtener una lista completa de las restricciones del sistema, consulta Cuotas y límites de Workflow Builder.

Consideraciones

• Cuando compartes un agente de chat, los usuarios pueden consultar el contenido de los archivos subidos a la sección Conocimiento , independientemente del acceso directo a los archivos, mientras que los datos a los que se accede a través de conectores siguen respetando los permisos de los usuarios individuales y las listas de control de acceso (ACL).
• Los administradores de la app pueden agregar y quitar usuarios de la lista de acceso en cualquier momento.
• Solo los administradores de la app pueden compartir el agente con Grupos de Google y grupos de identidades de la federación de identidades de personal (WIF) en tu organización.
• Los propietarios de los agentes pueden quitar a cualquier usuario de la lista de acceso en cualquier momento (incluidos los que agregó el administrador de la app).
• También puedes compartir un agente de chat desde el lienzo del creador de agentes de chat.

¿Qué sigue?

• Obtén información para usar un agente de chat.
• Obtén información para programar ejecuciones de agentes de chat.
• Obtén información para editar un agente de chat.
• Obtén información para borrar un agente de chat.
• Consulta las cuotas y los límites de Workflow Builder.