Cómo compartir un agente de flujo de trabajo

Acceso anticipado : Agente de flujo de trabajo

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio y las Condiciones Adicionales para Productos de IA Generativa en Versión Preliminar. Las funciones de la fase previa a la DG están disponibles "tal como están" y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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

Con el uso compartido de agentes, puedes hacer lo siguiente:

• Compartir agentes 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 agentes de flujo de trabajo compartidos para personalizar sus pasos

Según la configuración 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 agente.

Precaución: Cuando compartes un agente, también compartes el acceso a todas sus fuentes de datos y archivos asociados. Los usuarios pueden consultar al agente sobre el contenido de estas fuentes, incluso si no tienen acceso directo a los archivos o a las fuentes de datos.

Por ejemplo, si subes un archivo confidencial a la sección de conocimiento del agente y, luego, lo compartes, cualquier usuario con acceso puede hacerle preguntas al agente sobre el contenido de ese archivo.

Cómo compartir un agente de flujo de trabajo

Para compartir un agente de flujo de trabajo, haz lo siguiente:

App

1. Abre la 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 que deseas compartir.

   Nota: Puedes compartir un agente 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 agente.

   Nota: Puedes compartir tu agente 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 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 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 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 la configuración de control de funciones de la app para requerir la revisión y aprobación del administrador para compartir agentes en la app.

De forma predeterminada, los propietarios de los agentes no pueden compartirlos con grupos. Sin embargo, el administrador de la app de Gemini Enterprise puede elegir que los agentes 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 agente requiere la revisión y aprobación del administrador. Las revisiones posteriores del agente no necesitan volver a aprobarse.

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

1. El propietario del agente 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 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 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 agente compartido

Cuando el propietario de un agente comparte un agente de flujo de trabajo contigo, puedes acceder a su configuración de gráfico y obtener una vista previa. Si bien el gráfico de 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 agente.

App

1. Abre la 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 agente de flujo de trabajo compartido que deseas ver. El agente 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 agente compartido está suspendido o desactivado, el lienzo de Workflow Builder no se renderiza, pero puedes ver sus ejecuciones.

5. Opcional: Para realizar una ejecución de prueba manual del flujo de trabajo del agente, 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 un conector que usa el flujo de trabajo no está autorizado, 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 agente compartido son específicos del usuario. Puedes configurar un programa de ejecución personalizado o filtros de eventos para ejecutar un agente compartido de forma automática.

Para configurar tus propios activadores, haz lo siguiente:

App

1. Abre la 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 agente de 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 agente de flujo de trabajo en el lienzo del editor de Workflow Builder, haz clic en el título del agente y selecciona Configurar activadores.

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

   • Programación: Selecciona Ejecutar según una programación y configura cuándo se ejecutará el agente por ti (como 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 agente por ti. 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 agente en lugar del activador), habilita y autoriza los conectores en el editor del lienzo de Workflow Builder cuando se te solicite.

7. Haz clic en Guardar. Se guardará el activador y se ejecutará el agente de forma automática. Puedes activar el agente de forma manual para obtener una vista previa de lo que sucederá cuando el programa o el activador de eventos ejecuten este agente. Si quieres que el agente deje de ejecutarse, selecciona No ejecutar en eventos de la app o No ejecutar según una programación en la ventana 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 agente de 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 agentes de flujo de trabajo.

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

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

Para crear un duplicado editable del agente compartido, haz lo siguiente:

App

1. Abre la 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 agente de flujo de trabajo compartido que deseas copiar.
4. En el lienzo del editor de Workflow Builder, haz clic en el título del agente y selecciona Crear una copia. La copia se agregará a tu lista de Tus agentes.

Dependencias de agentes compartidos

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

• Requisitos de acceso: Cuando compartes un agente superior o cuando importas un agente a tu agente, asegúrate de que todos los usuarios de tu lista de acceso también tengan acceso a todos los subagentes importados.
• Errores de ejecución: Si un usuario ejecuta un agente sin acceso a un subagente importado, la ejecución falla con un mensaje en el que se le pide que solicite acceso al propietario.

Consideraciones

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

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

• 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?

• Obtén información para crear un agente de flujo de trabajo.
• Obtén información para editar un agente de flujo de trabajo.
• Obtén información para administrar versiones de agentes de flujo de trabajo.
• Obtén información para supervisar las ejecuciones de agentes de flujo de trabajo.