Panoramica

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.
Crea evento	Crea un nuovo evento.
Scarica allegati	Scarica un allegato da un messaggio email di Microsoft Outlook.
Invia email	Invia un messaggio email. Include 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 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 Excel (.xlsx) archiviati in OneDrive o SharePoint.
Crea documento Word	Crea un nuovo documento Word (.docx) nel OneDrive dell'utente.
Converti documento Word in PDF	Converte in PDF un documento Word (.docx) archiviato in OneDrive o SharePoint.
Crea presentazione PowerPoint	Crea una nuova presentazione PowerPoint (.pptx) nel OneDrive dell'utente.
Converti 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 è di 25 MB.
• Le azioni di Excel, Word e PowerPoint richiedono autorizzazioni aggiuntive dell'API Microsoft Graph sui file di OneDrive o SharePoint con cui l'utente sta lavorando. Per maggiori dettagli, vedi [Autorizzazioni obbligatorie](#required-permissions).

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.Read Mail.Read.Shared Calendars.Read Contacts.Read	(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 di 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 qualsiasi proprietà estesa.
	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 qualsiasi proprietà estesa.
	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) Sufficiente solo per gli strumenti che leggono i metadati dei file o scaricano i contenuti dei file: elencare le cartelle di lavoro di Excel, leggere i metadati delle cartelle di lavoro di 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 di SharePoint a cui l'utente ha accesso. Non sufficiente per le operazioni sui contenuti delle cartelle di lavoro di Excel (vedi la riga successiva).
	Files.ReadWrite.All	(Delegata) Obbligatoria per tutte le operazioni sui contenuti delle cartelle di lavoro di Excel (lettura e scrittura), inclusi get worksheets, get tables, get rows, get row, create worksheets and tables, add and update rows e add key columns. In base al riferimento dell'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). Obbligatoria anche per la creazione di documenti 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 (list task lists, list tasks, get task).
	Tasks.ReadWrite	(Delegata) Obbligatoria per le operazioni di scrittura: creazione, aggiornamento ed eliminazione delle 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 (Get User, List Users e strumenti che operano sulle caselle di posta o sui calendari di altri utenti).

Nota:le azioni di produttività dei file sopra riportate richiedono che l'amministratore del tenant dell'utente conceda le autorizzazioni dell'API Microsoft Graph corrispondenti alla registrazione dell'app OAuth. Se queste autorizzazioni non vengono concesse, le richieste agli strumenti di Excel, Word e PowerPoint non vanno a buon fine e viene restituito un errore HTTP 403 accessDenied. Consigliato:concedi Files.ReadWrite.All, che copre tutti gli strumenti di produttività dei file. Se hai bisogno solo della conversione in PDF di Word o PowerPoint e dell'elenco/dei metadati delle cartelle di lavoro di Excel (nessun accesso a fogli di lavoro, tabelle o righe), Files.Read.All è sufficiente. Per le operazioni basate su driveItem (conversione in PDF di Word/PowerPoint, elenco delle cartelle di lavoro di Excel, lettura dei metadati delle cartelle di lavoro di 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 fa sì che gli strumenti per le attività di Outlook non vadano a buon fine e venga restituito un errore HTTP 403 notAllowed. La mancanza di User.ReadBasic.All (delegata) fa sì che gli strumenti di ricerca degli utenti non vadano a buon fine e venga restituito un errore HTTP 403 Authorization_RequestDenied. I tenant che richiedono l'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 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, vedi Proteggere l'app con i Controlli di servizio VPC.

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

• 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.

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

• La migrazione delle caselle di posta a Exchange Online deve essere completata. Le caselle di posta ospitate on-premise in un ambiente Exchange ibrido non sono accessibili tramite l'API Microsoft Graph. I tentativi di eseguire query su queste caselle di posta o su quelle tra tenant possono generare un errore MailboxNotEnabledForRESTAPI.

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

Passaggi successivi

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