데이터 제휴를 통해 Microsoft OneDrive 연결

이 페이지에서는 데이터 제휴를 사용하여 Microsoft OneDrive를 Gemini Enterprise에 연결하는 방법을 설명합니다.

다음 절차에 따라 제휴 검색을 사용하여 Microsoft OneDrive 계정을 검색합니다.

데이터 제휴 정보

데이터 제휴를 사용하면 Gemini Enterprise는 데이터를 Gemini Enterprise에 복사하는 대신 API를 사용하여 서드 파티 데이터 소스에서 정보를 직접 가져옵니다. 이 방법을 사용하면 수집을 기다리지 않고 즉시 외부 데이터 소스에 액세스할 수 있습니다.

Microsoft OneDrive 제휴 설정을 시작하기 전에

제휴 검색을 사용하여 Microsoft OneDrive 데이터 스토어에 연결하기 전에 다음 단계를 수행하세요.

  1. Microsoft Entra ID에 Gemini Enterprise를 OAuth 2.0 애플리케이션으로 등록하고 다음 정보를 수집합니다.

    • 클라이언트 ID
    • 클라이언트 보안 비밀번호
    • 인스턴스 URL: 조직의 OneDrive URL입니다. 예를 들면 https://example-my.sharepoint.com입니다.
    • 테넌트 ID

  2. Microsoft OneDrive 관리자의 동의를 받아 다음 Microsoft Graph 애플리케이션 권한을 구성합니다.

    권한

    유형

    설명

    Files.Read.All

    위임

    사용자가 액세스할 수 있는 모든 파일 읽기

    Sites.Read.All

    위임

    모든 사이트 컬렉션의 항목 읽기

  3. 다음 URL을 웹 콜백 URL로 추가합니다.

    • https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html
    • https://vertexaisearch.cloud.google.com/oauth-redirect

OneDrive로 제휴 검색 커넥터 만들기

Google Cloud 콘솔을 사용하여 Gemini Enterprise에서 Microsoft OneDrive를 통해 제휴 검색을 수행하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 Gemini Enterprise 페이지로 이동합니다.

    Gemini Enterprise

  2. 탐색 메뉴에서 데이터 스토어를 클릭합니다.

  3. 데이터 저장소 만들기를 클릭합니다.

  4. 데이터 소스 선택 페이지에서 OneDrive 제휴 검색을 선택하여 서드 파티 데이터 소스를 연결합니다.

  5. 인증 설정에서 사용할 인증 방법을 선택합니다.

    1. 클라이언트 ID, 클라이언트 보안 비밀번호, 인스턴스 URL, 테넌트 ID를 입력합니다.

    2. 인증을 클릭합니다.

    3. 계속을 클릭합니다.

  6. 데이터 소스의 리전을 선택합니다.

  7. 데이터 소스의 이름을 입력합니다.

  8. 만들기를 클릭합니다. Gemini Enterprise는 데이터 스토어를 만들고 데이터 스토어 페이지에 표시합니다.

데이터 스토어가 생성되면 데이터 스토어 페이지로 이동하여 데이터 스토어 이름을 클릭하여 상태를 확인합니다. 커넥터 상태가 생성 중에서 활성으로 변경되면 제휴 검색 커넥터를 사용할 수 있습니다.

사용자 승인

제휴 검색 데이터 스토어를 만들면 소스 관리 패널에 데이터 소스 중 하나로 표시됩니다. 이전에 Gemini Enterprise를 승인하지 않은 경우 데이터 소스를 선택할 수 없습니다. 대신 승인 버튼이 표시됩니다.

승인 흐름을 시작하려면 다음 단계를 따르세요.

  1. 승인을 클릭합니다. OneDrive 승인 서버로 리디렉션됩니다.

  2. 계정에 로그인합니다.

  3. 액세스 권한 부여를 클릭합니다. 액세스 권한을 부여하면 승인 흐름을 완료하기 위해 Gemini Enterprise로 리디렉션됩니다. Gemini Enterprise는 액세스 토큰을 획득하고 이를 사용하여 Microsoft OneDrive 검색에 액세스합니다.

쿼리 실행

Microsoft OneDrive를 승인한 후 검색어를 입력하면 다음과 같은 결과가 표시됩니다.

  1. Gemini Enterprise는 검색어를 Microsoft Graph API로 전송합니다.

  2. Gemini Enterprise는 결과를 다른 소스의 결과와 혼합하여 표시합니다.

데이터 처리

서드 파티 제휴 검색을 사용하면 쿼리 문자열이 서드 파티 검색 백엔드로 전송됩니다. 이러한 서드 파티는 쿼리를 사용자의 ID와 연결할 수 있습니다. 여러 제휴 검색 데이터 소스가 사용 설정된 경우 쿼리가 모든 데이터 소스로 전송될 수 있습니다.

데이터가 서드 파티 시스템에 도달하면 해당 시스템의 서비스 약관 및 개인정보처리방침이 적용됩니다.

오류 코드

다음 표에는 OneDrive 오류 코드와 설명이 나와 있습니다.

오류 코드 설명
ONEDRIVE_MISSING_PERMISSION_1 애플리케이션에 Graph API에 필요한 역할 Files.Read.All이 없습니다.
ONEDRIVE_MISSING_PERMISSION_2 애플리케이션에 Graph API에 필요한 역할 Group.Read.All이 없습니다.
ONEDRIVE_MISSING_PERMISSION_3 애플리케이션에 Graph API에 필요한 역할 User.Read.All 또는 User.ReadBasic.All이 없습니다.
ONEDRIVE_INVALID_SITE_URI 인스턴스 URL이 잘못되었습니다.
ONEDRIVE_INVALID_AUTH Graph API 액세스 토큰을 가져오는 중에 오류가 발생했습니다. 잘못된 클라이언트 ID, 잘못된 보안 비밀 값 또는 누락된 제휴 사용자 인증 정보 때문일 수 있습니다.
ONEDRIVE_UNCATEGORIZED_ERROR 파일에 ACL이 없거나 잘못되었습니다.
ONEDRIVE_TOO_MANY_REQUESTS OneDrive가 너무 많은 HTTP 요청을 수신하여 HTTP 429 응답을 반환했습니다.

다음 단계