Comparte agentes desde la consola de Google Cloud

En esta página, se explica cómo compartir agentes con usuarios de tu organización y cómo los administradores pueden transferir la propiedad de los agentes compartidos. Como administrador, puedes compartir los agentes disponibles (creados por Google, por empleados y personalizados) con usuarios individuales, grupos, grupos de Workforce Identity Pool o todos los usuarios de tu organización, y transferirte la propiedad de los agentes compartidos creados por empleados o a otro usuario. Para obtener más información sobre los diferentes tipos de agentes disponibles en Gemini Enterprise, consulta Descripción general de los agentes.

Nota: Para compartir agentes creados por empleados, debes tener uno o más agentes creados con Workflow Builder en tu app web de Gemini Enterprise. Para obtener información sobre cómo crear agentes con Workflow Builder, consulta Crea un agente con Workflow Builder.

Antes de comenzar

Antes de compartir un agente, debes cumplir con los siguientes requisitos:

1. Debes tener una app web de Gemini Enterprise existente. Para crear una app nueva, consulta Crea una app.

2. Para compartir agentes personalizados, debes haberlos registrado o agregado a Gemini Enterprise con cualquiera de las siguientes opciones:

   • Registra y administra agentes A2A
   • Registra y administra agentes del ADK alojados en Agent Runtime en Gemini Enterprise Agent Platform
   • Agrega y administra agentes A2A desde Google Cloud Marketplace
   • Registra y administra agentes de Dialogflow

Comparte un agente

Para compartir un agente, sigue estos pasos:

Console

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

Ir a Gemini Enterprise

1. Elige tu proyecto.

2. Haz clic en tu app en la columna Nombre. Se actualiza el menú de navegación.

3. Haz clic en Agentes en el menú de navegación.

4. Haz clic en el Nombre visible del agente que quieres compartir.

5. Haz clic en la pestaña Permisos del usuario para que se muestre la página Usuarios con permisos.

6. Haz clic en Agregar usuario. Aparecerá el cuadro de diálogo Agrega roles de permisos del usuario al agente.

7. Configura los detalles del permiso:

   1. Selecciona una de las siguientes opciones en la sección Tipo de miembro:

      • Usuario: Un usuario final individual. Para que este tipo de membresía funcione, debes incluir el rol de IAM correcto. Para obtener más información, consulta Roles y permisos de IAM.

      • Grupo: Es una colección de usuarios finales. Para que este tipo de membresía funcione, debes incluir el rol de IAM correcto. Para obtener más información, consulta Roles y permisos de IAM.

      • Principal: Es una identidad única en un grupo de Workforce Identity, que incluye grupos externos que no administra Google.

      • Grupo de identidades de personal: Todas las identidades en un grupo de identidades de personal.

      • Todos los usuarios: Todos los usuarios de la organización.

   2. Ingresa la identificación única del miembro y selecciona un rol:

      Tipo de miembro	Descripción
      Usuario	Ingresa las direcciones de correo electrónico en el campo Miembro. Selecciona un rol en el campo Asignar rol.
      Grupo	Ingresa las direcciones de correo electrónico en el campo Miembro. Selecciona un rol en el campo Asignar rol.
      Principal	Una identidad única dentro de una WIF.
      Grupo de identidad de personal	Ingresa el identificador de la principal en el campo Miembro. Selecciona un rol en el campo Asignar rol. Para ver ejemplos de conjuntos de principales, consulta Conjuntos de principales.
      Todos los usuarios	Selecciona un rol en el campo Asignar rol.

8. Haz clic en Guardar.

Conjuntos de entidades

A continuación, se muestran ejemplos de conjuntos de principales que puedes especificar para el tipo de miembro Grupo de Workforce Identity:

Conjunto de principales	Descripción
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID	Una identidad única en una WIF.
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/group/GROUP_ID	Todas las identidades del personal de un grupo.
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE	Todas las identidades del personal con un valor del atributo específico.
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/*	Todas las identidades en un grupo de identidades de personal.

Reemplaza los siguientes marcadores de posición por valores en la muestra de código:

• PROJECT_NUMBER: Es el número que se usa en la ruta de acceso del recurso para identificar un proyecto de Google Cloud específico.
• GROUP_ID: Es un identificador de grupo específico de un proveedor de identidad (IdP) externo, que te permite otorgar acceso a todos los miembros de ese grupo.
• POOL_ID: Es el ID único del grupo de identidades de personal que creas en Google Cloud.
• SUBJECT_ID: Es el identificador de sujeto único para una identidad única dentro de un grupo de identidades de personal.
• ATTRIBUTE_NAME: Es un nombre definido por el usuario de un atributo personalizado que asignaste desde un proveedor de identidad (IdP) externo.
• ATTRIBUTE_VALUE: Es el valor específico de ATTRIBUTE_NAME que se usa para restringir el acceso.

Cómo transferir la propiedad de un agente

Como administrador, puedes transferir la propiedad de un agente compartido a otro usuario de tu organización o a ti mismo. Esta función es útil en situaciones como las siguientes:

• Empleados que se van: Transfiere los agentes creados por los empleados que abandonan la organización a miembros activos del equipo para garantizar un mantenimiento ininterrumpido.
• Transferencias de contratistas: Transferir agentes creados por trabajadores temporales o contratistas al personal de tiempo completo.
• Reestructuración del equipo: Reasignar las responsabilidades de los agentes a medida que evolucionan los roles o los proyectos.

Consideraciones y limitaciones

Antes de transferir la propiedad del agente, ten en cuenta las siguientes consideraciones y limitaciones:

• Permiso de administrador: Solo los administradores con el rol de administrador de Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) o el rol de administrador de Discovery Engine (roles/discoveryengine.admin) pueden transferir la propiedad del agente. El propietario actual del agente no puede transferir la propiedad, a menos que también sea administrador.
• Solo agentes compartidos: Solo puedes transferir la propiedad de los agentes que ya están compartidos. En la página Agentes de la consola de Google Cloud , la columna Uso compartido del agente debe mostrar Habilitado. Los agentes privados (no compartidos) no se pueden transferir.
• Propietario único: Cada agente tiene exactamente un propietario. Cuando se transfiere la propiedad, el destinatario seleccionado se convierte en el único propietario del agente.
• Acceso del propietario anterior: Cuando se transfiere la propiedad, el propietario anterior pasa a ser un usuario del agente con el rol agentUser. Conservan el permiso para consultar y ejecutar el agente, pero ya no pueden editar su configuración o sus parámetros.
• Tipos de agentes compatibles: La transferencia de propiedad es compatible con los agentes creados por empleados (agentes de poco código y de flujo de trabajo creados en la app web).
• Agentes con programas o activadores: Si el agente transferido tiene un activador de programa o de evento, la operación de transferencia los marca como programas o eventos inhabilitados. El nuevo propietario debe habilitar el programa o el activador de eventos antes de poder usar el agente.

Cómo transferir la propiedad de un agente

Para transferir la propiedad de un agente, sigue estos pasos:

Console

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

   Ir a Gemini Enterprise

2. Elige tu proyecto.

3. Haz clic en tu app en la columna Nombre. Se actualiza el menú de navegación.

4. Haz clic en Agentes en el menú de navegación.

5. Haz clic en el nombre visible del agente compartido.

6. Haz clic en la pestaña Permisos del usuario. Aparecerá la lista Usuarios con permiso.

7. Haz clic en Transferir la propiedad. Se abrirá el diálogo Transferir propiedad.

8. En Transferir la propiedad a, elige una de las siguientes opciones:

   • A mí: Transfiere la propiedad del agente a tu cuenta de administrador actual. Esta opción se inhabilita si ya eres propietario del agente.
   • Otro usuario: Transfiere la propiedad a otro usuario de tu organización.

9. Si seleccionaste Otro usuario, especifica el nuevo propietario:

   • Identidad de Google y Cloud Identity: Ingresa la dirección de correo electrónico del usuario en el campo Correo electrónico del propietario nuevo (por ejemplo, [e-mail]).
   • Cuentas de la federación de identidades de personal (WIF): Ingresa el identificador de la principal de identidad única en el campo Nueva principal propietaria:

   //iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID
   

   Como alternativa, puedes incluir el prefijo principal::

   principal://iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID
   

   Reemplaza lo siguiente:

   • POOL_ID: Es el ID único de tu grupo de Workforce Identity.
   • SUBJECT_ID: Es el identificador del sujeto del usuario en el grupo de identidades de personal.
   Nota: Los identificadores de principales de la federación de identidades de personal distinguen mayúsculas de minúsculas. Asegúrate de que el identificador coincida con las mayúsculas y minúsculas exactas configuradas en la asignación de google.subject de tu proveedor de identidad.

10. Haz clic en Transferir la propiedad.

    Se actualizó el propietario del agente. El propietario anterior se conserva como un usuario con permiso y el rol agentUser.

    Nota: Si el agente transferido tiene un activador de programa o de evento, la operación de transferencia los marca como programas o eventos inhabilitados. El propietario nuevo debe habilitar el activador antes de poder usar el agente.