Configurar um repositório de dados do Slack

Nesta página, descrevemos como criar um repositório de dados e conectar o Slack ao Gemini Enterprise.

Antes de começar

Antes de configurar a conexão com o Slack, verifique se você tem o seguinte:

• Conceda o papel de editor do Discovery Engine (roles/discoveryengine.editor). Esse papel é necessário para que o usuário crie o repositório de dados. Para conceder esse papel:

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

     Acessar IAM

  2. Localize a conta de usuário e clique em editar Editar.
  3. Conceda o papel Discovery Engine Editor ao usuário. Para mais informações, consulte Papéis e permissões do IAM.

• Verifique se você tem acesso ao espaço de trabalho do Slack que precisa conectar e se fez login na sua conta do Slack.

• Verifique se você tem um plano do Slack que inclui a pesquisa com IA do Slack.

• Coordene com o administrador do Slack da sua organização para garantir que os usuários finais possam autorizar as contas sem interrupção. Compartilhe a Central de Ajuda oficial do Slack: Gerenciar a aprovação de apps para a documentação do espaço de trabalho para instruções detalhadas sobre como configurar uma das seguintes opções de implantação:

  • Pré-aprovação de apps (recomendado) : se a configuração Exigir apps aprovados estiver ativada no Slack, o administrador poderá pré-aprovar o app Gemini Enterprise no Slack App Marketplace. Os membros podem instalar e usar apps pré-aprovados imediatamente. Consulte a Ajuda do Slack: Pré-aprovar ou restringir apps.

  • Solicitação sob demanda:se a configuração Exigir apps aprovados estiver ativada no Slack, o administrador poderá permitir que os membros solicitem apps que não foram pré-aprovados. Os membros podem enviar solicitações para aprovação administrativa. Consulte a Ajuda do Slack: Permitir que os membros solicitem apps.

  • Instalação direta:se a configuração Exigir apps aprovados estiver desativada no Slack, os membros poderão instalar e usar o app diretamente sem intervenção do administrador. Consulte a Ajuda do Slack: Gerenciar a aprovação de apps para o espaço de trabalho.

Criar repositório de dados do Slack

Para criar um repositório de dados do ServiceNow, siga estas etapas:

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

   Gemini Enterprise

2. Selecionar ou criar um projeto Google Cloud

3. No menu de navegação, selecione Repositório de dados.

4. Clique em Criar repositório de dados.

5. Na seção Origem, pesquise Slack e clique em Selecionar.

6. Na seção Dados:

   1. Na seção Entidades para pesquisar, selecione as entidades que você quer pesquisar entre as seguintes opções:

      • Conversa
      • Arquivo
      • Mensagem

   2. Opcional: no campo ID da equipe do Slack, insira o ID da equipe do Slack para restringir os usuários a se conectarem apenas a um espaço de trabalho específico do Slack. Para mais informações, consulte Restringir o conector a um espaço de trabalho específico do Slack (opcional).

7. Clique em Continuar.

8. Se o fluxo de criação do repositório de dados mostrar uma seção Opções avançadas, você poderá marcar a caixa de seleção Ativar endereços IP estáticos nela. Isso garante que o repositório de dados use um conjunto fixo de endereços IP para tráfego de saída, adequado para a lista de permissões no sistema de origem. Para mais informações, consulte Configurar a saída de IP estático.

9. Na seção Configuração:

   1. Na lista Multirregional, selecione o local do conector de dados.
   2. No campo Nome do conector de dados, insira um nome para o conector.
   3. Se você selecionou us ou eu como o local, configure as Configurações de criptografia:
      • Opcional: se você não tiver configurado chaves de região única, clique em Acessar a página de configurações para fazer isso. Para mais informações, consulte Registrar uma chave de região única para conectores de terceiros.
      • Selecione Chave de criptografia gerenciada peloGoogle ou Chave do Cloud KMS.
      • Se você selecionou Chave do Cloud KMS:
        • Na lista Tipo de gerenciamento de chaves, selecione o tipo adequado.
        • Na lista Chave do Cloud KMS, selecione a chave.
      Para mais informações, consulte Chaves de criptografia gerenciadas pelo cliente.

10. Clique em Continuar.

11. Na seção Faturamento, selecione Preços gerais ou Preços configuráveis. Para mais informações, consulte Verificar o status de faturamento dos seus projetos e Licenças.

12. Clique em Criar. O Gemini Enterpriserise cria e exibe os repositórios de dados na página Repositórios de dados.

Na página Repositórios de dados, clique no nome da loja para conferir o status. Depois que o estado do repositório de dados mudar de Em criação para Ativo, o conector do Slack estará pronto para uso.

Depois de criar o repositório de dados, crie um app, conecte-o ao repositório de dados do Slack e autorize o Gemini Enterprise a acessar o Slack antes de executar qualquer consulta.

Restringir o conector a um espaço de trabalho específico do Slack (opcional)

O campo ID da equipe do Slack é opcional. Use-o para restringir os usuários finais a um espaço de trabalho específico do Slack e impedir que eles vinculem contas pessoais ou não autorizadas.

• Se você fornecer um ID da equipe: durante a autorização, o conector verifica se a conta de conexão pertence ao espaço de trabalho especificado. Caso contrário, a conexão será rejeitada.

• Se você deixar esse campo em branco: os usuários podem se conectar a qualquer espaço de trabalho que a conta deles tenha permissão para acessar.

Observação: o ID sempre começa com a letra T (por exemplo, T01234567).

Para encontrar o ID da equipe correspondente a um espaço de trabalho específico, faça o seguinte:

• Barra de endereço do navegador da Web: faça login no Slack em um navegador da Web usando o URL do espaço de trabalho (por exemplo, https://example.slack.com). Depois que a página for carregada, consulte a barra de endereço: o URL tem o formato https://app.slack.com/client/T01234567/C01234567, e o segmento que começa com T é o ID da equipe.
• Painel do administrador: os administradores do Enterprise Grid podem localizar o ID da equipe de um espaço de trabalho específico no painel do administrador em admin.slack.com em Espaços de trabalho.
• API Slack:recupere o ID da equipe de maneira programática usando o método team.info da API Slack.

Copie o valor e cole-o no campo ID da equipe do Slack para aplicar a restrição.

Tratamento de dados e execução de consultas

Esta seção descreve como o Gemini Enterprise gerencia sua consulta e as implicações de privacidade do uso do repositório de dados federado.

Execução da consulta

Depois de autorizar o Slack e enviar uma consulta de pesquisa ao Gemini Enterprise:

• O Gemini Enterprise envia sua consulta de pesquisa diretamente para a API do Slack.
• O Gemini Enterprise combina os resultados com os de outras fontes de dados conectadas e mostra um resultado da pesquisa abrangente.

Processamento de dados

Ao usar a pesquisa federada de terceiros, as seguintes regras de tratamento de dados são aplicadas:

• Sua string de consulta é enviada para o back-end de pesquisa externo (API Slack).
• Esses terceiros podem associar consultas à sua identidade.
• Se várias fontes de dados de pesquisa federada estiverem ativadas, a consulta poderá ser enviada a todas elas.
• Depois que os dados chegam ao sistema de terceiros, eles são regidos pelos Termos de Serviço e pelas Políticas de Privacidade desse sistema.

Observação: para maior precisão, um LLM pode reescrever sua consulta antes de enviá-la ao Slack. Essa consulta reescrita pode incorporar informações do histórico de consultas da sua sessão. Como resultado, partes do seu histórico de consultas também podem ser incluídas na consulta enviada à API Slack.

A seguir

• Para ver como os resultados da pesquisa aparecem depois que o app é configurado, consulte Receber resultados da pesquisa.
• Para ativar alertas para o repositório de dados, consulte Configurar alertas para repositórios de dados de terceiros.