Compartilhar um agente de chat

Compartilhe os agentes de chat que você criou e iniciou usando o Workflow Builder com outros usuários na sua organização. Dependendo das configurações de controle de recursos do seu app da Web, talvez seja necessário que um administrador do app Gemini Enterprise analise e aprove para compartilhar um agente de conversa.

Atenção:ao compartilhar um agente, considere os seguintes comportamentos de acesso aos dados:

• Arquivos de conhecimento:qualquer usuário com acesso ao agente compartilhado pode consultar e visualizar informações dos arquivos enviados para a seção Conhecimento do agente, mesmo que não tenha acesso direto ou permissões para os arquivos de origem. Por exemplo, se você fizer upload de um arquivo confidencial na seção Conhecimento, todos os usuários com acesso ao agente compartilhado poderão fazer perguntas sobre o conteúdo desse arquivo.
• Conectores e repositórios de dados:quando um agente acessa dados por conectores, as permissões e as listas de controle de acesso (ACLs) do usuário são preservadas. Os usuários só podem consultar e recuperar dados de repositórios e conectores que as contas de usuário individuais têm autorização para acessar.

Compartilhar um agente de chat

Para compartilhar um agente de chat, faça o seguinte:

App

1. Abra o app Gemini Enterprise e acesse a página Galeria de Agentes.

   A página Galeria de agentes aparece com todos os agentes pré-criados e personalizados.

2. Na seção Seus agentes, encontre o agente de chat que você quer compartilhar.

   Observação: não é possível compartilhar um agente de chat no estado draft.

3. Clique no menu Ações e selecione Compartilhar.

4. Na caixa de diálogo de compartilhamento, digite os endereços de e-mail dos usuários com quem você quer compartilhar o agente. Você também pode clicar em Copiar link para gerar um link compartilhável.

   Observações:

   • Você pode compartilhar seu agente de chat com endereços de e-mail de usuários individuais. Não é possível compartilhar com os Grupos do Google.
   • Se o app da Web estiver conectado a um repositório de dados da Pesquisa de pessoas com o preenchimento automático configurado para dados do usuário, a caixa de diálogo de compartilhamento vai fornecer sugestões de preenchimento automático à medida que você insere os endereços de e-mail dos usuários.

5. Clique em Concluído.

   O agente de chat é compartilhado com os usuários na sua lista de acesso.

   Observação: se o administrador do app da Web tiver ativado a revisão do administrador para o compartilhamento de agentes, um pedido de compartilhamento será enviado ao administrador do app para revisão e aprovação. Depois que o administrador do app aprovar a solicitação, o agente de chat será compartilhado com os usuários na lista de acesso. Você pode editar o pedido de compartilhamento a qualquer momento para adicionar ou remover usuários ou cancelar o pedido.

Controle de análise do administrador

Por padrão, os proprietários de agentes podem compartilhar os agentes com qualquer usuário na organização sem aprovação de um administrador de apps. No entanto, os administradores de apps podem mudar as configurações de controle de recursos para exigir revisão e aprovação do administrador para compartilhar agentes no app.

O compartilhamento de agentes segue um processo de duas etapas quando a revisão do administrador está ativada:

1. O proprietário do agente compartilha o agente com um ou mais usuários.
2. O administrador do app analisa o pedido de compartilhamento e o aprova ou nega.

Analisar um pedido de compartilhamento

Os administradores de apps são responsáveis por analisar e gerenciar solicitações de compartilhamento de agentes.

Observações:

• Esta seção só se aplica se o recurso Ativar o compartilhamento de agentes sem aprovação do admin estiver desativado nos controles de recursos do app.
• Somente administradores de apps com a função do IAM Administrador do Gemini Enterprise podem analisar e aprovar solicitações de compartilhamento.

Console

Para analisar um pedido de compartilhamento como administrador de apps, faça o seguinte:

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

   Gemini Enterprise

2. Clique no nome do app que contém o agente.

3. No menu de navegação do app, clique em Agentes.

4. Encontre o agente com uma ação Analisar solicitação de compartilhamento na coluna Permissões do usuário.

   

5. Clique em Analisar pedido de compartilhamento.

6. No painel Solicitação de compartilhamento:

   • Revise a lista de acesso em Compartilhamento solicitado com os seguintes usuários.
   • Opcional: modifique a lista de acesso para adicionar ou remover contas de usuário, grupos do Google ou pools de identidade da federação de identidade de colaboradores (WIF, na sigla em inglês).

7. Para aprovar o pedido e conceder acesso, clique em Aprovar e ativar.

8. Para rejeitar o pedido, clique em Negar.

Limites de compartilhamento

Ao compartilhar um agente de chat, os seguintes limites se aplicam:

• Máximo de 1.500 contas individuais:o Gemini Enterprise gerencia o acesso do agente usando as políticas de permissão do IAM Google Cloud , que impõem um limite máximo de 1.500 membros por política. Compartilhar um agente com mais de 1.500 contas de usuário individuais faz com que a operação falhe com o seguinte erro:

  The number of members in the policy (1,501) is larger than the maximum allowed size 1,500.
  

Para conferir uma lista completa de restrições do sistema, consulte Cotas e limites do Workflow Builder.

Considerações

• Ao compartilhar um agente de chat, os usuários podem consultar o conteúdo dos arquivos enviados para a seção Conhecimento, independente do acesso direto aos arquivos. Já os dados acessados por conectores continuam respeitando as permissões individuais dos usuários e as listas de controle de acesso (ACLs).
• Os administradores de apps podem adicionar e remover usuários da lista de acesso a qualquer momento.
• Somente os administradores de apps podem compartilhar o agente com grupos do Google e pools de identidade da federação de identidade da força de trabalho (WIF) na sua organização.
• Os proprietários de agentes podem remover qualquer usuário da lista de acesso a qualquer momento, incluindo aqueles adicionados pelo administrador do app.
• Os administradores de apps podem transferir a propriedade de um agente de chat compartilhado para outro usuário ou para si mesmos no console Google Cloud . Para mais informações, consulte Transferir a propriedade do agente.
• Você também pode compartilhar um agente de chat na tela do builder de agentes de chat.

A seguir

• Saiba como usar um agente de chat.
• Saiba como programar execuções de agentes de chat.
• Saiba como editar um agente de chat.
• Saiba como excluir um agente de chat.
• Consulte Cotas e limites do Workflow Builder.