Cómo compartir un flujo de trabajo

Comparte los flujos de trabajo que creaste y lanzaste con Workflow Builder con otros usuarios de tu organización.

Con el uso compartido de flujos de trabajo, puedes hacer lo siguiente:

• Compartir flujos de trabajo activos con usuarios y grupos de tu organización
• Configurar programas de ejecución personalizados o activadores basados en eventos
• Hacer un seguimiento de las ejecuciones de vista previa y las ejecuciones automatizadas
• Duplicar flujos de trabajo compartidos para personalizar sus pasos

Según las configuraciones de control de funciones de tu app, es posible que necesites que un administrador revise y apruebe tu solicitud antes de que puedas compartir un flujo de trabajo.

Si compartes un flujo de trabajo, las personas con las que lo compartiste verán y usarán la versión activa.

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 Knowledge 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 Knowledge, 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 del usuario. 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 flujo de trabajo

Para compartir un flujo de trabajo, 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 los agentes personalizados.

2. En la sección Your agents, busca el flujo de trabajo que deseas compartir.

   Nota: Puedes compartir un flujo de trabajo que esté en estado draft, pero otros usuarios no podrán ejecutarlo hasta que esté activado.

3. En el encabezado superior derecho del lienzo de Workflow Builder, haz clic en Compartir.

4. Ingresa las direcciones de correo electrónico de los usuarios o los Grupos de Google con los que quieres compartir el flujo de trabajo.

   Nota: Puedes compartir tu flujo de trabajo con direcciones de correo electrónico de usuarios individuales. El uso compartido con Grupos de Google no está habilitado para usuarios finales. Un administrador de la app de Gemini Enterprise o cualquier usuario con el rol de Administrador de Discovery Engine (discoveryengine.admin) puede habilitar el uso compartido de grupos a nivel de la app de Gemini Enterprise.

5. Haz clic en Listo.

   Nota: Si el administrador de tu app habilitó la revisión del administrador para el uso compartido de flujos de trabajo, 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 flujo de trabajo se compartirá con las personas que se encuentren en 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 flujos de trabajo pueden compartir sus flujos de trabajo 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 aprobación del administrador para compartir flujos de trabajo en la app.

De forma predeterminada, los propietarios de flujos de trabajo no pueden compartir sus flujos de trabajo con grupos. Sin embargo, el administrador de la app de Gemini Enterprise puede elegir que los flujos de trabajo se puedan compartir con Grupos de Google, con o sin la aprobación del administrador.

El proceso de uso compartido

Solo el uso compartido inicial de un flujo de trabajo requiere la revisión y aprobación del administrador. Las revisiones posteriores del flujo de trabajo no necesitan volver a aprobarse.

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

1. El propietario del flujo de trabajo lo comparte con uno o más usuarios o Grupos de Google.

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 flujos de trabajo.

Notas:

• Esta sección solo se aplica si la función Habilitar el uso compartido de flujos de trabajo 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 flujo de trabajo.

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

4. Busca el flujo de trabajo 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 WIF.

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

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

Cómo usar un flujo de trabajo compartido

Cuando el propietario de un flujo de trabajo lo comparte contigo, puedes acceder a su configuración de gráfico y obtener una vista previa. Si bien el gráfico del flujo de trabajo es de solo lectura para los usuarios compartidos, puedes ejecutar una vista previa de forma manual, configurar tus propios parámetros de configuración de activadores, ver tu propio historial de ejecuciones, o crear una copia del flujo de trabajo.

App

1. Abre tu app web de Gemini Enterprise en un navegador.
2. En el menú de navegación de la app web, haz clic en Agentes.
3. Ve a la sección Compartidos conmigo > De tu organización.

4. Haz clic en el flujo de trabajo compartido que deseas ver. El flujo de trabajo se inicia en un diseño de diseñador de solo lectura, en el que se muestra el gráfico de nodos activos. Nota: Si el flujo de trabajo compartido está suspendido o desactivado, el lienzo de Workflow Builder no se renderiza y no puedes ejecutarlo, pero puedes ver sus ejecuciones anteriores.

5. Opcional: Para realizar una ejecución de prueba manual del flujo de trabajo, haz lo siguiente:

   • Haz clic en Vista previa en el encabezado superior derecho del lienzo de Workflow Builder.
   • Ejecuta la vista previa. Si la ejecución de vista previa falla porque no está autorizado un conector que usa el flujo de trabajo, haz clic en Habilitar conectores debajo del mensaje de error para completar el flujo de OAuth.

Cómo configurar tus propios activadores

Los activadores de un flujo de trabajo compartido son específicos del usuario. Puedes configurar un programa de ejecución personalizado o filtros de eventos para ejecutar un flujo de trabajo compartido automáticamente.

Para configurar tus propios activadores, haz lo siguiente:

App

1. Abre tu app web de Gemini Enterprise en un navegador.
2. En el menú de navegación de la app web, haz clic en Agentes > Galería.
3. Ve a la sección Compartidos conmigo > De tu organización y haz clic en el flujo de trabajo compartido para el que deseas configurar un activador.

4. Accede a la configuración del activador:

   • Selecciona el menú Acciones > Configurar activadores.
   • Como alternativa, abre el flujo de trabajo en el lienzo del editor de Workflow Builder, haz clic en el nombre del flujo de trabajo y selecciona Configurar activadores.

5. Puedes configurar un activador con uno de los siguientes modos:

   • Programación: Selecciona Ejecutar según una programación y configura cuándo se ejecutará el flujo de trabajo (por ejemplo, la frecuencia y la zona horaria).
   • Evento: Selecciona Ejecutar en eventos de la app y configura los filtros de eventos para especificar cuándo se ejecutará el flujo de trabajo. Por ejemplo, para un activador de eventos de Google Drive, puedes filtrar por campos como Propietarios (como un ID de Google como janedoe), Nombre, tipo de MIME, Hora de modificación o Carpeta superior. Selecciona un operador (como contiene o es igual a), ingresa un valor y combina varias reglas con las condiciones Y o O.

6. Si el flujo de trabajo usa conectores que requieren autenticación (por ejemplo, conectores que se usan en un paso del flujo de trabajo en lugar del activador en sí), habilita y autoriza los conectores en el editor del lienzo de Workflow Builder cuando se te solicite.

7. Haz clic en Guardar. Se guarda el activador y se ejecuta el flujo de trabajo automáticamente. Puedes activar el flujo de trabajo de forma manual para obtener una vista previa de lo que sucederá cuando el programa o el activador de eventos ejecuten este flujo de trabajo. Si quieres que el flujo de trabajo deje de ejecutarse, selecciona No ejecutar en eventos de la app o No ejecutar según una programación en el diálogo Configurar activadores.

Cómo ver tus ejecuciones

Para ver tus ejecuciones, haz lo siguiente:

App

1. En el menú de navegación de la app web, haz clic en Agentes.
2. Ve a la sección Compartidos conmigo > De tu organización y haz clic en el flujo de trabajo compartido.
3. En el lienzo de Workflow Builder, haz clic en la pestaña Ejecuciones.
4. Haz clic en una ejecución específica para ver sus registros de ejecución y el seguimiento paso a paso.

Para obtener más información, consulta Ejecuciones de flujos de trabajo.

Cómo crear una copia de un flujo de trabajo compartido

Los flujos de trabajo compartidos son de solo lectura para los usuarios compartidos, excepto por sus configuraciones de activadores. Si deseas editar y personalizar los pasos de un flujo de trabajo compartido, puedes crear una copia en tu propio espacio de trabajo.

Para crear un duplicado editable del flujo de trabajo compartido, haz lo siguiente:

App

1. Abre tu app web de Gemini Enterprise en un navegador.
2. En el menú de navegación de la app web, haz clic en Agentes > Galería.
3. Ve a la sección Compartidos conmigo > De tu organización y haz clic en el flujo de trabajo compartido que deseas copiar.
4. En el lienzo del editor de Workflow Builder, haz clic en el título del flujo de trabajo y selecciona Crear una copia. La copia se agrega a tu lista Tus agentes.

Dependencias de flujos de trabajo compartidos

Si tu flujo de trabajo importa y hace referencia a otros flujos de trabajo (subflujos) en sus pasos, ten en cuenta lo siguiente:

• Requisitos de acceso: Cuando compartes un flujo de trabajo superior o cuando importas un flujo de trabajo a tu flujo de trabajo, asegúrate de que todos los usuarios de tu lista de acceso también tengan acceso a todos los subflujos importados.
• Errores de ejecución: Si un usuario ejecuta un flujo de trabajo sin acceso a un subflujo importado, la ejecución falla con un mensaje en el que se le solicita que le pida acceso a el propietario.

Límites de uso compartido

Cuando se comparte un agente de flujo de trabajo, 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 Google Cloud IAM subyacentes, que aplican un límite máximo de 1,500 miembros por política. Si se comparte 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.
  

• Usa grupos para compartir a gran escala: Cada grupo de Google o Workspace cuenta como un solo miembro para el límite de política de 1,500 miembros. Si necesitas compartir un agente con cientos o miles de colegas en una organización, pídele al administrador de tu app que habilite el uso compartido de grupos y que ingrese las direcciones de correo electrónico de los grupos (por ejemplo, [e-mail]) en lugar de las cuentas de usuario individuales.

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

Consideraciones

• Si el propietario del flujo de trabajo activa una versión nueva o actualiza la versión publicada del flujo de trabajo, todos los usuarios compartidos ejecutarán automáticamente la nueva versión publicada en las ejecuciones posteriores.

• Si un flujo de trabajo está desactivado o suspendido, el lienzo de Workflow Builder no se renderiza y los usuarios compartidos no pueden ejecutar el flujo de trabajo, pero pueden ver sus historiales de ejecuciones y registros de sesiones anteriores en la galería Ejecuciones. Si el flujo de trabajo deja de compartirse, se inhabilita o se borra, los usuarios compartidos pierden todo el acceso, incluidos sus historiales de ejecuciones y registros de sesiones anteriores.

• Las acciones que modifican datos externos requieren la aprobación con interacción humana (HITL), excepto los correos electrónicos o los eventos de calendario que te envías a ti mismo.

¿Qué sigue?

• Aprende a crear un flujo de trabajo.
• Aprende a editar un flujo de trabajo.
• Aprende a administrar versiones de flujos de trabajo.
• Aprende a supervisar las ejecuciones de flujos de trabajo.
• Consulta las cuotas y los límites de Workflow Builder.