Compartilhar agentes no console do Google Cloud

Nesta página, explicamos como compartilhar agentes com usuários na sua organização e como administradores podem transferir a propriedade de agentes compartilhados. Como administrador, você pode compartilhar os agentes disponíveis (criados pelo Google, por funcionários e personalizados) com usuários individuais, grupos, grupos do pool de identidades da força de trabalho ou todos os usuários da sua organização, além de transferir a propriedade dos agentes compartilhados criados por funcionários para você ou outro usuário. Para mais informações sobre os diferentes tipos de agentes disponíveis no Gemini Enterprise, consulte Visão geral dos agentes.

Observação: para compartilhar agentes criados por funcionários, você precisa ter um ou mais agentes criados usando o Workflow Builder no app da Web Gemini Enterprise. Para informações sobre como criar agentes usando o Workflow Builder, consulte Criar um agente usando o Workflow Builder.

Antes de começar

Antes de compartilhar um agente, você precisa atender aos seguintes requisitos:

1. Você precisa ter um app da Web do Gemini Enterprise. Para criar um novo, consulte Criar um app.

2. Para compartilhar agentes personalizados, você precisa ter registrado ou adicionado os agentes personalizados ao Gemini Enterprise usando uma das seguintes opções:

   • Registrar e gerenciar agentes A2A
   • Registrar e gerenciar agentes do ADK hospedados no Agent Runtime na Gemini Enterprise Agent Platform
   • Adicionar e gerenciar agentes A2A no Google Cloud Marketplace
   • Registrar e gerenciar agentes do Dialogflow

Compartilhar um agente

Para compartilhar um agente, siga estas etapas:

Console

1. No console Google Cloud , acesse a página Gemini Enterprise.

Acesse Gemini Enterprise

1. Selecione o projeto.

2. Clique no app na coluna Nome. O menu de navegação é atualizado.

3. Clique em Agentes no menu de navegação.

4. Clique no Nome de exibição do agente que você quer compartilhar.

5. Clique na guia Permissões do usuário. A página Usuários com permissão vai aparecer.

6. Clique em Adicionar usuário. A caixa de diálogo Adicionar papéis de permissões de usuário ao agente é exibida.

7. Configure os detalhes da permissão:

   1. Selecione uma das seguintes opções na seção Tipo de membro:

      • Usuário: um usuário final individual. Para que esse tipo de membro funcione, você precisa incluir o papel do IAM correto. Para mais informações, consulte Papéis e permissões do IAM.

      • Grupo: uma coleção de usuários finais. Para que esse tipo de membro funcione, inclua o papel do IAM correto. Para mais informações, consulte Papéis e permissões do IAM.

      • Principal: uma única identidade em um grupo de pool de identidades de colaboradores, que inclui grupos externos não gerenciados pelo Google.

      • Pool de identidades da força de trabalho: todas as identidades em um pool de identidades da força de trabalho.

      • Todos os usuários: todos os usuários na organização.

   2. Insira a identificação exclusiva do membro e selecione uma função:

      Tipo de membro	Descrição
      User	Digite os endereços de e-mail no campo Membro. Selecione uma função no campo Atribuir função.
      Grupo	Digite os endereços de e-mail no campo Membro. Selecione uma função no campo Atribuir função.
      Principal	Uma única identidade em uma WIF.
      Pool de identidade da força de trabalho	Insira Identificador principal no campo Membro. Selecione uma função no campo Atribuir função. Para exemplos de conjuntos principais, consulte Conjuntos principais.
      Todos os usuários	Selecione uma função no campo Atribuir função.

8. Clique em Salvar.

Conjuntos de principais

Confira exemplos de conjuntos de principais que podem ser especificados para o tipo de membro Pool de identidade da força de trabalho:

Conjunto de principais	Descrição
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID	Uma única identidade em uma WIF.
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/group/GROUP_ID	Todas as identidades da força de trabalho em um grupo.
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE	Todas as identidades da força de trabalho com um valor de atributo específico.
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/*	Todas as identidades em um pool de identidades da força de trabalho.

Substitua os seguintes marcadores por valores no exemplo de código:

• PROJECT_NUMBER: o número usado no caminho do recurso para identificar um projeto Google Cloud específico.
• GROUP_ID: um identificador de grupo específico de um provedor de identidade (IdP) externo, permitindo conceder acesso a todos os membros desse grupo.
• POOL_ID: o ID exclusivo do pool de identidade da força de trabalho que você cria em Google Cloud.
• SUBJECT_ID: o identificador de assunto exclusivo para uma única identidade em um pool de identidades de força de trabalho.
• ATTRIBUTE_NAME: um nome definido pelo usuário de um atributo personalizado que você mapeou de um provedor de identidade (IdP) externo.
• ATTRIBUTE_VALUE: o valor específico do ATTRIBUTE_NAME usado para restringir o acesso.

Transferir a propriedade do agente

Como administrador, você pode transferir a propriedade de um agente compartilhado para outro usuário na sua organização ou para você mesmo. Essa capacidade é útil em cenários como:

• Funcionários que estão saindo:transfira os agentes criados por funcionários que deixam a organização para membros ativos da equipe e garanta a manutenção ininterrupta.
• Transferências de prestadores de serviço:transferência de agentes criados por trabalhadores temporários ou contratados para funcionários em tempo integral.
• Reestruturação da equipe:reatribuição de responsabilidades do agente à medida que as funções ou os projetos evoluem.

Considerações e limitações

Antes de transferir a propriedade do agente, observe as seguintes considerações e limitações:

• Permissão de administrador:somente administradores com o papel Administrador do Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) ou Administrador do Discovery Engine (roles/discoveryengine.admin) podem transferir a propriedade do agente. O proprietário atual do agente só pode transferir a propriedade se também for administrador.
• Somente agentes compartilhados:só é possível transferir a propriedade de agentes que já foram compartilhados. Na página Agentes do console Google Cloud , a coluna Compartilhamento do agente precisa mostrar Ativado. Não é possível transferir agentes particulares (não compartilhados).
• Proprietário único:cada agente tem exatamente um proprietário. Quando a propriedade é transferida, o destinatário selecionado se torna o único proprietário do agente.
• Acesso do proprietário anterior:quando a propriedade é transferida, o proprietário anterior é rebaixado a um usuário no agente com a função agentUser. Eles mantêm a permissão para consultar e executar o agente, mas não podem mais editar a configuração ou as definições dele.
• Tipos de agentes compatíveis:a transferência de propriedade é compatível com agentes criados por funcionários (agentes de baixo código e de fluxo de trabalho criados no app da Web).
• Agentes com programações ou gatilhos:se o agente transferido tiver um gatilho de programação ou de evento, a operação de transferência vai marcar esses gatilhos como desativados. O novo proprietário precisa ativar o gatilho de programação ou evento antes de usar o agente.

Transferir a propriedade de um agente

Para transferir a propriedade de um agente, siga estas etapas:

Console

1. No console Google Cloud , acesse a página Gemini Enterprise.

   Acesse Gemini Enterprise

2. Selecione o projeto.

3. Clique no app na coluna Nome. O menu de navegação é atualizado.

4. Clique em Agentes no menu de navegação.

5. Clique no Nome de exibição do agente compartilhado.

6. Clique na guia Permissões do usuário. A lista Usuários com permissão aparece.

7. Clique em Transferir propriedade. A caixa de diálogo Transferir propriedade será aberta.

8. Em Transferir propriedade para, escolha uma das seguintes opções:

   • Eu mesmo: transfira a propriedade do agente para sua conta de administrador atual. Essa opção fica desativada se você já for o proprietário do agente.
   • Outro usuário: transfira a propriedade para outro usuário na sua organização.

9. Se você selecionou Outro usuário, especifique o novo proprietário:

   • Google Identity e Cloud Identity:insira o endereço de e-mail do usuário no campo E-mail do novo proprietário (por exemplo, [e-mail]).
   • Contas da federação de identidade de colaboradores (WIF):insira o identificador principal de identidade única no campo Novo principal proprietário:

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

   Como alternativa, inclua o prefixo principal::

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

   Substitua:

   • POOL_ID: o ID exclusivo do seu pool de identidade da força de trabalho.
   • SUBJECT_ID: o identificador de assunto do usuário no pool de identidade de colaboradores.
   Observação:os identificadores principais da federação de identidade de colaboradores diferenciam maiúsculas de minúsculas. Verifique se o identificador corresponde ao uso de maiúsculas e minúsculas configurado no mapeamento google.subject do provedor de identidade.

10. Clique em Transferir propriedade.

    O proprietário do agente é atualizado. O proprietário anterior é mantido como um usuário com permissão e o papel agentUser.

    Observação:se o agente transferido tiver um gatilho de programação ou de evento, a operação de transferência vai marcá-los como programações ou eventos desativados. O novo proprietário precisa ativar o gatilho antes de usar o agente.