서드 파티 데이터 소스 연결

참고: 이 기능은 미리보기 버전이며 GCP 서비스별 약관의 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 제품 및 기능은 지원이 제한될 수 있으며, GA 이전 제품 및 기능의 변경사항이 다른 GA 이전 버전과 호환되지 않을 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요. 또한 이 기능을 사용하면 생성형 AI 미리보기 이용약관('미리보기 약관')에 동의하는 것으로 간주됩니다. 이 기능의 경우 Cloud 데이터 처리 추가 조항에 설명된 대로 개인 정보를 처리할 수 있으며, 여기에는 (미리보기 약관에 정의된) 해당 계약의 제한 및 의무가 적용됩니다.

이 페이지에서는 서드 파티 데이터 소스를 Vertex AI Search에 연결하는 방법을 설명합니다.

미리보기: 서드 파티 커넥터는 허용 목록과 함께 미리보기 버전으로 제공됩니다. 이 기능을 사용하려면 허용 목록에 있어야 합니다.

서드 파티 데이터 소스를 연결하면 Vertex AI Search에서 데이터 커넥터를 만들고 지정된 항목의 데이터 스토어(항목 데이터 스토어라고 함)를 연결합니다. 항목 유형은 연결하려는 데이터 소스에 따라 다릅니다. 예를 들어 Jira Cloud 항목에는 문제, 첨부파일, 댓글, 워크로그가 포함됩니다.

서드 파티 데이터 소스는 일반 검색 앱에서만 사용할 수 있습니다. 채팅, 추천, 에이전트 앱은 서드 파티 데이터 소스를 사용할 수 없습니다.

서드 파티 커넥터는 CMEK 규정을 준수하지 않습니다.

대신 Google 데이터 소스에서 데이터를 가져오려면 검색 데이터 스토어 만들기를 참조하세요.

시작하기 전에

1. Google 계정팀에 문의하여 서드 파티 데이터 소스 커넥터의 허용 목록에 추가해 달라고 요청합니다.

2. 사용하려는 소스의 섹션으로 이동합니다.

   • Confluence Cloud 연결
   • Jira Cloud 연결
   • Salesforce 연결
   • ServiceNow 연결
   • Sharepoint Online 연결
   • Slack 연결
   • Dropbox 연결
   • Box 연결
   • OneDrive 연결

Confluence Cloud 연결

다음 절차에 따라 Confluence Cloud의 데이터를 Vertex AI Search와 동기화합니다.

미리보기: 서드 파티 커넥터는 허용 목록과 함께 미리보기 버전으로 제공됩니다. 이 기능을 사용하려면 허용 목록에 있어야 합니다.

데이터 소스를 설정하고 데이터를 처음 가져온 후에는 데이터 스토어가 설정 중에 선택한 빈도로 해당 소스의 데이터를 동기화합니다.

연결을 설정하기 전에 다음을 확인하세요.

• 데이터 소스의 액세스 제어를 설정합니다. 액세스 제어 설정에 관한 자세한 내용은 데이터 소스 액세스 제어 사용을 참조하세요.

• 다음 인증 정보를 준비하세요.

  • 인스턴스 URL. 형식은 https://EXAMPLE.atlassian.net입니다(예: https://google.atlassian.net).

  • 인스턴스 ID. cloudid이며 https://EXAMPLE.atlassian.net/_edge/tenant_info로 이동하여 cloudId 값을 복사하면 찾을 수 있습니다.

• OAuth 2.0을 사용 설정하고 클라이언트 ID와 클라이언트 보안 비밀번호를 가져옵니다.

  https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html을 콜백 URL로 사용합니다. Confluence Cloud에 OAuth 2.0을 사용 설정하고 클라이언트 ID 및 클라이언트 보안 비밀번호를 가져오는 방법에 관한 자세한 내용은 Atlassian 개발자 문서의 OAuth 2.0(3LO) 앱을 참조하세요.

• OAuth 2.0 권한 범위를 설정할 때 다음 범위를 구성합니다.

  범위 보기

  • read:permission:confluence
  • read:content:confluence
  • read:content-details:confluence
  • read:space-details:confluence
  • read:audit-log:confluence
  • read:page:confluence
  • read:attachment:confluence
  • read:blogpost:confluence
  • read:custom-content:confluence
  • read:comment:confluence
  • read:template:confluence
  • read:label:confluence
  • read:watcher:confluence
  • read:group:confluence
  • read:relation:confluence
  • read:user:confluence
  • read:configuration:confluence
  • read:space:confluence
  • read:space.permission:confluence
  • read:space.property:confluence
  • read:user.property:confluence
  • read:space.setting:confluence
  • read:analytics.content:confluence
  • read:content.permission:confluence
  • read:content.property:confluence
  • read:content.restriction:confluence
  • read:content.metadata:confluence

• 사용자 권한이 올바르게 적용되려면 각 Confluence Cloud 사용자가 모든 사용자에게 이메일을 표시해야 합니다. 이렇게 하려면 Confluence Cloud에서 이메일 공개 상태 설정을 변경하고 공개 상태를 Anyone으로 설정하세요. 자세한 내용은 Atlassian 문서의 이메일 공개 상태 설정을 참조하세요.

콘솔

Google Cloud 콘솔을 사용하여 Confluence Cloud의 데이터를 Vertex AI Search와 동기화하려면 다음 단계를 따르세요.

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

   Agent Builder를 사용하여 이 모든 것을 자체 데이터에 그라운딩하세요.

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

3. 새 데이터 스토어를 클릭합니다.

4. 데이터 소스 선택 페이지에서 서드 파티 소스 섹션으로 이동하여 Confluence를 선택합니다.

5. 인증 정보를 입력하고 인증을 클릭합니다.

6. 새 창이 나타납니다. 인스턴스 사용자 이름과 비밀번호를 입력합니다. 데이터 스토어의 Confluence 소스 지정 페이지로 돌아가기 전에 인증이 완료되었는지 확인합니다.

7. 동기화할 항목을 선택한 다음 계속을 클릭합니다.

8. 데이터 커넥터의 리전을 선택합니다.

9. 데이터 커넥터의 이름을 입력합니다.

10. 동기화 빈도를 선택합니다.

11. 만들기를 클릭합니다. Vertex AI Search가 데이터 스토어를 만들고 데이터 스토어 페이지에 데이터 스토어를 표시합니다.

12. 수집 상태를 확인하려면 데이터 스토어 페이지로 이동하여 데이터 스토어 이름을 클릭한 후 데이터 페이지에서 세부정보를 확인합니다. 데이터 동기화를 시작하면 커넥터 상태가 만들기에서 실행 중으로 변경됩니다. 수집이 완료되면 상태가 활성으로 변경되어 데이터 소스 연결이 설정되고 다음으로 예약된 동기화를 기다리고 있음을 나타냅니다.

    데이터 크기에 따라 수집에 몇 분 또는 몇 시간까지 걸릴 수 있습니다.

다음 단계

• 데이터 스토어를 앱에 연결하려면 앱을 만들고 검색 앱 만들기의 단계를 따라 데이터 스토어를 선택합니다.

• 서드 파티 액세스 제어가 있는 앱의 결과 미리보기를 참조하세요.

Jira Cloud 연결

다음 절차에 따라 Jira Cloud의 데이터를 Vertex AI Search와 동기화합니다.

미리보기: 서드 파티 커넥터는 허용 목록과 함께 미리보기 버전으로 제공됩니다. 이 기능을 사용하려면 허용 목록에 있어야 합니다.

데이터 소스를 설정하고 데이터를 처음 가져온 후 데이터 스토어가 해당 소스와 동기화되는 빈도를 선택할 수 있습니다.

시작하기 전에

연결을 설정하기 전에 다음을 확인하세요.

• 액세스 제어를 설정합니다. 액세스 제어가 데이터 소스에 맞게 구성되었는지 확인합니다. 이렇게 하면 승인된 사용자만 데이터를 액세스하고 관리할 수 있습니다. 자세한 내용은 데이터 소스 액세스 제어 사용 문서를 참조하세요.
• 사용자 권한을 올바르게 적용하려면 Jira Cloud 사용자가 공유 콘텐츠를 제공해야 합니다.
• Atlassian 계정, Jira 인스턴스, 프로젝트가 있는지 확인합니다.
• Jira 인스턴스 및 프로젝트에 대해 관리자 액세스 권한이 있는지 확인합니다.

Jira에서 인증 및 권한 설정

다음 섹션의 안내에 따라 Jira 인스턴스에 대해 필요한 인증 세부정보 및 관리자 액세스 권한이 있는지 확인합니다. Atlassian 개발자 콘솔을 통해 클라이언트 ID 및 클라이언트 보안 비밀번호를 만들고, 필요한 OAuth 2.0 범위를 구성하고, 사용자 권한을 설정합니다. 마지막으로 인스턴스 URL과 ID를 검색하고, 역할을 구성하고, Jira Cloud와 Vertex AI Search 사이에 데이터를 동기화하기 위해 인증을 수행합니다.

클라이언트 ID와 클라이언트 보안 비밀번호 만들기

참고: OAuth 2.0을 사용 설정하고 클라이언트 ID와 보안 비밀을 가져오려면 Atlassian 개발자 문서에서 OAuth 2.0(3LO) 앱을 참조하세요.

1. developer.atlassian.com에 로그인합니다.
2. 오른쪽 상단에서 프로필 아이콘을 클릭하고 개발자 콘솔을 선택합니다.
3. 만들기를 클릭하고 OAuth 2.0 통합을 선택합니다.
4. 앱 이름을 입력합니다.
   • 이용 약관 체크박스를 선택합니다.
   • 만들기를 클릭합니다.

5. 개요, 배포판, 권한, 승인, 설정의 5가지 옵션이 있습니다. 승인으로 시작합니다.

   a. 승인을 클릭합니다.

   b. 승인 유형 테이블에서 OAuth 2.0(3LO)에 대해 추가를 선택합니다.

6. 콜백 URL 필드에서 https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html을 입력한 후 변경사항 저장을 클릭합니다.

   참고: 경고: 앱에 API가 없습니다. 앱에 API를 추가하세요.가 표시된 경우 다음 섹션에서 이를 해결합니다.

7. 권한을 선택합니다.

   a. Jira API로 이동하고 추가를 클릭한 후 구성을 클릭합니다.

   참고: 추가를 클릭하면 버튼이 구성으로 변경됩니다.

   b. 기존 범위 탭으로 이동하고 범위 수정을 클릭합니다. 다음 범위를 선택합니다.

   범위 보기

   • read:jira-work
   • manage:jira-project
   • manage:jira-configuration
   • read:jira-user
   • write:jira-work
   • manage:jira-webhook
   • manage:jira-data-provider

   7개 범위가 선택되었는지 확인하고 변경사항을 저장합니다.

8. 배포판을 클릭하고 수정을 선택하고, 다음을 수행합니다.

   • 먼저 공유 라디오 버튼을 선택하여 다른 필드 수정을 사용 설정합니다.
   • 나머지 필드를 작성합니다.
   • 메시지가 표시되면 예를 선택합니다. Does your app store personal data?

9. 설정을 선택하여 클라이언트 ID 및 클라이언트 보안 비밀번호을 복사합니다.

인스턴스 URL 및 인스턴스 ID 검색

인스턴스 URL을 가져오려면 다음 안내를 따르세요.

1. atlassian.net으로 이동하고 관리자 계정으로 로그인합니다.
2. 동기화할 앱을 선택합니다. 예를 들어 첫 번째 앱을 동기화합니다.
3. 주소 표시줄에서 하위 도메인인 인스턴스 URL을 찾습니다. Assign appropriate permissions와 같이 표시됩니다.

인스턴스 ID를 가져오려면 다음 안내를 따르세요.

1. 새 탭을 열고, 인스턴스 URL을 복사하고, /_edge/tenant_info를 인스턴스 URL에 추가합니다. 예를 들면 https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info입니다.
2. 링크로 이동하여 cloudId 값을 찾습니다. cloudId는 인스턴스 ID입니다.

권한 및 역할 설정

1. 관리자 계정으로 atlassian.com에 로그인합니다.
2. 왼쪽 상단에서 메뉴 아이콘을 클릭하거나 admin.atlassian.com으로 이동합니다.

3. 관리 페이지에서 사용자 관리를 클릭하고 그룹 페이지로 이동합니다.

4. 그룹 만들기를 클릭합니다. 그룹 이름을 입력하고 만듭니다.

5. 새 그룹 페이지의 그룹 제품 액세스 섹션에서 그룹에 제품 추가를 클릭합니다.

6. Jira의 경우 사용자 액세스 관리자를 제품 역할로 선택합니다.

7. Jira 관리자의 경우 제품 관리자를 제품 역할로 선택하고 변경사항을 저장합니다.

8. 그룹 페이지에서 그룹 멤버 추가를 클릭하고 커넥터가 인증을 수행할 사용자 또는 계정을 추가합니다.

Jira Cloud 커넥터 만들기

콘솔

Google Cloud 콘솔을 사용하여 Jira Cloud의 데이터를 Vertex AI Search와 동기화하려면 다음 단계를 따르세요.

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

   Agent Builder를 사용하여 이 모든 것을 자체 데이터에 그라운딩하세요.

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

3. 데이터 스토어 만들기를 클릭합니다.

4. 데이터 소스 선택 페이지에서 서드 파티 소스 섹션으로 이동하여 Jira를 선택합니다.

5. 인증 정보를 입력하고 인증을 클릭합니다.

6. 새 창이 나타납니다. 인스턴스 사용자 이름과 비밀번호를 입력합니다. 데이터 스토어의 Jira 소스 지정 페이지로 돌아가기 전에 인증이 완료되었는지 확인합니다.

7. 동기화할 항목을 선택한 다음 계속을 클릭합니다.

8. 데이터 스토어의 리전을 선택합니다.

9. 데이터 스토어의 이름을 입력합니다.

10. 동기화 빈도를 선택합니다.

11. 만들기를 클릭합니다. Vertex AI Search가 데이터 스토어를 만들고 데이터 스토어 페이지에 데이터 스토어를 표시합니다.

12. 수집 상태를 확인하려면 데이터 스토어 페이지로 이동하여 데이터 스토어 이름을 클릭한 후 데이터 페이지에서 세부정보를 확인합니다. 데이터 동기화를 시작하면 커넥터 상태가 만들기에서 실행 중으로 변경됩니다. 수집이 완료되면 상태가 활성으로 변경되어 데이터 소스 연결이 설정되고 다음으로 예약된 동기화를 기다리고 있음을 나타냅니다.

    데이터 크기에 따라 수집에 몇 분 또는 몇 시간까지 걸릴 수 있습니다.

다음 단계

• 데이터 스토어를 앱에 연결하려면 앱을 만들고 검색 앱 만들기의 단계를 따라 데이터 스토어를 선택합니다.

• 서드 파티 액세스 제어가 있는 앱의 결과 미리보기를 참조하세요.

Salesforce 연결

다음 절차에 따라 Salesforce에서 Vertex AI Search로 데이터를 동기화합니다.

미리보기: 서드 파티 커넥터는 허용 목록과 함께 미리보기 버전으로 제공됩니다. 이 기능을 사용하려면 허용 목록에 있어야 합니다.

데이터 소스를 설정하고 데이터를 처음 가져온 후에는 데이터 스토어가 설정 중에 선택한 빈도로 해당 소스의 데이터를 동기화합니다.

연결을 설정하기 전에 다음을 확인하세요.

• 데이터 소스의 액세스 제어를 설정합니다. 액세스 제어 설정에 관한 자세한 내용은 데이터 소스 액세스 제어 사용을 참조하세요.

• 다음 인증 정보를 준비합니다. Salesforce에서 소비자 ID 및 보안 비밀을 설정하는 방법에 관한 자세한 내용은 Salesforce 문서의 OAuth 2.0 클라이언트 사용자 인증 정보 흐름을 위한 연결된 앱 구성을 참조하세요.

  • 인스턴스 URL
  • 소비자 ID
  • 고객 보안 비밀

다음과 같은 제한사항이 적용됩니다.

• 사용자를 항목으로 동기화하려면 사용자가 공유 동의를 제공해야 합니다.

콘솔

Google Cloud 콘솔을 사용하여 Salesforce의 데이터를 Vertex AI Search와 동기화하려면 다음 단계를 따르세요.

1. Salesforce CORS 허용 목록에 Google Cloud를 추가합니다. 이미 이 작업을 완료한 경우 다음 단계로 건너뜁니다.

   1. Salesforce 문서의 안내에 따라 CORS 허용 목록을 구성합니다.

   2. 출처 URL로 https://console.cloud.google.com/을 입력하고 구성을 저장합니다.

2. Google Cloud 콘솔에서 Agent Builder 페이지로 이동합니다.

   Agent Builder를 사용하여 이 모든 것을 자체 데이터에 그라운딩하세요.

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

4. 데이터 스토어 만들기를 클릭합니다.

5. 데이터 소스 선택 페이지에서 서드 파티 소스 섹션으로 이동하여 Salesforce를 선택합니다.

6. Salesforce 인증 정보를 입력합니다.

7. 동기화할 항목을 선택하고 계속을 클릭합니다.

8. 데이터 스토어의 리전을 선택합니다.

9. 데이터 스토어의 이름을 입력합니다.

10. 동기화 빈도를 선택합니다.

11. 만들기를 클릭합니다. Vertex AI Search가 데이터 스토어를 만들고 데이터 스토어 페이지에 데이터 스토어를 표시합니다.

12. 수집 상태를 확인하려면 데이터 스토어 페이지로 이동하여 데이터 스토어 이름을 클릭한 후 데이터 페이지에서 세부정보를 확인합니다. 데이터 동기화를 시작하면 커넥터 상태가 만들기에서 실행 중으로 변경됩니다. 수집이 완료되면 상태가 활성으로 변경되어 데이터 소스 연결이 설정되고 다음으로 예약된 동기화를 기다리고 있음을 나타냅니다.

    데이터 크기에 따라 수집에 몇 분 또는 몇 시간까지 걸릴 수 있습니다.

다음 단계

• 데이터 스토어를 앱에 연결하려면 앱을 만들고 검색 앱 만들기의 단계를 따라 데이터 스토어를 선택합니다.

• 서드 파티 액세스 제어가 있는 앱의 결과 미리보기를 참조하세요.

ServiceNow 연결

다음 절차에 따라 ServiceNow의 데이터를 Vertex AI Search와 동기화합니다.

미리보기: 서드 파티 커넥터는 허용 목록과 함께 미리보기 버전으로 제공됩니다. 이 기능을 사용하려면 허용 목록에 있어야 합니다.

데이터 소스를 설정하고 데이터를 처음 가져온 후에는 데이터 스토어가 설정 중에 선택한 빈도로 해당 소스의 데이터를 동기화합니다.

연결을 설정하기 전에 다음을 확인하세요.

• 데이터 소스의 액세스 제어를 설정합니다. 액세스 제어 설정에 관한 자세한 내용은 데이터 소스 액세스 제어 사용을 참조하세요.

• 다음 인증 정보를 준비하세요.

  • https://<domain-name>.service-now.com/ 형식의 인스턴스 URL입니다.
  • 클라이언트 ID 및 클라이언트 보안 비밀번호. 엔드포인트 설정 및 클라이언트 ID 및 클라이언트 보안 비밀번호 가져오기에 관한 자세한 내용은 ServiceNow 문서의 클라이언트가 인스턴스에 액세스할 수 있는 엔드포인트 만들기를 참조하세요.

  • 다음 ServiceNow 역할 유형 중 하나의 사용자 이름 및 비밀번호:

    • 관리자 역할 ServiceNow 문서의 기본 시스템 역할을 참조하세요.

    • 커스텀 ServiceNow 역할 관리자 역할을 사용하는 대신 사용할 수 있습니다. 커스텀 ServiceNow 역할을 사용하려면 다음 필드로 액세스 제어 규칙을 만드세요.

      필드 보기

      • 유형: record
      • 작업: read
      • 이름(각각에 대해 별도의 액세스 제어 규칙이 필요함):
      • incident
      • sc_cat_item
      • kb_knowledge
      • kb_knowledge_base
      • kb_uc_can_read_mtom
      • kb_uc_can_contribute_mtom
      • sys_user_role
      • sys_user_has_role
      • sys_user_group
      • sys_user_grmember
      • 역할 필요: 커스텀 역할의 이름

      자세한 내용은 ServiceNow 문서의 역할 만들기 및 ACL 규칙 만들기를 참조하세요.

콘솔

Google Cloud 콘솔을 사용하여 ServiceNow의 데이터를 Vertex AI Search와 동기화하려면 다음 단계를 따르세요.

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

   Agent Builder를 사용하여 이 모든 것을 자체 데이터에 그라운딩하세요.

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

3. 데이터 스토어 만들기를 클릭합니다.

4. 데이터 소스 선택 페이지에서 서드 파티 소스 섹션으로 이동하여 ServiceNow를 선택합니다.

5. ServiceNow 인증 정보를 입력합니다.

6. 동기화할 항목을 선택하고 계속을 클릭합니다.

7. 데이터 커넥터의 리전을 선택합니다.

8. 데이터 커넥터의 이름을 입력합니다.

9. 동기화 빈도를 선택합니다.

10. 만들기를 클릭합니다. Vertex AI Search가 데이터 스토어를 만들고 데이터 스토어 페이지에 데이터 스토어를 표시합니다.

11. 수집 상태를 확인하려면 데이터 스토어 페이지로 이동하여 데이터 커넥터 이름을 클릭한 후 데이터 페이지에서 세부정보를 확인합니다. 데이터 동기화를 시작하면 커넥터 상태가 만들기에서 실행 중으로 변경됩니다. 수집이 완료되면 상태가 활성으로 변경되어 데이터 소스 연결이 설정되고 다음으로 예약된 동기화를 기다리고 있음을 나타냅니다.

    데이터 크기에 따라 수집에 몇 분 또는 몇 시간까지 걸릴 수 있습니다.

다음 단계

• 데이터 스토어를 앱에 연결하려면 앱을 만들고 검색 앱 만들기의 단계를 따라 데이터 스토어를 선택합니다.

• 서드 파티 액세스 제어가 있는 앱의 결과 미리보기를 참조하세요.

SharePoint Online 연결

다음 절차에 따라 Sharepoint Online의 데이터를 Vertex AI Search로 동기화합니다.

미리보기: 서드 파티 커넥터는 허용 목록과 함께 미리보기 버전으로 제공됩니다. 이 기능을 사용하려면 허용 목록에 있어야 합니다.

데이터 소스를 설정하고 데이터를 처음 가져온 후에는 데이터 스토어가 설정 중에 선택한 빈도로 해당 소스의 데이터를 동기화합니다.

연결을 설정하기 전에 다음을 확인하세요.

• 데이터 소스의 액세스 제어를 설정합니다. 액세스 제어 설정에 관한 자세한 내용은 데이터 소스 액세스 제어 사용을 참조하세요.

• Sharepoint 계정에서 2단계 인증(2FA)을 사용 중지해야 합니다. 기본 Oauth2 비밀번호 인증만 지원됩니다.

• 관리자 동의를 부여합니다. 동의를 부여하는 방법에 관한 자세한 내용은 Microsoft 문서의 애플리케이션에 테넌트 전체 관리자 동의 부여를 참조하세요.

• 설정 중에 사용할 다음 Sharepoint Online 인증 정보를 준비합니다.

  • 인스턴스 URL. 형식은 다음과 같습니다. http://DOMAIN_OR_SERVER/[sites/]WEBSITE URL에 관한 자세한 내용은 SharePoint 문서의 SharePoint의 URL 및 토큰을 참조하세요.
  • 테넌트 ID, 클라이언트 ID, 클라이언트 보안 비밀번호. 애플리케이션을 등록하려면 로그인 잠재고객에 이 조직 디렉터리의 계정만을 선택한 다음 이 인증 정보를 찾습니다. 자세한 내용은 Microsoft 문서의 빠른 시작: Microsoft ID 플랫폼에 애플리케이션 등록을 참조하세요.
  • 사용자 이름 및 비밀번호. 이는 Sharepoint 사이트 관리자 또는 2단계 인증이 사용 중지된 Sharepoint 사이트 컬렉션 관리자에 해당해야 합니다.

• 다음 표에서는 구성에 권장되는 역할과 제한사항을 설명합니다.

  역할 보기

  역할	클라이언트 애플리케이션 등록	모든 항목의 콘텐츠를 가져올 수 있음	ACL을 가져올 수 있음	ID를 가져올 수 있음	참고
  사이트 관리자	아니요	예	예	예
  사이트 컬렉션 관리자	아니요	예	예	예
  글로벌 관리자	예	아니요	예	아니요	제한사항: ID 또는 댓글 및 첨부파일 항목을 가져올 수 없음
  사이트 소유자	아니요	예	예	아니요	제한사항: ID를 가져올 수 없음
  애플리케이션 관리자	예	해당 사항 없음	해당 사항 없음	해당 사항 없음	애플리케이션 관리자 역할은 Microsoft 365 관리 센터/Entra 관리 센터와 관련이 있습니다. Sharepoint에만 국한되지 않습니다.

콘솔

Google Cloud 콘솔을 사용하여 Sharepoint Online의 데이터를 Vertex AI Search와 동기화하려면 다음 단계를 따르세요.

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

   Agent Builder를 사용하여 이 모든 것을 자체 데이터에 그라운딩하세요.

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

3. 데이터 스토어 만들기를 클릭합니다.

4. 데이터 소스 선택 페이지에서 서드 파티 소스 섹션으로 이동하여 Sharepoint Online을 선택합니다.

5. Sharepoint Online 인증 정보를 입력합니다.

6. 동기화할 항목을 선택하고 계속을 클릭합니다.

7. 데이터 스토어의 리전을 선택합니다.

8. 데이터 스토어의 이름을 입력합니다.

9. 데이터 스토어의 동기화 빈도를 선택합니다.

10. 만들기를 클릭합니다. Vertex AI Search가 데이터 스토어를 만들고 데이터 스토어 페이지에 데이터 스토어를 표시합니다.

11. 수집 상태를 확인하려면 데이터 스토어 페이지로 이동하여 데이터 스토어 이름을 클릭한 후 데이터 페이지에서 세부정보를 확인합니다. 데이터 동기화를 시작하면 커넥터 상태가 만들기에서 실행 중으로 변경됩니다. 수집이 완료되면 상태가 활성으로 변경되어 데이터 소스 연결이 설정되고 다음으로 예약된 동기화를 기다리고 있음을 나타냅니다.

    데이터 크기에 따라 수집에 몇 분 또는 몇 시간까지 걸릴 수 있습니다.

다음 단계

• 데이터 스토어를 앱에 연결하려면 앱을 만들고 검색 앱 만들기의 단계를 따라 데이터 스토어를 선택합니다.

• 서드 파티 액세스 제어가 있는 앱의 결과 미리보기를 참조하세요.

Slack 연결

다음 절차에 따라 Slack에서 Vertex AI Search로 데이터를 동기화합니다.

미리보기: 서드 파티 커넥터는 허용 목록과 함께 미리보기 버전으로 제공됩니다. 이 기능을 사용하려면 허용 목록에 있어야 합니다.

데이터 소스를 설정하고 데이터를 처음 가져온 후에는 데이터 스토어가 설정 중에 선택한 빈도로 해당 소스의 데이터를 동기화합니다.

연결을 설정하기 전에 다음을 확인하세요.

• 데이터 소스의 액세스 제어를 설정합니다. 액세스 제어 설정에 관한 자세한 내용은 데이터 소스 액세스 제어 사용을 참조하세요.

• 다음 Slack 인증 정보를 준비합니다.

  • 작업공간 ID. 워크스페이스 ID를 가져오는 방법에 관한 자세한 내용은 Slack 문서의 데이터 스토어의 Slack 소스 지정을 참조하세요.
  • 액세스 토큰. 클라이언트 앱을 만들고 범위를 정의하는 방법에 관한 자세한 내용은 Slack 문서의 빠른 시작 및 Slack API 토큰을 빠르게 가져와 사용하는 방법을 참조하세요.
  • OAuth 2.0 권한 범위를 설정할 때 다음 범위를 구성합니다.

    범위 보기

    • users:read.email
    • channels:history
    • channels:read
    • groups:history
    • groups:read
    • im:history
    • im:read
    • mpim:history
    • mpim:read
    • team:read
    • users.profile:read
    • users:read
    • files:read
    • usergroups:read

다음과 같은 제한사항이 적용됩니다.

• Slack의 기본 동작은 비공개 채널, 그룹 채팅 메시지, 1:1 채팅 메시지의 콘텐츠 크롤링 및 동기화를 제한합니다.

콘솔

Google Cloud 콘솔을 사용하여 Slack의 데이터를 Vertex AI Search와 동기화하려면 다음 단계를 따르세요.

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

   Agent Builder를 사용하여 이 모든 것을 자체 데이터에 그라운딩하세요.

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

3. 데이터 스토어 만들기를 클릭합니다.

4. 데이터 소스 선택 페이지에서 서드 파티 소스 섹션으로 이동하여 Slack을 선택합니다.

5. Slack 인증 정보를 입력합니다.

6. 동기화할 항목을 선택하고 계속을 클릭합니다.

7. 데이터 스토어의 리전을 선택합니다.

8. 데이터 스토어의 이름을 입력합니다.

9. 데이터 스토어의 동기화 빈도를 선택합니다.

10. 만들기를 클릭합니다. Vertex AI Search가 데이터 스토어를 만들고 데이터 스토어 페이지에 데이터 스토어를 표시합니다.

11. 수집 상태를 확인하려면 데이터 스토어 페이지로 이동하여 데이터 스토어 이름을 클릭한 후 데이터 페이지에서 세부정보를 확인합니다. 데이터 동기화를 시작하면 커넥터 상태가 만들기에서 실행 중으로 변경됩니다. 수집이 완료되면 상태가 활성으로 변경되어 데이터 소스 연결이 설정되고 다음으로 예약된 동기화를 기다리고 있음을 나타냅니다.

    데이터 크기에 따라 수집에 몇 분 또는 몇 시간까지 걸릴 수 있습니다.

다음 단계

• 데이터 스토어를 앱에 연결하려면 앱을 만들고 검색 앱 만들기의 단계를 따라 데이터 스토어를 선택합니다.

• 서드 파티 액세스 제어가 있는 앱의 결과 미리보기를 참조하세요.

Dropbox 연결

다음 절차에 따라 Dropbox의 데이터를 Vertex AI Search와 동기화합니다.

미리보기: 서드 파티 커넥터는 허용 목록과 함께 미리보기 버전으로 제공됩니다. 이 기능을 사용하려면 허용 목록에 있어야 합니다.

데이터 소스를 설정하고 데이터를 처음 가져온 후에는 데이터 스토어가 설정 중에 선택한 빈도로 해당 소스의 데이터를 동기화합니다.

시작하기 전에

연결을 설정하기 전에 다음을 확인하세요.

• 데이터 소스의 액세스 제어를 설정합니다. 자세한 내용은 데이터 소스 액세스 제어 사용을 참조하세요.

• 다음 Dropbox 인증 정보를 준비합니다. 이러한 매개변수 설정에 관한 자세한 내용은 Dropbox 문서의 OAuth 가이드를 참조하세요.

  • 클라이언트 ID
  • 클라이언트 보안 비밀번호

콘솔

Google Cloud 콘솔을 사용하여 Dropbox의 데이터를 Vertex AI Search와 동기화하려면 다음 단계를 따르세요.

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

   Agent Builder를 사용하여 이 모든 것을 자체 데이터에 그라운딩하세요.

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

3. 데이터 스토어 만들기를 클릭합니다.

4. 데이터 소스 선택 페이지에서 서드 파티 소스 섹션으로 이동하여 Dropbox를 선택합니다.

5. Dropbox 인증 정보를 입력하고 인증을 클릭합니다. 새 창이 나타납니다.

6. 계정을 인증하고 인증에 성공했는지 확인한 후 데이터 스토어의 Dropbox 소스 지정 페이지로 돌아갑니다.

7. 동기화할 항목을 선택하고 계속을 클릭합니다.

8. 데이터 스토어의 위치를 선택합니다.

9. 데이터 스토어의 이름을 입력합니다.

10. 데이터 스토어의 동기화 빈도를 선택합니다.

11. 만들기를 클릭합니다. Vertex AI Search가 데이터 스토어를 만들고 데이터 스토어 페이지에 데이터 스토어를 표시합니다.

12. 수집 상태를 확인하려면 데이터 스토어 페이지로 이동하여 데이터 스토어 이름을 클릭한 후 데이터 페이지에서 세부정보를 확인합니다. 데이터 동기화를 시작하면 커넥터 상태가 만들기에서 실행 중으로 변경됩니다. 수집이 완료되면 상태가 활성으로 변경되어 데이터 소스 연결이 설정되고 다음으로 예약된 동기화를 기다리고 있음을 나타냅니다. 문서 탭을 확인하여 항목이 올바르게 수집되었는지 확인합니다.

    데이터 크기에 따라 수집에 몇 분 또는 몇 시간까지 걸릴 수 있습니다.

다음 단계

• 데이터 스토어를 앱에 연결하려면 앱을 만들고 검색 앱 만들기의 단계를 따라 데이터 스토어를 선택합니다.

• 앱과 데이터 스토어를 설정한 후 검색 결과가 표시되는 방식을 미리 보려면 검색 결과 가져오기를 참고하세요. 서드 파티 액세스 제어를 사용한 경우 서드 파티 액세스 제어가 있는 앱의 결과 미리보기를 참조하세요.

Box 연결

다음 절차에 따라 Box에서 Vertex AI Search로 데이터를 동기화합니다.

미리보기: 서드 파티 커넥터는 허용 목록과 함께 미리보기 버전으로 제공됩니다. 이 기능을 사용하려면 허용 목록에 있어야 합니다.

데이터 소스를 설정하고 데이터를 처음 가져온 후에는 데이터 스토어가 설정 중에 선택한 빈도로 해당 소스의 데이터를 동기화합니다.

시작하기 전에

연결을 설정하기 전에 다음을 확인하세요.

• 데이터 소스의 액세스 제어를 설정합니다. 액세스 제어 설정에 관한 자세한 내용은 데이터 소스 액세스 제어 사용을 참조하세요.

• 다음 Box 인증 정보를 준비합니다. 이러한 매개변수 설정에 관한 자세한 내용은 Box 개발자 문서의 JWT Auth를 참조하세요.

  • Enterprise ID
  • 클라이언트 ID
  • 클라이언트 보안 비밀번호
  • 공개 키 ID
  • 비공개 키
  • 암호

• JWT 엔드포인트를 만들 때 다음 범위를 구성합니다.

  범위 보기

  • root_readonly
  • root_readwrite
  • manage_managed_users
  • manage_app_users
  • manage_groups
  • manage_enterprise_properties
  • as_user
  • generate_access_token

다음과 같은 제한사항이 적용됩니다.

• 댓글의 증분 변경사항을 동기화하는 데 구성된 빈도 간격보다 오래 걸릴 수 있습니다.
• 항목이 포함된 폴더를 복사하거나 이동하면 증분 변경사항을 동기화하는 데 구성된 빈도 간격보다 오래 걸릴 수 있습니다.

콘솔

Google Cloud 콘솔을 사용하여 Box의 데이터를 Vertex AI Search와 동기화하려면 다음 단계를 따르세요.

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

   Agent Builder를 사용하여 이 모든 것을 자체 데이터에 그라운딩하세요.

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

3. 데이터 스토어 만들기를 클릭합니다.

4. 데이터 소스 선택 페이지에서 서드 파티 소스 섹션으로 이동하여 Box를 선택합니다.

5. 인증 정보를 입력합니다.

6. 동기화할 항목을 선택하고 계속을 클릭합니다.

7. 데이터 스토어의 리전을 선택합니다.

8. 데이터 스토어의 이름을 입력합니다.

9. 데이터 스토어의 동기화 빈도를 선택합니다.

10. 만들기를 클릭합니다. Vertex AI Search가 데이터 스토어를 만들고 데이터 스토어 페이지에 데이터 스토어를 표시합니다.

11. 수집 상태를 확인하려면 데이터 스토어 페이지로 이동하여 데이터 스토어 이름을 클릭한 후 데이터 페이지에서 세부정보를 확인합니다. 데이터 동기화를 시작하면 커넥터 상태가 만들기에서 실행 중으로 변경됩니다. 수집이 완료되면 상태가 활성으로 변경되어 데이터 소스 연결이 설정되고 다음으로 예약된 동기화를 기다리고 있음을 나타냅니다.

    데이터 크기에 따라 수집에 몇 분 또는 몇 시간까지 걸릴 수 있습니다.

다음 단계

• 데이터 스토어를 앱에 연결하려면 앱을 만들고 검색 앱 만들기의 단계를 따라 데이터 스토어를 선택합니다.

• 앱과 데이터 스토어를 설정한 후 검색 결과가 표시되는 방식을 미리 보려면 검색 결과 가져오기를 참고하세요. 서드 파티 액세스 제어를 사용한 경우 서드 파티 액세스 제어가 있는 앱의 결과 미리보기를 참조하세요.

OneDrive 연결

다음 절차에 따라 OneDrive의 데이터를 Vertex AI Search로 동기화합니다.

미리보기: 서드 파티 커넥터는 허용 목록과 함께 미리보기 버전으로 제공됩니다. 이 기능을 사용하려면 허용 목록에 있어야 합니다.

데이터 소스를 설정하고 데이터를 처음 가져온 후에는 데이터 스토어가 설정 중에 선택한 빈도로 해당 소스의 데이터를 동기화합니다.

시작하기 전에

연결을 설정하기 전에 다음을 확인하세요.

• 데이터 소스의 액세스 제어를 설정합니다. 액세스 제어 설정에 관한 자세한 내용은 데이터 소스 액세스 제어 사용을 참조하세요.

• 다음 OneDrive 인증 정보를 준비합니다.

  • 클라이언트 ID, 클라이언트 보안 비밀번호, 테넌트 ID. 이러한 매개변수 설정에 관한 자세한 내용은 Microsoft 문서의 빠른 시작: Microsoft ID 플랫폼에 애플리케이션 등록을 참조하세요.

  • 액세스 범위를 지정합니다. 관리자 역할이 필요합니다. 자세한 내용은 Microsoft 문서의 빠른 시작: 웹 API에 액세스하도록 클라이언트 애플리케이션 구성을 참조하세요.

    다음 범위를 구성합니다.

    범위 보기

    • Files.Read.All Application
    • Group.Read.All Application
    • Sites.FullControl.All Application
    • User.Read Delegated
    • User.Read.All Application

콘솔

Google Cloud 콘솔을 사용하여 OneDrive의 데이터를 Vertex AI Search와 동기화하려면 다음 단계를 따르세요.

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

   Agent Builder를 사용하여 이 모든 것을 자체 데이터에 그라운딩하세요.

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

3. 데이터 스토어 만들기를 클릭합니다.

4. 데이터 소스 선택 페이지에서 서드 파티 소스 섹션으로 이동하여 OneDrive를 선택합니다.

5. OneDrive 인증 정보를 입력합니다.

6. 동기화할 항목을 선택하고 계속을 클릭합니다.

7. 데이터 스토어의 리전을 선택합니다.

8. 데이터 스토어의 이름을 입력합니다.

9. 데이터 스토어의 동기화 빈도를 선택합니다.

10. 만들기를 클릭합니다. Vertex AI Search가 데이터 스토어를 만들고 데이터 스토어 페이지에 데이터 스토어를 표시합니다.

11. 수집 상태를 확인하려면 데이터 스토어 페이지로 이동하여 데이터 스토어 이름을 클릭한 후 데이터 페이지에서 세부정보를 확인합니다. 데이터 동기화를 시작하면 커넥터 상태가 만들기에서 실행 중으로 변경됩니다. 수집이 완료되면 상태가 활성으로 변경되어 데이터 소스 연결이 설정되고 다음으로 예약된 동기화를 기다리고 있음을 나타냅니다.

    데이터 크기에 따라 수집에 몇 분 또는 몇 시간까지 걸릴 수 있습니다.

다음 단계

• 데이터 스토어를 앱에 연결하려면 앱을 만들고 검색 앱 만들기의 단계를 따라 데이터 스토어를 선택합니다.

• 앱과 데이터 스토어를 설정한 후 검색 결과가 표시되는 방식을 미리 보려면 검색 결과 가져오기를 참고하세요. 서드 파티 액세스 제어를 사용한 경우 서드 파티 액세스 제어가 있는 앱의 결과 미리보기를 참조하세요.