개요

Gemini Enterprise용 Microsoft OneDrive 데이터 스토어를 사용하면 파일 및 폴더를 검색하고 작업을 실행할 수 있습니다.

지원되는 Microsoft OneDrive 버전

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

지원되는 작업

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

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

필수 권한

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

Microsoft Graph API 권한

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

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

연결 모드 범위 목적
제휴 검색 Files.Read.All (위임됨) 데이터 스토어가 사용자가 액세스할 수 있는 모든 파일을 읽을 수 있도록 허용합니다.
Sites.Read.All (위임됨) 데이터 스토어가 사용자가 액세스할 수 있는 모든 사이트 모음의 문서 및 목록 항목을 읽을 수 있도록 허용합니다.
User.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 데이터 스토어는 global, us, 및 eu 위치에서만 지원됩니다.

Microsoft OneDrive 제휴 데이터 스토어의 제한사항은 다음과 같습니다.

  • 검색 제한사항: 검색결과는 파일 형식에 따라 다를 수 있으며 항상 포괄적이지는 않습니다. 보관처리되거나 암호화된 폴더의 콘텐츠는 검색을 위해 액세스할 수 없을 수 있습니다. 제휴 검색은 첨부파일 내 검색을 지원하지 않습니다.
  • 위임된 액세스 권한: 공유 Microsoft OneDrive 파일 또는 폴더에 액세스하려면 표준 사용자 승인에서 다루지 않는 특정 권한이 필요할 수 있습니다.
  • 제휴 검색 모드의 레이아웃 파서: 레이아웃 파서는 표준이지만 제휴 검색 모드에서는 복잡한 PDF (표, 다중 열 레이아웃 또는 OCR이 필요한 PDF)에 대한 효과가 제한됩니다. 이 모드의 실시간 API 호출은 데이터 수집 중에 레이아웃 파서가 실행하는 심층 분석에 필요한 완전한 데이터 또는 시간을 제공하지 않을 수 있습니다.

  • 지원되지 않는 PDF 기능: 따라서 복잡한 PDF 구조는 완전히 분석하거나 검색할 수 없을 수 있습니다. 여기에는 다음이 포함됩니다.

    • 다중 열 텍스트 레이아웃
    • 삽입된 표 및 차트 내 데이터
    • 광학 문자 인식 (OCR)이 필요한 스캔된 문서의 텍스트
    • 비선형 읽기 순서 또는 복잡한 서식이 있는 문서

Microsoft OneDrive 수집 데이터 스토어의 제한사항은 다음과 같습니다.

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

권장사항

표, 다중 열 레이아웃 또는 OCR 종속 콘텐츠와 같은 복잡한 기능이 포함된 PDF가 포함된 Microsoft OneDrive 데이터의 경우 효과적인 검색을 위해 데이터 수집 모드를 사용하는 것이 좋습니다. 이 모드를 사용하면 레이아웃 파서가 전체 문서 콘텐츠를 심층적으로 처리하고 색인을 생성할 수 있습니다.

다음 단계