Panoramica

Il datastore Microsoft Outlook per Gemini Enterprise ti consente di cercare ed eseguire azioni su email, calendari, contatti e file Microsoft 365 (cartelle di lavoro Excel, documenti Word e presentazioni PowerPoint) archiviati in OneDrive e SharePoint.

Nota:quando utilizzi la ricerca federata o i connettori federati, la stringa di query viene inviata a tutti i backend di ricerca di terze parti abilitati. La stringa di query inviata a un sistema di terze parti potrebbe contenere parti dei dati nella tua richiesta di ricerca e nella cronologia delle conversazioni. Il sistema di terze parti può collegare la query alla tua identità. Una volta che i dati si trovano nel sistema di terze parti, sono soggetti ai Termini di servizio e alle norme sulla privacy di quel sistema, non ai Termini di servizio di Google Cloud.

Versioni di Microsoft Outlook supportate

Il datastore Microsoft Outlook supporta l'API Microsoft Graph v1.0 con l'integrazione dell'IdP.

Azioni supportate

Quando il datastore di Microsoft Outlook è abilitato, 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. Ciò include l'invio di email con allegati.
Aggiorna contatto	Aggiorna un contatto esistente in Microsoft Outlook.
Aggiorna evento	Aggiorna un evento esistente.
Lettura dei dati Excel	Elenca le cartelle di lavoro, legge i fogli di lavoro, le tabelle e le righe dei file Excel (.xlsx) archiviati in OneDrive o SharePoint.
Modificare i dati di Excel	Aggiunge e aggiorna righe, crea fogli di lavoro e tabelle e aggiunge colonne chiave nei file Excel (.xlsx) archiviati in OneDrive o SharePoint.
Creare un documento Word	Crea un nuovo documento Word (.docx) nel OneDrive dell'utente.
Convertire un documento Word in PDF	Converte un documento Word (.docx) archiviato in OneDrive o SharePoint in PDF.
Creare una presentazione PowerPoint	Crea un nuovo file di presentazione PowerPoint (.pptx) nell'OneDrive dell'utente.
Convertire PowerPoint in PDF	Converte in PDF una presentazione PowerPoint (.pptx) archiviata in OneDrive o SharePoint.

Note:

• Sono disponibili anche altre azioni di sola lettura.
• La dimensione massima dei file per i caricamenti e i download in Gemini Enterprise è 25 MB.
• Le azioni di Excel, Word e PowerPoint richiedono autorizzazioni API Microsoft Graph aggiuntive per i file OneDrive o SharePoint con cui l'utente sta lavorando. Per maggiori dettagli, vedi [Autorizzazioni richieste](#required-permissions).

Autorizzazioni obbligatorie

La seguente tabella descrive le autorizzazioni richieste per la ricerca e le azioni di Microsoft Outlook.

Modalità di connessione	Autorizzazione	Purpose
Ricerca federata	Mail.Read Mail.Read.Shared Calendars.Read Contacts.Read	(Delegato) 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 di proprietà come corpo, allegati ed estensioni.
	Contacts.Read	(Applicazione) Consente al datastore di leggere tutti i contatti in tutte le caselle postali.
	Mail.Read	(Applicazione) Consente al datastore di leggere la posta in tutte le caselle postali.
	Mail.ReadBasic	(Applicazione) Consente al datastore di leggere le proprietà di base della posta in tutte le caselle postali. Include tutte le proprietà tranne body, previewBody, allegati e tutte le proprietà estese.
	Mail.ReadBasic.All	(Applicazione) Consente al datastore di leggere le proprietà di base della posta in tutte le caselle postali. Include tutte le proprietà tranne body, previewBody, allegati e tutte le proprietà estese.
	User.Read	(Delegato) 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	(Delegato) Consente al datastore di inviare email come utenti dell'organizzazione.
	Calendars.ReadWrite	(Delegato) Consente al datastore di creare, leggere, aggiornare ed eliminare eventi nei calendari degli utenti.
	Contacts.ReadWrite	(Delegato) Consente al datastore di creare, leggere, aggiornare ed eliminare i contatti utente.
	User.Read	(Delegato) Consente al datastore di leggere il profilo degli utenti che hanno eseguito l'accesso.
Produttività dei file (Excel, Word, PowerPoint)	Files.Read.All	(Delegato) Sufficiente solo per gli strumenti che leggono i metadati dei file o scaricano i contenuti dei file: elencare le cartelle di lavoro Excel, leggere i metadati delle cartelle di lavoro Excel e convertire i documenti Word (.docx) o PowerPoint (.pptx) in PDF. Legge tutti i file a cui l'utente può accedere, inclusi i file archiviati nei siti SharePoint a cui l'utente ha accesso. Non sufficiente per le operazioni sui contenuti della cartella di lavoro Excel (vedi riga successiva).
	Files.ReadWrite.All	(Delegato) Obbligatorio per tutte le operazioni sui contenuti della cartella di lavoro Excel (lettura e scrittura), tra cui recuperare fogli di lavoro, tabelle, righe e righe, creare fogli di lavoro e tabelle, aggiungere e aggiornare righe e aggiungere colonne chiave. In base al riferimento API Microsoft Graph per questi endpoint (ad esempio worksheet-list, table-list, tablerow-list), l'autorizzazione delegata accettata è Files.ReadWrite. Files.ReadWrite.All concede la stessa funzionalità in tutti i drive a cui l'utente può accedere (OneDrive personale e qualsiasi raccolta documenti di SharePoint a cui l'utente ha accesso). Obbligatorio anche per creare documenti Word e PowerPoint in OneDrive dell'utente.
	User.Read	(Delegato) Obbligatorio 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	(Delegato) Obbligatorio per le operazioni di lettura sugli elenchi di attività e sulle attività di Outlook dell'utente che ha eseguito l'accesso (elenca elenchi di attività, elenca attività, ottieni 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	(Delegato) Obbligatorio per gli strumenti che enumerano o cercano i profili di altri utenti dell'organizzazione (Recupera utente, Elenca utenti e strumenti che operano sulle caselle postali o sui calendari di altri utenti).

Nota:le azioni di produttività dei file sopra indicate richiedono che l'amministratore tenant dell'utente conceda le autorizzazioni API Microsoft Graph corrispondenti alla registrazione dell'app OAuth. Se queste autorizzazioni non vengono concesse, le richieste agli strumenti Excel, Word e PowerPoint non vanno a buon fine e viene visualizzato un errore HTTP 403 accessDenied. Consigliato:concedi Files.ReadWrite.All, che copre ogni strumento di produttività dei file. Se hai bisogno solo della conversione in PDF di Word o PowerPoint e dell'elenco/metadati delle cartelle di lavoro Excel (senza accesso a fogli di lavoro, tabelle o righe), è sufficiente Files.Read.All. Per le operazioni basate su driveItem (conversione di PDF Word/PowerPoint, elenco di cartelle di lavoro Excel, lettura dei metadati delle cartelle di lavoro Excel), Microsoft Graph documenta anche Sites.Read.All o Sites.ReadWrite.All come alternative accettate (vedi driveItem-get e driveItem-get-content-format). Per i passaggi di configurazione, vedi Configurare Microsoft Outlook e impostare le autorizzazioni necessarie.

Nota: la mancanza di Tasks.Read o Tasks.ReadWrite causa l'errore degli strumenti di attività di Outlook con HTTP 403 notAllowed. La mancanza di User.ReadBasic.All (delegato) fa sì che gli strumenti di ricerca degli utenti non funzionino con HTTP 403 Authorization_RequestDenied. I tenant che necessitano di un accesso utente con privilegi più elevati possono sostituire User.Read.All o Directory.Read.All con User.ReadBasic.All.

Per informazioni su come aggiungere le autorizzazioni per Microsoft Outlook, vedi Configurare Microsoft Outlook e impostare le autorizzazioni necessarie.

Limiti di frequenza per l'importazione dati

Il limite di volume delle 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 uno esistente, ti consigliamo di associare un solo datastore alle azioni appartenenti a un unico 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 abilitati, consulta Proteggere l'app con i Controlli di servizio VPC.

• Il datastore Microsoft Outlook è supportato solo nelle località global, us e eu.

• Il datastore Microsoft Outlook può elaborare una transazione al secondo per nodo e limita le transazioni che superano questo limite.

• La possibilità 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.

• Il throughput dell'datastore di Microsoft Outlook è limitato 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 specifica di un utente o di un gruppo. Il superamento del limite per una casella di posta non influisce sulla capacità dell'applicazione di accedere a un'altra casella di posta.

• L'datastore di Microsoft Outlook esegue il mapping uno a uno con un singolo ID tenant Azure. Non può estendersi a più tenant Microsoft 365 isolati all'interno di un'organizzazione multi-tenant (MTO). Devi creare un datastore dedicato per ogni tenant distinto.

• Le caselle postali devono essere completamente migrate a Exchange Online. Le caselle postali ospitate on-premise in un ambiente Exchange ibrido non sono accessibili tramite l'API Microsoft Graph. I tentativi di eseguire query su queste caselle postali o su quelle cross-tenant possono generare un errore MailboxNotEnabledForRESTAPI.

• Il datastore Microsoft Outlook può elaborare una transazione al secondo per nodo e limita le transazioni che superano questo limite.

Passaggi successivi

• Per creare e configurare un datastore con Microsoft Outlook, vedi Configurare un datastore Microsoft Outlook.