En este documento se describe cómo guardar y compartir peticiones en Vertex AI Studio. Compartir peticiones te permite colaborar con los miembros del equipo, garantizar la coherencia y crear una biblioteca de peticiones eficaces para diversas tareas.
El uso compartido funciona de la siguiente manera:
De forma predeterminada, todos los usuarios de Vertex AI tienen acceso completo a todas las peticiones guardadas del proyecto. No es necesario compartir las peticiones guardadas con otros usuarios del proyecto, a menos que se hayan aplicado restricciones organizativas o de proyecto a esos usuarios o a recursos específicos, como conjuntos de datos.
Los usuarios de Vertex AI pueden compartir cualquier petición del proyecto, incluso las que no hayan creado ni guardado.
Solo los usuarios de Vertex AI pueden compartir peticiones. Si se invita a un usuario externo a colaborar en una petición, no podrá compartirla con otro usuario.
El uso compartido de peticiones se aplica a cada petición, no a cada proyecto. Los usuarios invitados solo pueden acceder a las peticiones en las que se les haya invitado a colaborar. No tienen acceso a las otras peticiones del proyecto.
Antes de empezar
Si el proyecto aún no ha habilitado la función de compartir peticiones, pide al administrador que lo haga.
Para habilitar la opción de compartir peticiones, el administrador debe tener los siguientes permisos:
Nivel de organización:
- Permisos para gestionar políticas de denegación (
roles/iam.denyAdmin)
- Permisos para gestionar políticas de denegación (
Nivel de proyecto:
Permisos para gestionar roles personalizados (
roles/iam.roleAdmin)Permisos para asignar y quitar roles a principales (
roles/resourcemanager.projectIamAdmin)Permisos para gestionar cuentas de servicio (
roles/iam.serviceAccountAdmin)Permisos para gestionar etiquetas (
roles/resourcemanager.tagAdmin)Permisos para usar etiquetas (
roles/resourcemanager.tagUser)Permisos para usar recursos de Vertex AI (
roles/aiplatform.user)
Habilitar la opción de compartir peticiones
Para habilitar la opción de compartir peticiones, sigue estos pasos:
En Vertex AI Studio, ve a Gestión de peticiones o a Espacio de pruebas de chat.
Abre una petición guardada y haz clic en el botón Compartir.
Si tu cuenta tiene los permisos necesarios para habilitar la opción de compartir, verás el botón Habilitar.
Si tu cuenta no tiene los permisos necesarios para habilitar el uso compartido, verás una lista de los roles obligatorios.
Haz clic en Enable (Habilitar).
El sistema crea una cuenta de servicio a nivel de proyecto, conocida como cuenta de servicio para compartir peticiones, en tu proyecto con los permisos necesarios para compartir peticiones. Para obtener más información, consulta Información de seguridad.
Guardar una petición
Para guardar una petición y usarla o compartirla más adelante, sigue estos pasos:
Ve a Vertex AI Studio.
Escribe una petición o abre una que ya tengas y haz clic en enviar Enviar.
Haz clic en el botón Guardar.
Compartir una petición guardada
Una vez que se habilita la opción de compartir peticiones, cualquier usuario de Vertex AI puede compartir una petición guardada.
En Vertex AI Studio, ve a Gestión de peticiones o a Espacio de pruebas de chat.
Abre una petición guardada y haz clic en el botón Compartir.
Si se ha habilitado correctamente la opción para compartir peticiones, verás una ventana similar a la siguiente:
Cuando se comparte una petición, los destinatarios reciben una notificación por correo similar a la siguiente:
Dejar de compartir una petición
Para revocar el acceso a una petición, sigue estos pasos:
Abre una petición guardada y haz clic en el botón Compartir.
Junto a los principales, selecciona Quitar y, a continuación, haz clic en Guardar.
Ten en cuenta que, si eliminas una petición guardada, se retirará automáticamente el acceso a todas las personas con las que la hayas compartido.
Información sobre seguridad
Cuando habilitas el uso compartido de peticiones, concedes al servicio de la API Vertex AI los permisos para invitar a usuarios a tu proyecto en tu nombre. En concreto, debes crear una cuenta de servicio a nivel de proyecto, conocida como cuenta de servicio para compartir peticiones, en tu proyecto con los siguientes permisos:
iam.roles.createiam.roles.listiam.roles.updateiam.roles.deleteresourcemanager.projects.setIamPolicyresourcemanager.projects.getIamPolicycloudasset.assets.searchAllIamPolicies
Para asegurarse de que solo el servicio de la API Vertex AI esté autorizado a usar la cuenta de servicio de uso compartido de peticiones, el sistema crea automáticamente una política de denegación cuando se habilita el uso compartido de peticiones.
Siguientes pasos
- Descubre otras funciones de Vertex AI Studio