Nesta página, descrevemos como criar um repositório de dados e conectar o Microsoft 365 ao Gemini Enterprise.
Antes de começar
Antes de configurar a conexão do Microsoft 365, faça 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:- No console Google Cloud , acesse a página IAM.
- Localize a conta de usuário e clique em editar Editar.
- Conceda a função
Discovery Engine Editorao usuário. Para mais informações, consulte Papéis e permissões do IAM.
Escolha como o conector vai se autenticar no Microsoft 365:
- OAuth 2.0 (gerenciado pelo Google) (padrão): o conector usa um aplicativo do Microsoft Entra que o Google gerencia. Não é necessário registrar um aplicativo nem inserir um ID do cliente ou uma chave secreta do cliente. Dependendo das configurações de consentimento do locatário e das ações que você ativar, um administrador do Microsoft Entra pode precisar conceder consentimento para sua organização.
- OAuth 2.0 (Traga seu próprio app): registre seu próprio aplicativo do Microsoft Entra e conceda a ele as permissões do Microsoft Graph para as ações que você quer ativar. Você precisa do ID do locatário, do ID do cliente e da chave secreta do cliente desse aplicativo para concluir as etapas desta página.
Para mais detalhes, consulte Configuração do Microsoft 365.
Criar o repositório de dados do Microsoft 365
Para criar o repositório de dados do Microsoft 365, siga estas etapas:
No console Google Cloud , acesse a página Gemini Enterprise.
Clique em Repositórios de dados no menu de navegação.
Clique em Criar repositório de dados.
Na seção Origem, pesquise Microsoft 365 e clique em Selecionar.
Na seção Ações, em Selecionar ações do Microsoft 365 para ativar, escolha as ações que você quer ativar:
As ações são agrupadas pela superfície do Microsoft 365 em que atuam: Usuários e grupos, SharePoint e OneDrive, Outlook e Teams. Selecione um grupo para ativar todas as ações nele ou selecione ações individuais.
As ações somente leitura aparecem na mesma lista que as ações de gravação. Somente Get my profile está pré-selecionado. Portanto, selecione também as outras ações somente leitura necessárias.
Para encontrar uma ação pelo nome, use Pesquisar ações. Para ativar todas as ações, selecione Selecionar todas as ações.
Clique em Continuar.
Na seção Dados, abra Configurações de autenticação. Em Selecione seu método de autenticação, escolha uma das seguintes opções:
OAuth 2.0 (gerenciado pelo Google) (padrão):
Não é necessário inserir um ID de locatário, ID do cliente ou chave secreta do cliente. Deixe o Tipo de ambiente do Microsoft 365 definido como Padrão: o aplicativo gerenciado peloGoogleé registrado na nuvem comercial da Microsoft. Cada usuário autoriza o conector com a conta do Microsoft 365 quando o usa pela primeira vez no app.
OAuth 2.0 (Traga seu próprio app):
Insira os seguintes detalhes do aplicativo Microsoft Entra:
- ID do locatário: o ID do locatário do Microsoft 365.
- ID do cliente: o ID do cliente do registro do app Microsoft Entra.
- Chave secreta do cliente: a chave secreta do cliente do registro do app Microsoft Entra.
- Tipo de ambiente do Microsoft 365: selecione Padrão para
locatários em
login.microsoftonline.comou Governo dos EUA para locatários emlogin.microsoftonline.us.
Clique em Verificar autenticação, faça login com a conta que você quer que o conector use e conceda o consentimento. O Gemini Enterprise armazena o token de atualização resultante na conexão. Você não precisa inseri-lo manualmente.
Clique em Continuar.
Expanda Opções avançadas e faça o seguinte:
Se o fluxo de criação do repositório de dados mostrar uma seção Opções avançadas, marque 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 o tráfego de saída, adequado para inclusão na lista de permissões no sistema de origem. Para mais informações, consulte Configurar saída de IP estático.
Os endereços IP estáticos estão disponíveis apenas com o OAuth 2.0 (Traga seu próprio app).
Opcional: em Ambiente de nuvem do Microsoft 365, selecione o endpoint do Microsoft Graph que seu locatário usa: Padrão / GCC, GCC High ou DoD. Se você deixar essa opção desmarcada, o conector vai usar Standard / GCC.
Clique em Continuar.
Abra Entidades para pesquisar e selecione Pesquisa Enterprise.
Clique em Continuar.
Na seção Configuração:
Na lista Multirregional, selecione o local do repositório de dados.
No campo Nome do conector de dados, insira um nome para o repositório de dados.
Opcional: no campo Tag, insira um identificador estável para esse repositório de dados em todas as versões. Esse valor é imutável depois de definido.
Se você selecionou
usoueucomo 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.
Opcional: na seção Política de Proteção de Dados Sensíveis, anexe uma política da Proteção de Dados Sensíveis para inspecionar e desidentificar os dados que o Gemini Enterprise recupera por esse repositório de dados. Se a organização não exigir uma política de Proteção de Dados Sensíveis, pule esta etapa.
Clique em Criar.
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 Criando para Ativo, será possível começar a usar o repositório de dados do Microsoft 365.
Depois de criar o repositório de dados, conecte-o a um app atual ou crie um novo app e conecte-o ao novo app. Em seguida, autorize o Gemini Enterprise a acessar o Microsoft 365 antes de executar qualquer consulta.
Mudar as ações ativadas
Selecione as ações que serão ativadas na etapa Ações ao criar o repositório de dados. Para adicionar ou remover ações depois, consulte Adicionar ações.
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 Microsoft 365 e enviar uma consulta de pesquisa para o Gemini Enterprise:
- O Gemini Enterprise envia sua consulta de pesquisa diretamente para a API Microsoft Graph.
- 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 de terceiros (API Microsoft Graph).
- 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.
A seguir
- Para fornecer uma interface do usuário para consultar seus dados do Microsoft 365, crie um app e conecte-o ao repositório de dados do Microsoft 365.
- Para conferir e gerenciar a lista de ações ativadas para o repositório de dados do Microsoft 365, consulte Conferir e gerenciar ações.
- 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.