Guarde e partilhe comandos

Este documento descreve como guardar e partilhar comandos no Vertex AI Studio. A partilha de comandos permite-lhe colaborar com os membros da equipa, garantir a consistência e criar uma biblioteca de comandos eficazes para várias tarefas.

A partilha funciona da seguinte forma:

  • Por predefinição, todos os utilizadores da Vertex AI têm acesso total a todos os comandos guardados no projeto. Não é necessário partilhar comandos guardados com outros utilizadores no projeto, a menos que existam restrições organizacionais ou de projeto aplicadas aos mesmos ou a recursos específicos, como conjuntos de dados.

  • Os utilizadores do Vertex AI podem partilhar qualquer comando no projeto, mesmo comandos que não foram criados nem guardados por eles.

  • Apenas os utilizadores do Vertex AI podem partilhar comandos. Se um utilizador externo for convidado a colaborar num comando, não pode partilhar o comando com outro utilizador.

  • A partilha de comandos é por comando e não por projeto. Os utilizadores convidados só podem aceder aos comandos para os quais foram convidados a colaborar. Não têm acesso aos outros comandos no projeto.

Antes de começar

Se o projeto ainda não tiver ativado a funcionalidade de partilha de comandos, peça ao seu administrador para a ativar.

Para ativar a partilha de comandos, o administrador tem de ter as seguintes autorizações:

  • Nível da organização:

    • Autorizações para gerir políticas de recusa (roles/iam.denyAdmin)

  • Nível do projeto:

    • Autorizações para gerir funções personalizadas (roles/iam.roleAdmin)

    • Autorizações para definir e remover funções em entidades (roles/resourcemanager.projectIamAdmin)

    • Autorizações para gerir contas de serviço (roles/iam.serviceAccountAdmin)

    • Autorizações para gerir etiquetas (roles/resourcemanager.tagAdmin)

    • Autorizações para usar etiquetas (roles/resourcemanager.tagUser)

    • Autorizações para usar recursos do Vertex AI ( roles/aiplatform.user)

Ative a partilha de comandos

Para ativar a partilha de comandos:

  1. No Vertex AI Studio, aceda a Gestão de comandos ou ao Playground de chat

    Aceder à gestão de comandos

    Aceder ao playground do Chat

  2. Abra um comando guardado e clique no botão Partilhar.

    Se a sua conta tiver as autorizações para ativar a partilha, é apresentado um botão Ativar.

    Botão de ativação da partilha de comandos

    Se a sua conta não tiver as autorizações para ativar a partilha, é apresentada uma lista das funções necessárias.

    Pedir funções necessárias para a partilha

  3. Clique em Ativar.

    O sistema cria uma conta de serviço ao nível do projeto, conhecida como a conta de serviço de partilha de comandos, no seu projeto com as autorizações necessárias para a partilha de comandos. Para mais informações, consulte as informações de segurança.

Guarde um comando

Para guardar um comando para utilização ou partilha posterior:

  1. Aceda ao Vertex AI Studio.

    Aceda ao Vertex AI Studio

  2. Escreva um novo comando ou abra um comando existente e, de seguida, clique em enviar Enviar.

  3. Clique no botão Guardar.

Partilhe um comando guardado

Assim que a partilha de comandos estiver ativada, qualquer utilizador do Vertex AI pode partilhar um comando guardado.

  1. No Vertex AI Studio, aceda a Gestão de comandos ou ao Playground de chat

    Aceder à gestão de comandos

    Aceder ao playground do Chat

  2. Abra um comando guardado e clique no botão Partilhar.

    Se a partilha de comandos tiver sido ativada com êxito, é apresentada uma janela semelhante à seguinte:

    Janela de partilha de comandos

    Quando um comando é partilhado, os destinatários do comando partilhado recebem uma notificação por email semelhante à seguinte:

    Email de partilha de comandos

Pare de partilhar um comando

Para revogar o acesso a um comando:

  1. Abra um comando guardado e clique no botão Partilhar.

  2. Junto aos diretores, selecione Remover e, de seguida, clique em Guardar.

    Pedir para parar a partilha

    Tenha em atenção que a eliminação de um comando guardado remove automaticamente o acesso de todas as pessoas com quem foi partilhado.

Informações de segurança

Quando ativa a partilha de comandos, concede ao serviço da API Vertex AI as autorizações para convidar utilizadores para o seu projeto em seu nome. Especificamente, cria uma conta de serviço ao nível do projeto, conhecida como a conta de serviço de partilha de comandos, no seu projeto com as seguintes autorizações:

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

Para garantir que apenas o serviço da API Vertex AI está autorizado a usar a conta de serviço de partilha de comandos, o sistema cria automaticamente uma política de recusa quando a partilha de comandos está ativada.

O que se segue