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 la configuración 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 compartas 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 podrán 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 los permisos y las listas de control de acceso (LCA) del usuario. Los usuarios solo pueden consultar y recuperar datos de los 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 la app de Gemini Enterprise y ve a la página de la Galería de agentes.

   Aparecerá la página Galería de agentes, en la que se mostrarán todos los agentes prediseñados y los agentes personalizados.

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

   Nota: No puedes compartir un agente de chat que se encuentre en estado draft.

3. Haz clic en el menú de acciones y selecciona Compartir.

4. En el diálogo para compartir, ingresa las direcciones de correo electrónico de los usuarios con los que quieres compartir el agente. También puedes hacer clic en Copiar vínculo 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 autocompletado configurada para los datos del usuario, el diálogo de uso compartido 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 del agente, 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 aprueba la solicitud, el agente de chat se comparte 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 agentes pueden compartir sus agentes 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 la configuración de control de funciones de la app para exigir la revisión y aprobación del administrador para los agentes de uso compartido 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 consola de Google Cloud , 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 al 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 la fuerza laboral (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 compartes 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 políticas de permisos de IAM subyacentes Google Cloud , 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á y se mostrará 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 (LCA).
• 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 los grupos de Google y los grupos de identidades de la federación de identidades de personal (WIF) de tu organización.
• Los propietarios del agente pueden quitar a cualquier usuario de la lista de acceso en cualquier momento (incluidos los que agregó el administrador de la app).
• Los administradores de la app pueden transferir la propiedad de un agente de chat compartido a otro usuario o a sí mismos en la consola de Google Cloud . Para obtener más información, consulta Cómo transferir la propiedad del agente.
• También puedes compartir un agente de chat desde el lienzo del creador de agentes de chat.

¿Qué sigue?

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