개요

Gemini Enterprise용 Microsoft Outlook 데이터 스토어를 사용하면 OneDrive 및 SharePoint에 저장된 이메일, 캘린더, 연락처, Microsoft 365 파일 (Excel 통합 문서, Word 문서, PowerPoint 프레젠테이션)을 검색하고 작업을 실행할 수 있습니다.

지원되는 Microsoft Outlook 버전

Microsoft Outlook 데이터 스토어는 IDP 통합을 지원하는 Microsoft Graph API v1.0을 지원합니다.

지원되는 작업

Microsoft Outlook 데이터 스토어가 사용 설정되면 최종 사용자는 Gemini Enterprise에서 자연어 명령어를 사용하여 다음 작업을 실행할 수 있습니다.

작업	설명
연락처 만들기	Microsoft Outlook에서 새 연락처를 만듭니다.
이벤트 만들기	새 이벤트를 만듭니다.
첨부파일 다운로드	Microsoft Outlook 이메일 메시지에서 첨부파일을 다운로드합니다.
메일 보내기	이메일 메시지를 보냅니다. 여기에는 첨부파일이 있는 이메일 보내기가 포함됩니다.
연락처 업데이트	Microsoft Outlook에서 기존 연락처를 업데이트합니다.
이벤트 업데이트	기존 이벤트를 업데이트합니다.
Excel 데이터 읽기	OneDrive 또는 SharePoint에 저장된 Excel (.xlsx) 파일에서 통합 문서, 워크시트, 표, 행을 나열하고 읽습니다.
Excel 데이터 수정	OneDrive 또는 SharePoint에 저장된 Excel (.xlsx) 파일에서 행을 추가하고 업데이트하며, 워크시트와 표를 만들고, 주요 열을 추가합니다.
Word 문서 만들기	사용자의 OneDrive에 새 Word (.docx) 문서를 만듭니다.
Word 문서를 PDF로 변환	OneDrive 또는 SharePoint에 저장된 Word (.docx) 문서를 PDF로 변환합니다.
PowerPoint 프레젠테이션 만들기	사용자의 OneDrive에 새 PowerPoint (.pptx) 프레젠테이션을 만듭니다.
PowerPoint를 PDF로 변환	OneDrive 또는 SharePoint에 저장된 PowerPoint (.pptx) 프레젠테이션을 PDF로 변환합니다.

참고:

• 읽기 전용 작업도 추가로 사용할 수 있습니다.
• Gemini Enterprise에서 파일 업로드 및 다운로드의 최대 파일 크기는 25MB입니다.
• Excel, Word, PowerPoint 작업을 실행하려면 사용자가 작업 중인 OneDrive 또는 SharePoint 파일에 Microsoft Graph API 권한을 추가로 부여해야 합니다. 자세한 내용은 [필수 권한](#required-permissions)을 참고하세요.

필수 권한

다음 표에는 Microsoft Outlook 검색 및 작업에 필요한 권한이 나와 있습니다.

연결 모드	권한	목적
통합 검색	Mail.Read Mail.Read.Shared Calendars.Read Contacts.Read	(위임됨) 데이터 스토어가 로그인한 사용자의 편지함, 공유 편지함의 이메일, 캘린더 이벤트, 연락처를 읽을 수 있도록 허용합니다.
데이터 수집	Calendars.Read	(애플리케이션) 데이터 스토어가 모든 캘린더의 이벤트를 읽을 수 있도록 허용합니다.
	Calendars.ReadBasic.All	(애플리케이션) 데이터 스토어가 본문, 첨부파일, 확장 프로그램과 같은 속성을 제외한 모든 캘린더의 이벤트를 읽을 수 있도록 허용합니다.
	Contacts.Read	(애플리케이션) 데이터 스토어가 모든 편지함의 모든 연락처를 읽을 수 있도록 허용합니다.
	Mail.Read	(애플리케이션) 데이터 스토어가 모든 편지함의 메일을 읽을 수 있도록 허용합니다.
	Mail.ReadBasic	(애플리케이션) 데이터 스토어가 모든 편지함의 기본 메일 속성을 읽을 수 있도록 허용합니다. 본문, previewBody, 첨부파일, 확장 속성을 제외한 모든 속성이 포함됩니다.
	Mail.ReadBasic.All	(애플리케이션) 데이터 스토어가 모든 편지함의 기본 메일 속성을 읽을 수 있도록 허용합니다. 본문, previewBody, 첨부파일, 확장 속성을 제외한 모든 속성이 포함됩니다.
	User.Read	(위임됨) 데이터 스토어가 로그인한 사용자의 프로필을 읽을 수 있도록 허용합니다.
	User.Read.All	(애플리케이션) 데이터 스토어가 조직 내 다른 사용자의 전체 프로필 속성, 보고서, 관리자를 읽을 수 있도록 허용합니다.
	User.ReadBasic.All	(애플리케이션) 데이터 스토어가 조직 내 다른 사용자의 기본 프로필 속성 집합을 읽을 수 있도록 허용합니다.
작업	Mail.Send	(위임됨) 데이터 스토어가 조직의 사용자로 메일을 보낼 수 있도록 허용합니다.
	Calendars.ReadWrite	(위임됨) 데이터 스토어가 사용자 캘린더에서 이벤트를 만들고, 읽고, 업데이트하고, 삭제할 수 있도록 허용합니다.
	Contacts.ReadWrite	(위임됨) 데이터 스토어가 사용자 연락처를 만들고, 읽고, 업데이트하고, 삭제할 수 있도록 허용합니다.
	User.Read	(위임됨) 데이터 스토어가 로그인한 사용자의 프로필을 읽을 수 있도록 허용합니다.
파일 생산성 (Excel, Word, PowerPoint)	Files.Read.All	(위임됨) 파일 메타데이터를 읽거나 파일 콘텐츠를 다운로드하는 도구에 만 충분합니다. Excel 통합 문서 나열, Excel 통합 문서 메타데이터 읽기, Word (.docx) 또는 PowerPoint (.pptx) 문서를 PDF로 변환하는 데 사용됩니다. 사용자가 액세스할 수 있는 모든 파일(사용자가 액세스할 수 있는 SharePoint 사이트에 저장된 파일 포함)을 읽습니다. Excel 통합 문서 콘텐츠 작업에는 충분하지 않습니다 (다음 행 참고).
	Files.ReadWrite.All	(위임됨) 워크시트 가져오기, 표 가져오기, 행 가져오기, 행 가져오기, 워크시트 및 표 만들기, 행 추가 및 업데이트, 주요 열 추가를 비롯한 모든 Excel 통합 문서 콘텐츠 작업 (읽기 및 쓰기)에 필요합니다. 이러한 엔드포인트 (예: worksheet-list, table-list, tablerow-list)의 Microsoft Graph API 참조에 따라 허용되는 위임된 권한은 Files.ReadWrite입니다. Files.ReadWrite.All은 사용자가 액세스할 수 있는 모든 드라이브 (개인 OneDrive 및 사용자가 액세스할 수 있는 모든 SharePoint 문서 라이브러리)에서 동일한 기능을 부여합니다. 사용자의 OneDrive에서 Word 및 PowerPoint 문서를 만드는 데도 필요합니다.
	User.Read	(위임됨) 파일 작업에 로그인한 사용자의 OneDrive 위치를 확인하는 데 필요합니다.
작업 (Outlook 할 일 목록 및 작업)	Tasks.Read	(위임됨) 로그인한 사용자의 Outlook 작업 목록 및 작업에 대한 읽기 작업 (작업 목록 나열, 작업 나열, 작업 가져오기)에 필요합니다.
	Tasks.ReadWrite	(위임됨) 쓰기 작업에 필요합니다. 로그인한 사용자의 Outlook 작업 목록에서 작업을 만들고, 업데이트하고, 삭제합니다.
사용자 및 디렉터리 (위임된 열거)	User.ReadBasic.All	(위임됨) 조직 내 다른 사용자의 프로필을 열거하거나 조회하는 도구 (사용자 가져오기, 사용자 나열, 다른 사용자의 편지함 또는 캘린더에서 작동하는 도구)에 필요합니다.

참고: 위의 파일 생산성 작업을 실행하려면 사용자의 테넌트 관리자가 OAuth 앱 등록에 해당하는 Microsoft Graph API 권한을 부여해야 합니다. 이러한 권한이 부여되지 않으면 Excel, Word, PowerPoint 도구에 대한 요청이 HTTP 403 accessDenied 오류로 실패합니다. 권장사항: 모든 파일 생산성 도구를 포함하는 Files.ReadWrite.All을 부여합니다. Word 또는 PowerPoint PDF 변환과 Excel 통합 문서 목록/메타데이터 (워크시트, 표, 행 액세스 없음)만 필요한 경우 Files.Read.All만으로 충분합니다. driveItem 기반 작업 (Word/PowerPoint PDF 변환, Excel 통합 문서 나열, Excel 통합 문서 메타데이터 읽기)의 경우 Microsoft Graph는 Sites.Read.All 또는 Sites.ReadWrite.All을 허용되는 대안으로 문서화합니다 (driveItem-get 및 driveItem-get-content-format 참고). 설정 단계에 필요한 Microsoft Outlook 구성 및 권한 설정을 참고하세요.

참고: Tasks.Read 또는 Tasks.ReadWrite가 누락되면 Outlook 작업 도구가 HTTP 403 notAllowed로 실패합니다. User.ReadBasic.All (위임됨)이 누락되면 사용자 조회 도구가 HTTP 403 Authorization_RequestDenied로 실패합니다. 더 높은 권한의 사용자 액세스가 필요한 테넌트는 User.ReadBasic.All 대신 User.Read.All 또는 Directory.Read.All을 사용할 수 있습니다.

Microsoft Outlook의 권한을 추가하는 방법에 대한 자세한 내용은 Microsoft Outlook 구성 및 필요한 권한 설정을 참고하세요.

데이터 수집의 비율 제한

요청 볼륨 한도는 10분당 10,000개의 API 요청입니다. 이러한 비율 제한은 연결 모드로 수집을 선택할 때 Microsoft Outlook 데이터 스토어에만 적용됩니다.

제한사항

이 섹션에서는 Microsoft Outlook 데이터 스토어 사용에 영향을 줄 수 있는 알려진 문제와 제한사항을 설명합니다.

• 새 앱을 만들거나 기존 앱에 데이터 스토어를 추가할 때는 단일 커넥터 유형에 속하는 작업에 데이터 스토어를 하나만 연결하는 것이 좋습니다.

• 기존 Microsoft Outlook 데이터 스토어에 VPC 서비스 제어 경계를 적용하는 것은 지원되지 않습니다. VPC 서비스 제어를 적용하려면 데이터 스토어를 삭제하고 다시 만들어야 합니다. VPC 서비스 제어 및 VPC 서비스 제어를 사용 설정한 후 작업을 사용하는 방법에 대한 자세한 내용은 VPC 서비스 제어로 앱 보호를 참고하세요.

• Microsoft Outlook 데이터 스토어는 global, us, eu 위치에서만 지원됩니다.

• Microsoft Outlook 데이터 스토어는 노드별로 초당 트랜잭션 1개를 처리할 수 있으며 이 한도를 초과하는 트랜잭션을 제한합니다.

• Microsoft Outlook 데이터 스토어의 비율 제한 초과 오류에 대한 재시도 기능은 Outlook 데이터 스토어에만 제공되는 Microsoft Graph API의 retry-after 값을 수신하는 데 따라 달라집니다. 기본 재시도 횟수는 3회입니다.

• Microsoft Outlook 데이터 스토어의 처리량은 Microsoft Graph에서 부과하는 API 호출 제한에 따라 제한됩니다. 제한은 각 앱 ID와 편지함 조합, 즉 특정 사용자 또는 그룹 편지함에 액세스하는 특정 앱에 적용됩니다. 하나의 편지함에 대한 한도를 초과해도 애플리케이션이 다른 편지함에 액세스하는 기능에는 영향을 미치지 않습니다.

• Microsoft Outlook 데이터 스토어는 단일 Azure 테넌트 ID와 일대일로 매핑됩니다. 다중 테넌트 조직 (MTO) 내에서 격리된 여러 Microsoft 365 테넌트에 걸쳐 있을 수 없습니다. 각 고유 테넌트에 전용 데이터 스토어를 만들어야 합니다.

• 편지함은 Exchange Online으로 완전히 이전되어야 합니다. 하이브리드 Exchange 환경에서 온프레미스로 호스팅되는 편지함은 Microsoft Graph API를 통해 액세스할 수 없습니다. 이러한 편지함 또는 테넌트 간 편지함을 쿼리하려고 하면 MailboxNotEnabledForRESTAPI 오류가 발생할 수 있습니다.

• Microsoft Outlook 데이터 스토어는 노드별로 초당 트랜잭션 1개를 처리할 수 있으며 이 한도를 초과하는 트랜잭션을 제한합니다.

다음 단계

• Microsoft Outlook으로 데이터 스토어를 만들고 구성하려면 Microsoft Outlook 데이터 스토어 설정을 참고하세요.