Compartilhar agentes no console do Google Cloud

Nesta página, explicamos como compartilhar agentes com usuários na sua organização e como os 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 de colaboradores ou todos os usuários da sua organização, além de transferir a propriedade de 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, é necessário ter um ou mais agentes criados com o Workflow Builder no app da Web do Gemini Enterprise. Para saber 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 app, consulte Criar um app.

2. Para compartilhar agentes personalizados, é necessário registrá-los ou adicioná-los 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 do 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 o Gemini Enterprise

1. Selecione o projeto.

2. Clique no seu 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 será exibida.

6. Clique em Adicionar usuário. A caixa de diálogo Adicionar papéis de permissão do 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 assinatura funcione, é necessário incluir o papel correto do IAM. 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 assinatura funcione, é preciso incluir o papel correto do IAM. 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 identidade de colaboradores: todas as identidades em um pool de identidade de colaboradores.

      • 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 participante	Descrição
      User	Insira os endereços de e-mail no campo Membro. Selecione um papel no campo Atribuir papel.
      Grupo	Insira os endereços de e-mail no campo Membro. Selecione um papel no campo Atribuir papel.
      Principal	Uma única identidade em uma federação de identidade de carga de trabalho.
      Pool de identidade da força de trabalho	Insira o Identificador principal no campo Membro. Selecione um papel no campo Atribuir papel. Para ver exemplos de conjuntos de principais, consulte Conjuntos de principais.
      Todos os usuários	Selecione um papel no campo Atribuir papel.

8. Clique em Salvar.

Conjuntos de principais

Confira a seguir exemplos de conjuntos de principais que podem ser especificados para o tipo de membro Pool de identidade de colaboradores:

Conjunto principal	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 de colaboradores 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 de colaboradores.

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 específico do Google Cloud .
• GROUP_ID: um identificador de grupo específico de um provedor de identidade externa (IdP), permitindo que você conceda acesso a todos os membros desse grupo.
• POOL_ID: o ID exclusivo do pool de identidade de colaboradores que você cria em Google Cloud.
• SUBJECT_ID: o identificador de assunto exclusivo de 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ê. Esse recurso é útil em cenários como:

• Funcionários que estão saindo: transferência de agentes criados por funcionários que estão saindo da organização para membros ativos da equipe para garantir 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 de administrador do Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) ou de administrador do Discovery Engine (roles/discoveryengine.admin) podem transferir a propriedade do agente. O proprietário atual do agente não pode transferir a propriedade, a menos que também seja um administrador.
• Somente agentes compartilhados: só é possível transferir a propriedade de agentes que já estão compartilhados. Na página Agentes no console do Google Cloud , a coluna Compartilhamento do agente precisa exibir Ativado. Agentes particulares (não compartilhados) não podem ser transferidos.
• 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 para um usuário no agente com o papel agentUser. Eles mantêm permissão para consultar e executar o agente, mas não podem mais editar a configuração ou as definições do agente.
• Tipos de agentes compatíveis: a transferência de propriedade é compatível com agentes criados por funcionários (agentes de pouco 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 programações ou eventos desativados. O novo proprietário precisa ativar a programação ou o acionador de eventos 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 o Gemini Enterprise

2. Selecione o projeto.

3. Clique no seu 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 é exibida.

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

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

   • Eu: transfira a propriedade do agente para sua conta de administrador atual. Essa opção fica desativada se você já é 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: digite 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, na sigla em inglês): 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, é possível incluir o prefixo principal::

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

   Substitua:

   • POOL_ID: o ID exclusivo do pool de identidade de colaboradores.
   • SUBJECT_ID: o identificador de assunto do usuário no pool de identidades de força de trabalho.
   Observação: os identificadores principais da federação de identidade de colaboradores diferenciam maiúsculas de minúsculas. Verifique se o identificador corresponde exatamente às letras maiúsculas e minúsculas configuradas no mapeamento google.subject do seu 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.