Compartilhar um agente de chat

Compartilhe os agentes de chat que você criou e iniciou usando o Workflow Builder com outros usuários da 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 a ação para compartilhar um agente de chat.

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 de 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ê enviar um arquivo confidencial para a 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 listas de controle de acesso (ACLs) e as permissões do usuário são preservadas. Os usuários só podem consultar e recuperar dados de repositórios de dados e conectores que as contas de usuário individuais estão autorizadas a 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 mostrando 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 que esteja no estado draft.

3. Clique em Menu de ações e selecione Compartilhar.

4. Na caixa de diálogo de compartilhamento, insira 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:

   • É possível compartilhar o agente de chat com endereços de e-mail de usuários individuais. Não é possível compartilhar com o Google Grupos.
   • 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 mostrar sugestões de preenchimento automático ao inserir endereços de e-mail do usuário.

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 análise e aprovação. Depois que o administrador do app aprovar o pedido, 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 revisão do administrador

Por padrão, os proprietários de agentes podem compartilhar os agentes com qualquer usuário da organização sem a aprovação de um administrador do app. No entanto, os administradores do app podem mudar as configurações de controle de recursos do app para exigir a 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 do app são responsáveis por analisar e gerenciar pedidos 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 os administradores do app com o papel do IAM de administrador do Gemini Enterprise podem analisar e aprovar pedidos de compartilhamento.

Console

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

1. No Google Cloud console, 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 pedido de compartilhamento na coluna Permissões do usuário.

   

5. Clique em Analisar pedido de compartilhamento.

6. No painel Pedido de compartilhamento:

   • Analise 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 da força de trabalho (WIF).

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

8. Para recusar o pedido, clique em Negar.

Limites de compartilhamento

Ao compartilhar um agente de chat, os seguintes limites são aplicados:

• Máximo de 1.500 contas individuais:o Gemini Enterprise gerencia o acesso do agente usando políticas de permissão do Google Cloud IAM subjacentes, que impõem um limite máximo de 1.500 membros por política. O compartilhamento de 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 acessar 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 , independentemente do acesso direto ao arquivo, enquanto os dados acessados por conectores continuam respeitando as permissões de usuário individuais e as listas de controle de acesso (ACLs).
• Os administradores do app podem adicionar e remover usuários da lista de acesso a qualquer momento.
• Somente os administradores do app 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).
• Também é possível compartilhar um agente de chat na tela do criador 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 as cotas e limites do Workflow Builder.