Visão geral

O repositório de dados do Microsoft Outlook para o Gemini Enterprise permite pesquisar e realizar ações em e-mails, agendas, contatos e arquivos do Microsoft 365 (pastas de trabalho do Excel, documentos do Word e apresentações do PowerPoint) armazenados no OneDrive e no SharePoint.

Observação: ao usar a pesquisa federada ou os conectores federados, sua string de consulta é enviada para todos os back-ends de pesquisa de terceiros ativados. A string de consulta enviada para um sistema de terceiros pode incluir partes dos dados na solicitação de pesquisa e no histórico de conversas. O sistema de terceiros pode vincular a consulta à sua identidade. Depois que os dados estão no sistema de terceiros, eles estão sujeitos aos Termos de Serviço e às Políticas de Privacidade desse sistema, não aos Termos de Serviço do Google Cloud.

Versões compatíveis do Microsoft Outlook

O repositório de dados do Microsoft Outlook é compatível com a API Microsoft Graph v1.0 com integração de IDP.

Ações permitidas

Quando o repositório de dados do Microsoft Outlook está ativado, os usuários finais podem usar comandos em linguagem natural no Gemini Enterprise para realizar as seguintes ações.

Ação	Descrição
Criar contato	Cria um novo contato no Microsoft Outlook.
Criar evento	Cria um evento.
Fazer o download dos anexos	Baixa um anexo de uma mensagem de e-mail do Microsoft Outlook.
Enviar e-mail	Envia uma mensagem de e-mail. Isso inclui o envio de e-mails com anexos.
Adicionar anexos	Adiciona um ou mais anexos a um rascunho de mensagem de e-mail.
Criar mensagem	Cria um novo rascunho de mensagem de e-mail na caixa de correio do usuário conectado.
Encaminhar e-mails	Encaminha uma mensagem de e-mail para um ou mais destinatários.
Mover e-mail	Move uma mensagem de e-mail para outra pasta na caixa de correio do usuário conectado.
Responder à mensagem	Envia uma resposta a uma mensagem de e-mail na caixa de correio do usuário que fez login.
Atualizar mensagem	Atualiza um rascunho de mensagem de e-mail na caixa de correio do usuário conectado.
Atualizar contato	Atualiza um contato no Microsoft Outlook.
Atualizar evento	Atualiza um evento.
Ler dados do Excel	Lista pastas de trabalho, lê planilhas, tabelas e linhas de arquivos do Excel (.xlsx) armazenados no OneDrive ou no SharePoint.
Editar dados do Excel	Adiciona e atualiza linhas, cria planilhas e tabelas e adiciona colunas de chave em arquivos do Excel (.xlsx) armazenados no OneDrive ou no SharePoint.
Criar documento do Word	Cria um novo documento do Word (.docx) no OneDrive do usuário.
Converter documento do Word em PDF	Converte um documento do Word (.docx) armazenado no OneDrive ou no SharePoint em PDF.
Criar apresentação do PowerPoint	Cria uma nova apresentação do PowerPoint (.pptx) no OneDrive do usuário.
Converter PowerPoint em PDF	Converte uma apresentação do PowerPoint (.pptx) armazenada no OneDrive ou no SharePoint em PDF.
Criar agenda	Cria uma nova agenda para o usuário conectado.
Atualizar agenda	Atualiza uma agenda do usuário que fez login.
Confirmar presença no evento	Responde (aceita, recusa ou aceita provisoriamente) a um convite de evento da agenda.

Observações:

• Outras ações somente leitura também estão disponíveis.
• O tamanho máximo de arquivo para uploads e downloads no Gemini Enterprise é de 25 MB.
• As ações do Excel, Word e PowerPoint exigem permissões adicionais da API Microsoft Graph nos arquivos do OneDrive ou do SharePoint com que o usuário está trabalhando. Para mais detalhes, consulte [Permissões necessárias](#required-permissions).

Permissões necessárias

A tabela a seguir descreve as permissões necessárias para pesquisa e ações do Microsoft Outlook.

Modo de conexão	Permissão	Purpose
Pesquisa federada	Mail.Read Mail.Read.Shared Calendars.Read Contacts.Read	(Delegado) Permite que o repositório de dados leia a caixa de correio do usuário conectado, e-mails de caixas de correio compartilhadas, eventos da agenda e contatos.
Ingestão de dados	Calendars.Read	(Aplicativo) Permite que o repositório de dados leia eventos de todas as agendas.
	Calendars.ReadBasic.All	(Aplicativo) Permite que o repositório de dados leia eventos de todas as agendas, exceto propriedades como corpo, anexos e extensões.
	Contacts.Read	(Aplicativo) Permite que o repositório de dados leia todos os contatos em todas as caixas de correio.
	Mail.Read	(Aplicativo) Permite que o repositório de dados leia e-mails em todas as caixas de correio.
	Mail.ReadBasic	(Aplicativo) Permite que o repositório de dados leia as propriedades básicas de e-mails em todas as caixas de correio. Inclui todas as propriedades, exceto body, previewBody, attachments e as propriedades estendidas.
	Mail.ReadBasic.All	(Aplicativo) Permite que o repositório de dados leia as propriedades básicas de e-mail em todas as caixas de correio. Inclui todas as propriedades, exceto body, previewBody, attachments e as propriedades estendidas.
	User.Read	(Delegado) Permite que o repositório de dados leia o perfil dos usuários que fizeram login.
	User.Read.All	(Aplicativo) Permite que o repositório de dados leia o conjunto completo de propriedades de perfil, relatórios e gerentes de outros usuários na sua organização.
	User.ReadBasic.All	(Aplicativo) Permite que o repositório de dados leia um conjunto básico de propriedades de perfil de outros usuários na sua organização.
Ações	Mail.Send	(Delegado) Permite que o repositório de dados envie e-mails como usuários na organização.
	Mail.ReadWrite	(Delegado) Permite que o repositório de dados crie, leia, atualize, mova e exclua mensagens, além de adicionar anexos a elas. Obrigatório para as ações **Adicionar anexos**, **Criar mensagem**, **Atualizar mensagem** e **Mover e-mail**.
	Calendars.ReadWrite	(Delegado) Permite que o repositório de dados crie, leia, atualize e exclua eventos nas agendas dos usuários.
	Contacts.ReadWrite	(Delegado) Permite que o repositório de dados crie, leia, atualize e exclua contatos de usuários.
	User.Read	(Delegado) Permite que o repositório de dados leia o perfil dos usuários que fizeram login.
Produtividade de arquivos (Excel, Word, PowerPoint)	Files.Read.All	(Delegado) Suficiente apenas para ferramentas que leem metadados de arquivos ou fazem o download do conteúdo de arquivos: listar pastas de trabalho do Excel, ler metadados de pastas de trabalho do Excel e converter documentos do Word (.docx) ou do PowerPoint (.pptx) em PDF. Lê todos os arquivos que o usuário pode acessar, incluindo os armazenados em sites do SharePoint que o usuário pode acessar. Não é suficiente para operações de conteúdo de pastas de trabalho do Excel (consulte a próxima linha).
	Files.ReadWrite.All	(Delegada) Obrigatória para todas as operações de conteúdo da pasta de trabalho do Excel (leitura e gravação), incluindo receber planilhas, receber tabelas, receber linhas, receber linha, criar planilhas e tabelas, adicionar e atualizar linhas e adicionar colunas de chave. De acordo com a referência da API Microsoft Graph para esses endpoints (por exemplo, worksheet-list, table-list, tablerow-list), a permissão delegada aceita é Files.ReadWrite. Files.ReadWrite.All concede a mesma capacidade em todos os drives que o usuário pode acessar (o OneDrive pessoal e qualquer biblioteca de documentos do SharePoint que o usuário pode acessar). Também é necessário para criar documentos do Word e do PowerPoint no OneDrive do usuário.
	User.Read	(Delegada) Necessária para resolver o local do OneDrive do usuário conectado para operações de arquivo.
Tarefas (listas de tarefas e tarefas do Outlook)	Tasks.Read	(Delegado) Obrigatório para operações de leitura nas listas de tarefas e tarefas do Outlook do usuário conectado (listar listas de tarefas, listar tarefas, receber tarefa).
	Tasks.ReadWrite	(Delegado) Obrigatório para operações de gravação: criar, atualizar e excluir tarefas nas listas de tarefas do Outlook do usuário conectado.
Usuários e diretório (enumeração delegada)	User.ReadBasic.All	(Delegada) Necessária para ferramentas que enumeram ou pesquisam perfis de outros usuários na organização (Get User, List Users e ferramentas que operam em caixas de correio ou agendas de outros usuários).

Observação: as ações de produtividade de arquivos acima exigem que o administrador do locatário do usuário conceda as permissões correspondentes da API Microsoft Graph no registro do app OAuth. Se essas permissões não forem concedidas, as solicitações para as ferramentas do Excel, Word e PowerPoint vão falhar com um erro HTTP 403 accessDenied. Recomendado: conceda Files.ReadWrite.All, que abrange todas as ferramentas de produtividade de arquivos. Se você só precisa da conversão de PDF do Word ou do PowerPoint e da listagem/metadados da pasta de trabalho do Excel (sem acesso à planilha, tabela ou linha), basta usar o Files.Read.All. Para as operações baseadas em driveItem (conversão de PDF do Word/PowerPoint, listagem de pastas de trabalho do Excel, leitura de metadados de pastas de trabalho do Excel), o Microsoft Graph também documenta Sites.Read.All ou Sites.ReadWrite.All como alternativas aceitas (consulte driveItem-get e driveItem-get-content-format). Consulte Configurar o Microsoft Outlook e definir as permissões necessárias para as etapas de configuração.

Observação: a ausência de Tasks.Read ou Tasks.ReadWrite faz com que as ferramentas de tarefas do Outlook falhem com o HTTP 403 notAllowed. A ausência de User.ReadBasic.All (delegado) faz com que as ferramentas de pesquisa de usuários falhem com o HTTP 403 Authorization_RequestDenied. Os locatários que precisam de acesso de usuário com privilégios mais altos podem substituir User.Read.All ou Directory.Read.All por User.ReadBasic.All.

Para saber como adicionar as permissões do Microsoft Outlook, consulte Configurar o Microsoft Outlook e definir as permissões necessárias.

Limites de taxa para ingestão de dados

O limite de volume de solicitações é de 10.000 solicitações de API por período de 10 minutos. Esses limites de taxa se aplicam exclusivamente ao repositório de dados do Microsoft Outlook quando você escolhe usar a ingestão como modo de conexão.

Limitações

Esta seção descreve problemas e limitações conhecidos que podem afetar o uso do repositório de dados do Microsoft Outlook.

• Ao criar um app ou adicionar um repositório de dados a um app, recomendamos associar apenas um repositório de dados a ações que pertencem a um único tipo de conector.

• Não é possível aplicar um perímetro do VPC Service Controls em repositórios de dados do Microsoft Outlook. Para aplicar o VPC Service Controls, exclua e recrie os repositórios de dados. Para mais informações sobre o VPC Service Controls e como usar ações depois de ativar o VPC Service Controls, consulte Proteger seu app com o VPC Service Controls.

• O repositório de dados do Microsoft Outlook só é compatível com os locais global, us e eu.

• O repositório de dados do Microsoft Outlook pode processar uma transação por segundo, por nó, e limita as transações que ultrapassam esse limite.

• A capacidade do repositório de dados do Microsoft Outlook de tentar novamente em caso de erros de limite de taxa excedido depende do recebimento de um valor retry-after da API Microsoft Graph, que é fornecido apenas para o repositório de dados do Outlook. O número padrão de novas tentativas é três.

• A capacidade de processamento do repositório de dados do Microsoft Outlook é limitada pelas restrições de chamada de API impostas pelo Microsoft Graph. Os limites se aplicam a cada combinação de ID do app e caixa de correio, ou seja, um app específico que acessa uma caixa de correio de usuário ou grupo específica. Exceder o limite de uma caixa de e-mails não afeta a capacidade do aplicativo de acessar outra caixa de e-mails.

• O repositório de dados do Microsoft Outlook é mapeado individualmente com um único ID de locatário do Azure. Ele não pode abranger vários locatários isolados do Microsoft 365 em uma organização multilocatário (MTO, na sigla em inglês). É preciso criar um repositório de dados dedicado para cada locatário.

• As caixas de correio precisam ser totalmente migradas para o Exchange Online. As caixas de correio hospedadas no local em um ambiente híbrido do Exchange não podem ser acessadas pela API Microsoft Graph. As tentativas de consultar essas caixas de correio ou de vários locatários podem resultar em um erro MailboxNotEnabledForRESTAPI.

• O repositório de dados do Microsoft Outlook pode processar uma transação por segundo por nó e limita as transações que ultrapassam esse limite.

A seguir

• Para criar e configurar um repositório de dados com o Microsoft Outlook, consulte Configurar um repositório de dados do Microsoft Outlook.