Cómo guardar y compartir instrucciones

En este documento, se describe cómo guardar y compartir instrucciones en Vertex AI Studio. Compartir instrucciones te permite colaborar con los miembros del equipo, garantizar la coherencia y crear una biblioteca de instrucciones 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 instrucciones guardadas en el proyecto. No es necesario compartir las instrucciones guardadas con otros usuarios del proyecto, a menos que se hayan establecido restricciones organizativas o del proyecto sobre ellas o sobre recursos específicos, como conjuntos de datos.

  • Los usuarios de Vertex AI pueden compartir cualquier instrucción del proyecto, incluso las que no hayan creado ni guardado.

  • Solo los usuarios de Vertex AI pueden compartir instrucciones. Si se invita a un usuario externo a colaborar en una instrucción, no podrá compartirla con otro usuario.

  • El uso compartido de instrucciones es por instrucción, no por proyecto. Los usuarios invitados solo pueden acceder a las instrucciones sobre las que se los invitó a colaborar. No tienen acceso a las otras instrucciones del proyecto.

Antes de comenzar

Si el proyecto aún no habilitó la función de uso compartido de instrucciones, pídele a tu administrador que lo haga.

Para habilitar el uso compartido de instrucciones, el administrador debe tener los siguientes permisos:

  • Nivel de la organización:

    • Permisos para administrar políticas de denegación (roles/iam.denyAdmin)

  • Nivel del proyecto:

    • Permisos para administrar roles personalizados (roles/iam.roleAdmin)

    • Permisos para establecer y quitar roles en las principales (roles/resourcemanager.projectIamAdmin)

    • Permisos para administrar cuentas de servicio (roles/iam.serviceAccountAdmin)

    • Permisos para administrar etiquetas (roles/resourcemanager.tagAdmin)

    • Permisos para usar etiquetas (roles/resourcemanager.tagUser)

    • Permisos para usar recursos de Vertex AI (roles/aiplatform.user)

Habilitar el uso compartido de instrucciones

Para habilitar el uso compartido de instrucciones, sigue estos pasos:

  1. En Vertex AI Studio, ve a Administración de instrucciones o a Chat playground.

    Ir a Administración de instrucciones

    Ir al playground de Chat

  2. Abre una instrucción guardada y haz clic en el botón Compartir.

    Si tu cuenta tiene los permisos para habilitar el uso compartido, verás el botón Habilitar.

    Botón para habilitar el uso compartido de instrucciones

    Si tu cuenta no tiene los permisos para habilitar el uso compartido, verás una lista de los roles requeridos.

    Roles obligatorios para compartir instrucciones

  3. Haz clic en Habilitar.

    El sistema crea una cuenta de servicio a nivel del proyecto, conocida como la cuenta de servicio de uso compartido de instrucciones, en tu proyecto con los permisos necesarios para compartir instrucciones. Para obtener más información, consulta Información de seguridad.

Cómo guardar una instrucción

Para guardar una instrucción para usarla o compartirla más adelante, haz lo siguiente:

  1. Ve a Vertex AI Studio.

    Ir a Vertex AI Studio

  2. Escribe una instrucción nueva o abre una existente y, luego, haz clic en Enviar Enviar.

  3. Haz clic en el botón Guardar.

Cómo compartir una instrucción guardada

Una vez que se habilita el uso compartido de instrucciones, cualquier usuario de Vertex AI puede compartir una instrucción guardada.

  1. En Vertex AI Studio, ve a Administración de instrucciones o a Chat playground.

    Ir a Administración de instrucciones

    Ir al playground de Chat

  2. Abre una instrucción guardada y haz clic en el botón Compartir.

    Si se habilitó el uso compartido de instrucciones correctamente, verás una ventana similar a la siguiente:

    Ventana de uso compartido de instrucciones

    Cuando se comparte una instrucción, los destinatarios reciben una notificación por correo electrónico similar a la siguiente:

    Correo electrónico de uso compartido de instrucciones

Cómo dejar de compartir una instrucción

Para revocar el acceso a una instrucción, haz lo siguiente:

  1. Abre una instrucción guardada y haz clic en el botón Compartir.

  2. Junto a los principales, selecciona Quitar y, luego, haz clic en Guardar.

    Detener el uso compartido de instrucciones

    Ten en cuenta que, si borras un mensaje guardado, se quitará automáticamente el acceso a todas las personas con quienes lo compartiste.

Información de seguridad

Cuando habilitas el uso compartido de instrucciones, le otorgas al servicio de la API de Vertex AI los permisos para invitar usuarios a tu proyecto en tu nombre. Específicamente, crearás una cuenta de servicio a nivel del proyecto, conocida como la cuenta de servicio de uso compartido de instrucciones, en tu proyecto con los siguientes permisos:

  • iam.roles.create
  • iam.roles.list
  • iam.roles.update
  • iam.roles.delete
  • resourcemanager.projects.setIamPolicy
  • resourcemanager.projects.getIamPolicy
  • cloudasset.assets.searchAllIamPolicies

Para garantizar que solo el servicio de la API de Vertex AI esté autorizado a usar la cuenta de servicio de uso compartido de instrucciones, el sistema crea automáticamente una política de denegación cuando se habilita el uso compartido de instrucciones.

Pasos siguientes