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 (planilhas do Excel, documentos do Word e apresentações do PowerPoint) armazenados no OneDrive e no SharePoint.
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 do IDP.
Ações permitidas
Quando o repositório de dados do Microsoft Outlook está ativado, os usuários finais podem usar comandos de 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 novo evento. |
| Baixar 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. |
| Atualizar contato | Atualiza um contato existente no Microsoft Outlook. |
| Atualizar evento | Atualiza um evento existente. |
| 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 principais 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. |
Permissões necessárias
A tabela a seguir descreve as permissões necessárias para a pesquisa e as ações do Microsoft Outlook.
| Modo de conexão | Permissão | Purpose |
|---|---|---|
| Pesquisa federada | Mail.ReadMail.Read.Shared |
(Delegada) Permite que o repositório de dados leia a caixa de e-mails do usuário conectado, e-mails de caixas de e-mails 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 e-mails. | |
Mail.Read |
(Aplicativo) Permite que o repositório de dados leia e-mails em todas as caixas de e-mails. | |
Mail.ReadBasic |
(Aplicativo) Permite que o repositório de dados leia propriedades básicas de e-mails em todas as caixas de e-mails. Inclui todas as propriedades, exceto corpo, previewBody, anexos e propriedades estendidas. | |
Mail.ReadBasic.All |
(Aplicativo) Permite que o repositório de dados leia propriedades básicas de e-mails em todas as caixas de e-mails. Inclui todas as propriedades, exceto corpo, previewBody, anexos e propriedades estendidas. | |
User.Read |
(Delegada) Permite que o repositório de dados leia o perfil dos usuários conectados. | |
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 |
(Delegada) Permite que o repositório de dados envie e-mails como usuários na organização. |
Calendars.ReadWrite |
(Delegada) Permite que o repositório de dados crie, leia, atualize e exclua eventos nas agendas dos usuários. | |
Contacts.ReadWrite |
(Delegada) Permite que o repositório de dados crie, leia, atualize e exclua contatos de usuários. | |
User.Read |
(Delegada) Permite que o repositório de dados leia o perfil dos usuários conectados. | |
| Produtividade de arquivos (Excel, Word, PowerPoint) | Files.Read.All |
(Delegada) Suficiente apenas para ferramentas que leem metadados de arquivos ou baixam conteúdo de arquivos: listagem de pastas de trabalho do Excel, leitura de metadados de pastas de trabalho do Excel e conversão de documentos do Word (.docx) ou do PowerPoint (.pptx) em PDF. Lê todos os arquivos que o usuário pode acessar, incluindo arquivos armazenados em sites do SharePoint a que o usuário tem acesso. Não é suficiente para operações de conteúdo de pastas de trabalho do Excel (consulte a próxima linha). |
Files.ReadWrite.All |
(Delegada) Necessário para todas as operações de conteúdo de pastas 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 principais. 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 todas as unidades a que o usuário pode acessar (OneDrive pessoal e qualquer biblioteca de documentos do SharePoint a que o usuário tenha acesso). Também é necessário para criar documentos do Word e do PowerPoint no OneDrive do usuário. |
|
User.Read |
(Delegada) Necessário 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 |
(Delegada) Necessá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 |
(Delegada) Necessá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ário para ferramentas que enumeram ou pesquisam perfis de outros usuários na organização (receber usuário, listar usuários e ferramentas que operam nas caixas de e-mails ou agendas de outros usuários). |
Para informações sobre 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 novo app ou adicionar um repositório de dados a um app existente, recomendamos associar apenas um repositório de dados a ações pertencentes a um único tipo de conector.
- Não há suporte para a aplicação de um perímetro do VPC Service Controls em repositórios de dados do Microsoft Outlook. Para aplicar o VPC Service Controls, é necessário excluir e recriar 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
global,us, eeulocais.
O repositório de dados do Microsoft Outlook pode processar uma transação por segundo, por nó, e limita todas as transações além desse limite.
A capacidade do repositório de dados do Microsoft Outlook de tentar novamente em erros de limite de taxa excedido depende do recebimento de um valor retry-after da API Microsoft Graph, que só é fornecido para o repositório de dados do Outlook. O número padrão de tentativas é três.
A capacidade de processamento do repositório de dados do Microsoft Outlook é limitada pelas restrições de chamadas de API impostas pelo Microsoft Graph. Os limites se aplicam a cada combinação de ID do app e caixa de e-mails, ou seja, um app específico que acessa uma caixa de e-mails de usuário ou grupo específico. 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ária (MTO, na sigla em inglês). É necessário criar um repositório de dados dedicado para cada locatário distinto.
As caixas de e-mails precisam ser totalmente migradas para o Exchange Online. As caixas de e-mails 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 e-mails ou caixas de e-mails entre 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 todas as transações além desse 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.