개요

Gemini Enterprise용 Microsoft OneDrive 커넥터를 사용하면 Microsoft OneDrive에 액세스하고 파일 및 폴더와 상호작용할 수 있습니다.

지원되는 Microsoft OneDrive 버전

Microsoft OneDrive 커넥터는 Microsoft Graph API v1.0을 통해 호스팅되는 모든 버전의 Microsoft OneDrive를 지원합니다.

지원되는 작업

Microsoft OneDrive 커넥터를 사용 설정하면 최종 사용자가 Gemini Enterprise에서 자연어 명령어를 사용하여 다음 작업을 실행할 수 있습니다.

작업 설명
폴더 만들기 Microsoft OneDrive의 지정된 경로에 새 폴더를 만듭니다.
파일 복사 Microsoft OneDrive의 소스에서 대상으로 파일을 복사합니다.

필수 권한

Gemini Enterprise가 Microsoft OneDrive 데이터 스토어를 사용하여 검색 및 데이터 수집을 실행하려면 다음 권한이 필요합니다.

Microsoft Graph API 권한

아래 표에는 각 연결 모드에 필요한 권한이 나와 있습니다.

참고: 다음 표에는 각 연결 모드에 필요한 권한이 나와 있습니다. 제휴 검색 또는 데이터 수집 연결 모드에 대해 작업을 사용 설정하는 경우 작업 행에 나열된 권한도 선택합니다.

연결 모드 범위 목적
제휴 검색 Files.Read.All (위임됨) 커넥터가 사용자가 액세스할 수 있는 모든 파일을 읽을 수 있도록 허용합니다.
Sites.Read.All (위임됨) 커넥터가 사용자가 액세스할 수 있는 모든 사이트 모음의 문서를 읽고 항목을 나열할 수 있도록 허용합니다.
데이터 수집 GroupMember.Read.All (제휴 사용자 인증 정보 및 OAuth 2.0 갱신 토큰) 커넥터가 로그인한 사용자 없이 모든 그룹의 멤버십과 기본 그룹 속성을 읽을 수 있도록 허용합니다.
User.Read (제휴 사용자 인증 정보 및 OAuth 2.0 갱신 토큰) 커넥터가 로그인한 사용자의 프로필을 읽을 수 있도록 허용합니다. 또한 커넥터가 로그인한 사용자의 기본 회사 정보를 읽을 수 있도록 허용합니다.
User.Read.All (OAuth 2.0 갱신 토큰만 해당) 커넥터가 사용자 프로필을 읽을 수 있도록 허용합니다.
Sites.FullControl.All (옵션 1)
Sites.Selected (옵션 2)		 (제휴 사용자 인증 정보 및 OAuth 2.0 새로고침 토큰) 옵션 1을 사용하면 커넥터가 모든 사이트 모음을 완전히 제어할 수 있습니다. 옵션 2를 사용하면 커넥터가 사이트 모음의 하위 집합에 액세스할 수 있습니다. 특정 사이트 모음과 부여된 권한은 Microsoft OneDrive에서 구성할 수 있습니다.
User.Read.All (옵션 1)
User.ReadBasic.All (옵션 2)		 (연결된 사용자 인증 정보만 해당) 옵션 1을 사용하면 커넥터가 사용자 프로필을 읽을 수 있습니다. 옵션 2를 사용하면 커넥터가 조직의 다른 사용자의 기본 프로필 속성을 읽을 수 있습니다.
작업 Files.ReadWrite.AppFolder (위임됨) 커넥터가 Microsoft OneDrive 폴더에서 파일을 읽고, 만들고, 업데이트하고, 삭제할 수 있도록 허용합니다.
Files.ReadWrite (위임됨) 커넥터가 사용자가 액세스할 수 있는 파일을 읽고, 만들고, 업데이트하고, 삭제할 수 있도록 허용합니다.

Microsoft OneDrive 권한을 추가하는 방법은 Microsoft OneDrive 구성 및 필요한 권한 설정을 참고하세요.

제한사항

이 섹션에서는 Microsoft OneDrive 커넥터 사용에 영향을 줄 수 있는 알려진 문제와 제한사항을 설명합니다.

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

  • Microsoft OneDrive 데이터 저장소는 전역, 미국, EU 위치에서만 지원됩니다.

  • 새 애플리케이션을 만들거나 기존 애플리케이션에 데이터 스토어를 추가할 때는 단일 커넥터 유형에 속하는 작업이 있는 데이터 스토어를 추가하는 것이 좋습니다. 예를 들어 작업이 사용 설정된 동일한 애플리케이션에 두 개의 Microsoft OneDrive 데이터 스토어를 연결하지 마세요.

Microsoft OneDrive 제휴 커넥터의 제한사항은 다음과 같습니다.

  • 검색 제한: 검색 결과는 다를 수 있으며 모든 파일 형식에 대해 항상 포괄적이지는 않습니다. 보관처리되거나 암호화된 폴더의 콘텐츠는 검색할 수 없을 수 있습니다. 연합 검색은 첨부파일 내 검색을 지원하지 않습니다.
  • 위임된 액세스 권한: 공유된 Microsoft OneDrive 파일 또는 폴더에 액세스하려면 표준 사용자 승인으로 처리되지 않는 특정 권한이 필요할 수 있습니다.

Microsoft OneDrive 수집 커넥터에는 다음과 같은 제한사항이 있습니다.

  • 증분 동기화는 복사, 이동, 이름 변경과 같은 폴더 수준 작업을 감지하지 않습니다.

다음 단계