Compartilhar um agente de chat

Compartilhe os agentes de chat que você criou e lançou 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 do Gemini Enterprise analise e aprove o compartilhamento de um agente de conversação.

Atenção: ao compartilhar um agente, considere os seguintes comportamentos de acesso a 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 Base de Conhecimento do agente, mesmo que não tenha acesso direto ou permissões aos arquivos de origem. Por exemplo, se você fizer upload de um arquivo confidencial para a seção Base de 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 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 do Gemini Enterprise e acesse a página Galeria de Agentes.

   A página Galeria de agentes vai aparecer, 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, 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 conforme você digita 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 análise 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 a solicitação, o agente de chat será compartilhado com os usuários na lista de acesso. Você pode, a qualquer momento, editar o pedido de compartilhamento 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 a aprovação de um administrador do app. No entanto, os administradores do app podem mudar as configurações de controle de recursos para exigir que os agentes de compartilhamento no app sejam revisados e aprovados por um administrador.

O compartilhamento de agentes segue um processo de duas etapas quando a análise 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 recusa.

Analisar um pedido de compartilhamento

Os administradores de apps são responsáveis por analisar e gerenciar as 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 os administradores de apps 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 console do 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 Compartilhar solicitação:

   • 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 de agentes usando as políticas de permissão do IAM do Google Cloud , que impõem um limite rígido de 1.500 membros por política. Se você compartilhar um agente com mais de 1.500 contas de usuário individuais,a operação vai falhar com o seguinte erro:

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

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

Considerações

• Quando você compartilha um agente de chat, os usuários podem consultar o conteúdo dos arquivos enviados para a seção Base de Conhecimento, mesmo sem acesso direto aos arquivos. No entanto, os dados acessados por conectores continuam respeitando as permissões individuais dos usuários 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 de apps podem compartilhar o agente com os grupos do Google e os pools de identidade da federação de identidade de colaboradores (WIF, na sigla em inglês) 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 do Google Cloud . Para mais informações, consulte Transferir a propriedade do agente.
• Também é possível compartilhar um agente de chat na tela do builder de agentes de chat.

A seguir

• Saiba como usar um agente de chat.
• Saiba como agendar execuções do agente de chat.
• Saiba como editar um agente de chat.
• Saiba como excluir um agente de chat.
• Confira as cotas e limites do Workflow Builder.