Salvar e compartilhar comandos

Este documento descreve como salvar e compartilhar comandos no Vertex AI Studio. Com os comandos compartilhados, você pode colaborar com membros da equipe, garantir a consistência e criar uma biblioteca de comandos eficazes para várias tarefas.

O compartilhamento funciona da seguinte maneira:

  • Por padrão, todos os usuários da Vertex AI têm acesso total a todos os comandos salvos no projeto. Não é necessário compartilhar comandos salvos com outros usuários no projeto, a menos que haja restrições organizacionais ou de projeto ou recursos específicos, como conjuntos de dados.

  • Os usuários da Vertex AI podem compartilhar qualquer comando no projeto, mesmo aqueles que não foram criados ou salvos por eles.

  • Somente usuários da Vertex AI podem compartilhar comandos. Se um usuário externo for convidado para colaborar em um comando, ele não poderá compartilhar o comando com outro usuário.

  • O compartilhamento é por comando, não por projeto. Os usuários convidados só podem acessar os comandos para os quais foram convidados a colaborar. Elas não têm acesso aos outros comandos no projeto.

Antes de começar

Se o projeto ainda não tiver ativado o recurso de compartilhamento de comandos, peça ao administrador para fazer isso.

Para ativar o compartilhamento de comandos, o administrador precisa ter as seguintes permissões:

  • Nível da organização:

    • Permissões para gerenciar políticas de negação (roles/iam.denyAdmin)

  • Nível do projeto:

    • Permissões para gerenciar papéis personalizados (roles/iam.roleAdmin)

    • Permissões para definir e remover papéis de principais (roles/resourcemanager.projectIamAdmin)

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

    • Permissões para gerenciar tags (roles/resourcemanager.tagAdmin)

    • Permissões para usar tags (roles/resourcemanager.tagUser)

    • Permissões para usar recursos da Vertex AI ( roles/aiplatform.user)

Ativar compartilhamento de comandos

Para ativar o compartilhamento de comandos:

  1. No Vertex AI Studio, acesse Gerenciamento de comandos ou Playground de chat.

    Acessar "Gerenciamento de comandos"

    Acessar o playground do chat

  2. Abra um comando salvo e clique no botão Compartilhar.

    Se a sua conta tiver as permissões para ativar o compartilhamento, um botão Ativar vai aparecer.

    Botão para ativar o compartilhamento de comandos

    Se sua conta não tiver as permissões para ativar o compartilhamento, uma lista de funções necessárias vai aparecer.

    Papéis necessários para o compartilhamento de comandos

  3. Clique em Ativar.

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

Salvar um comando

Para salvar um comando para uso ou compartilhamento posterior:

  1. Acesse o Vertex AI Studio.

    Acesse o Vertex AI Studio

  2. Escreva um novo comando ou abra um já existente e clique em enviar Enviar.

  3. Clique no botão Salvar.

Compartilhar um comando salvo

Depois que o compartilhamento de comandos é ativado, qualquer usuário da Vertex AI pode compartilhar um comando salvo.

  1. No Vertex AI Studio, acesse Gerenciamento de comandos ou Playground de chat.

    Acessar "Gerenciamento de comandos"

    Acessar o playground do chat

  2. Abra um comando salvo e clique no botão Compartilhar.

    Se o compartilhamento de comandos tiver sido ativado, você verá uma janela semelhante a esta:

    Janela de compartilhamento de comandos

    Quando um comando é compartilhado, os destinatários recebem uma notificação por e-mail semelhante a esta:

    E-mail de compartilhamento de comando

Parar de compartilhar um comando

Para revogar o acesso a um comando:

  1. Abra um comando salvo e clique no botão Compartilhar.

  2. Ao lado dos principais, selecione Remover e clique em Salvar.

    Parar de compartilhar

    A exclusão de um comando salvo remove automaticamente o acesso de todas as pessoas com quem ele foi compartilhado.

Informações de segurança

Ao ativar o compartilhamento de comandos, você concede ao serviço da API Vertex AI as permissões para convidar usuários para seu projeto em seu nome. Especificamente, você cria uma conta de serviço no nível do projeto, conhecida como conta de serviço de compartilhamento de comandos, no seu projeto com as seguintes permissõ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 esteja autorizado a usar a conta de serviço de compartilhamento de comandos, o sistema cria automaticamente uma política de negação quando o compartilhamento de comandos é ativado.

A seguir