Il datastore Microsoft Outlook per Gemini Enterprise ti consente di cercare ed eseguire azioni su email, calendari, contatti e file di Microsoft 365 (cartelle di lavoro di Excel, documenti di Word e presentazioni di PowerPoint) archiviati in OneDrive e SharePoint.
Versioni di Microsoft Outlook supportate
Il datastore Microsoft Outlook supporta l'API Microsoft Graph v1.0 con l'integrazione IDP.
Azioni supportate
Quando il datastore Microsoft Outlook è attivo, gli utenti finali possono utilizzare i comandi in linguaggio naturale in Gemini Enterprise per eseguire le seguenti azioni.
| Azione | Descrizione |
|---|---|
| Crea contatto | Crea un nuovo contatto in Microsoft Outlook. |
| Creazione evento | Crea un nuovo evento. |
| Scarica allegati | Scarica un allegato da un messaggio email di Microsoft Outlook. |
| Invia email | Invia un messaggio email. È incluso l'invio di email con allegati. |
| Aggiorna contatto | Aggiorna un contatto esistente in Microsoft Outlook. |
| Aggiorna evento | Aggiorna un evento esistente. |
| Leggi i dati di Excel | Elenca le cartelle di lavoro, legge i fogli di lavoro, le tabelle e le righe dei file di Excel (.xlsx) archiviati in OneDrive o SharePoint. |
| Modifica i dati di Excel | Aggiunge e aggiorna le righe, crea fogli di lavoro e tabelle e aggiunge colonne chiave nei file di Excel (.xlsx) archiviati in OneDrive o SharePoint. |
| Crea un documento Word | Crea un nuovo documento di Word (.docx) nel OneDrive dell'utente. |
| Converti il documento Word in PDF | Converte in PDF un documento di Word (.docx) archiviato in OneDrive o SharePoint. |
| Crea una presentazione di PowerPoint | Crea una nuova presentazione di PowerPoint (.pptx) nel OneDrive dell'utente. |
| Converti PowerPoint in PDF | Converte in PDF una presentazione di PowerPoint (.pptx) archiviata in OneDrive o SharePoint. |
Autorizzazioni obbligatorie
La tabella seguente descrive le autorizzazioni richieste per la ricerca e le azioni di Microsoft Outlook.
| Modalità di connessione | Autorizzazione | Purpose |
|---|---|---|
| Ricerca federata | Mail.ReadMail.Read.Shared |
(Delegata) Consente al datastore di leggere la casella di posta dell'utente che ha eseguito l'accesso, le email dalle caselle di posta condivise, gli eventi di calendario e i contatti. |
| Acquisizione dei dati | Calendars.Read |
(Applicazione) Consente al datastore di leggere gli eventi di tutti i calendari. |
Calendars.ReadBasic.All |
(Applicazione) Consente al datastore di leggere gli eventi di tutti i calendari, ad eccezione delle proprietà come corpo, allegati ed estensioni. | |
Contacts.Read |
(Applicazione) Consente al datastore di leggere tutti i contatti in tutte le caselle di posta. | |
Mail.Read |
(Applicazione) Consente al datastore di leggere la posta in tutte le caselle di posta. | |
Mail.ReadBasic |
(Applicazione) Consente al datastore di leggere le proprietà di base della posta in tutte le caselle di posta. Include tutte le proprietà ad eccezione di corpo, previewBody, allegati e proprietà estese. | |
Mail.ReadBasic.All |
(Applicazione) Consente al datastore di leggere le proprietà di base della posta in tutte le caselle di posta. Include tutte le proprietà ad eccezione di corpo, previewBody, allegati e proprietà estese. | |
User.Read |
(Delegata) Consente al datastore di leggere il profilo degli utenti che hanno eseguito l'accesso. | |
User.Read.All |
(Applicazione) Consente al datastore di leggere l'insieme completo di proprietà del profilo, report e gestori di altri utenti dell'organizzazione. | |
User.ReadBasic.All |
(Applicazione) Consente al datastore di leggere un insieme di base di proprietà del profilo di altri utenti dell'organizzazione. | |
| Azioni | Mail.Send |
(Delegata) Consente al datastore di inviare email come utenti dell'organizzazione. |
Calendars.ReadWrite |
(Delegata) Consente al datastore di creare, leggere, aggiornare ed eliminare eventi nei calendari degli utenti. | |
Contacts.ReadWrite |
(Delegata) Consente al datastore di creare, leggere, aggiornare ed eliminare i contatti degli utenti. | |
User.Read |
(Delegata) Consente al datastore di leggere il profilo degli utenti che hanno eseguito l'accesso. | |
| Produttività dei file (Excel, Word, PowerPoint) | Files.Read.All |
(Delegata) Obbligatoria per le operazioni di lettura sulle cartelle di lavoro di Excel (elenco, recupero di fogli di lavoro, tabelle, righe) e per la conversione di Word o PowerPoint in PDF. Legge tutti i file a cui l'utente può accedere, inclusi i file archiviati nei siti di SharePoint a cui l'utente ha accesso. |
Files.ReadWrite.All |
(Delegata) Obbligatoria per le operazioni di scrittura: creazione di fogli di lavoro e tabelle di Excel, aggiunta e aggiornamento di righe di Excel, aggiunta di colonne chiave e creazione di documenti di Word e PowerPoint nel OneDrive dell'utente. | |
User.Read |
(Delegata) Obbligatoria per risolvere la posizione di OneDrive dell'utente che ha eseguito l'accesso per le operazioni sui file. | |
| Attività (elenchi di cose da fare e attività di Outlook) | Tasks.Read |
(Delegata) Obbligatoria per le operazioni di lettura sugli elenchi di attività e sulle attività di Outlook dell'utente che ha eseguito l'accesso (elenco degli elenchi di attività, elenco delle attività, recupero dell'attività). |
Tasks.ReadWrite |
(Delegata) Obbligatoria per le operazioni di scrittura: creazione, aggiornamento ed eliminazione di attività negli elenchi di attività di Outlook dell'utente che ha eseguito l'accesso. | |
| Utenti e directory (enumerazione delegata) | User.ReadBasic.All |
(Delegata) Obbligatoria per gli strumenti che enumerano o cercano i profili di altri utenti dell'organizzazione (Recupera utente, Elenca utenti e strumenti che operano sulle caselle di posta o sui calendari di altri utenti). |
Per informazioni su come aggiungere le autorizzazioni per Microsoft Outlook, consulta Configurare Microsoft Outlook e impostare le autorizzazioni necessarie.
Limiti di frequenza per importazione dati
Il limite del volume di richieste è di 10.000 richieste API per un periodo di 10 minuti. Questi limiti di frequenza si applicano esclusivamente al datastore Microsoft Outlook quando scegli di utilizzare l'importazione come modalità di connessione.
Limitazioni
Questa sezione descrive i problemi noti e le limitazioni che potrebbero influire sull'utilizzo del datastore Microsoft Outlook.
- Quando crei una nuova app o aggiungi un datastore a una esistente, ti consigliamo di associare un solo datastore alle azioni appartenenti a un singolo tipo di connettore.
- L'applicazione di un perimetro di Controlli di servizio VPC ai datastore Microsoft Outlook esistenti non è supportata. Per applicare i Controlli di servizio VPC, devi eliminare e ricreare i datastore. Per saperne di più sui Controlli di servizio VPC e su come utilizzare le azioni dopo averli attivati, consulta Proteggere l'app con i Controlli di servizio VPC.
- Il datastore Microsoft Outlook è supportato solo nelle
global,usedeulocalità.
Il datastore Microsoft Outlook può elaborare una transazione al secondo per nodo e limita le transazioni oltre questo limite.
La capacità del datastore Microsoft Outlook di riprovare in caso di errori di superamento del limite di frequenza dipende dalla ricezione di un valore retry-after dall'API Microsoft Graph, che viene fornito solo per il datastore Outlook. Il numero predefinito di tentativi è tre.
La velocità effettiva del datastore Microsoft Outlook è limitata dalle restrizioni delle chiamate API imposte da Microsoft Graph. I limiti si applicano a ogni combinazione di ID app e casella di posta, ovvero a un'app specifica che accede a una casella di posta di un utente o di un gruppo specifico. Il superamento del limite per una casella di posta non influisce sulla capacità dell'applicazione di accedere a un'altra casella di posta.
Passaggi successivi
- Per creare e configurare un datastore con Microsoft Outlook, consulta Configurare un datastore Microsoft Outlook.