서드 파티 데이터 소스 연결

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

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

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

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

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

시작하기 전에

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

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

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 권한 범위를 설정할 때 다음 범위를 구성합니다.

  • 사용자 권한이 올바르게 적용되려면 각 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와 클라이언트 보안 비밀번호 만들기

  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. 기존 범위 탭으로 이동하고 범위 수정을 클릭합니다. 다음 범위를 선택합니다.

    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: Salesforce 인스턴스의 도메인 이름입니다. 내 도메인을 검색하고 my.salesforce.com로 끝나는 도메인을 복사한 다음 앞에 https://를 추가합니다.
    • 클라이언트 ID: 고객 세부정보 관리를 클릭하여 연결된 앱에서 클라이언트 ID를 복사합니다. 갱신 토큰이 사용 설정된 경우 토큰이 새로고침되었는지 확인하고 데이터 스토어를 만들 때 최신 토큰을 제공합니다.
    • 클라이언트 보안 비밀: 고객 세부정보 관리를 클릭하여 연결된 앱에서 클라이언트 보안 비밀을 복사합니다. 갱신 토큰이 사용 설정된 경우 토큰이 새로고침되었는지 확인하고 데이터 스토어를 만들 때 최신 토큰을 제공합니다.

  • 사용자 권한을 올바르게 적용하려면 Salesforce 사용자가 공유 콘텐츠를 제공해야 합니다.

  • Enterprise 또는 개발자 요금제를 사용합니다. 무료 체험 계정은 지원되지 않습니다.

  • Sales Cloud를 사용하고 있는지 확인합니다. Service Cloud는 지원되지 않습니다.

  • Salesforce CORS 허용 목록에 Google Cloud를 추가합니다. 이 작업을 이미 완료했다면 앱 만들기 섹션으로 이동하세요.

    • Salesforce 문서의 안내에 따라 CORS 허용 목록을 구성합니다.
    • 출처 URL로 https://console.cloud.google.com/을 입력하고 구성을 저장합니다.

앱 만들기

Salesforce에서 지원하는 앱은 다음과 같습니다.

  1. 연결된 앱
  2. 외부 클라이언트 앱

연결된 앱 만들기

Google Cloud와 통합하기 위해 Salesforce에서 연결된 앱을 설정하려면 다음 단계를 따르세요.

  1. Salesforce에 로그인합니다.
  2. 톱니바퀴 아이콘을 클릭하고 설정으로 이동합니다.
  3. 설정 메뉴에서 App Manager로 이동합니다.
  4. 새로 연결된 앱을 클릭합니다.

  5. 연결된 앱을 구성하려면 다음 단계를 따르세요.

    a. 연결된 앱 만들기 페이지에서 다음을 수행합니다.

    • OAuth 설정 사용을 선택합니다.
    • 콜백 URL을 https://vertexaisearch.cloud.google.com/console/oauth/salesforce_oauth.html로 설정합니다.
    • 다음 OAuth 범위를 선택합니다.
      • 전체 액세스 (full)
      • 언제든지 요청 실행 (refresh_token, offline_access)

    b. 흐름을 사용 설정합니다.

    • 클라이언트 사용자 인증 정보 흐름
    • 승인 코드 및 사용자 인증 정보 흐름
    • 승인 코드 및 사용자 인증 정보 흐름을 위한 POST 본문의 사용자 인증 정보
    • 클라이언트 사용자 인증 정보 흐름의 경우 Run as(실행) 필드에 사용자 이름을 할당합니다. 커넥터가 추출할 수 있는 모든 항목에 대한 읽기 권한이 있어야 합니다.

연결된 앱을 만든 후 다음을 실행합니다.

  1. 앱 정책 수정:

    • 앱 관리자로 이동하여 새로 만든 앱을 수정합니다.
    • IP 완화를 Relax IP restrictions로 설정합니다.
    • 필요에 따라 리프레시 토큰 정책을 Valid until revoked 또는 더 제한적인 설정으로 구성합니다.
    • 허용된 사용자가 All users may self-authorize로 설정되어 있는지 확인합니다.

  2. IP 제한사항을 구성합니다.

    • 조직 수준 IP 범위 적용이 사용 설정된 경우 보안 > 네트워크 액세스에서 신뢰할 수 있는 IP 범위를 설정합니다. 자세한 내용은 연결된 앱 IP 완화 및 지속적인 IP 시행 문서를 참고하세요.
    • IP 제한이 필요하지 않은 경우 모든 요청에 로그인 IP 범위 적용을 사용 중지합니다.

  3. OAuth 연결 앱을 구성합니다.

  4. 연결된 앱을 저장합니다.

    • 연결된 앱을 저장하고 종료합니다.
    • 검색창에서 OAuth 및 OpenId Connect 설정을 검색합니다.
    • 승인 코드 및 사용자 인증 정보 흐름 허용 및 OAuth 사용자 이름-비밀번호 흐름을 사용 설정합니다.

외부 클라이언트 앱 만들기

통합에 OAuth 기반 인증을 사용 설정하도록 Salesforce에서 외부 클라이언트 앱을 만들고 구성하려면 다음 단계를 따르세요.

  1. 클라이언트 ID와 클라이언트 보안 비밀번호를 가져옵니다.

    • Salesforce에 로그인합니다.
    • 톱니바퀴 아이콘을 클릭하고 설정으로 이동합니다.
    • 설정 > 앱 > 외부 클라이언트 앱으로 이동합니다.
    • New external client app(새 외부 클라이언트 앱)을 클릭합니다.

  2. 다음과 같은 필수 정보를 제공합니다.

    • 앱 이름과 이메일 주소를 입력합니다. API 이름은 기본적으로 자동으로 채워집니다.
    • 배포 상태는 Local로 둡니다.

  3. OAuth 설정을 사용 설정합니다.

    • API (OAuth 설정 사용 설정)을 펼치고 OAuth 사용 설정을 선택합니다.
    • 구성:
      • 콜백 URL: https://login.salesforce.com/services/oauth2/callback
      • OAuth 범위: API를 통해 사용자 데이터를 관리합니다 (api).
      • 흐름 사용 설정에서 클라이언트 사용자 인증 정보 흐름 사용 설정을 선택합니다.
      • 만들기를 클릭하여 외부 클라이언트 앱을 만듭니다. 외부 클라이언트 앱 관리자로 이동하여 목록에 추가한 앱을 확인합니다.

  4. 앱 정책 수정:

    • 만든 앱을 엽니다.
    • 정책으로 이동하여 수정을 클릭합니다.
    • OAuth 흐름 및 외부 클라이언트 앱 개선사항에서 클라이언트 사용자 인증 정보 흐름 사용 설정을 선택합니다.
    • Run as(실행 권한) 필드에 Salesforce 사용자 이름을 입력합니다.

  5. OAuth 사용자 인증 정보에 액세스합니다.

    • 설정을 클릭합니다.
    • OAuth 설정을 클릭합니다.
    • 고객 키 및 보안 비밀을 클릭하여 사용자 인증 정보에 액세스합니다. 인증 코드가 이메일 주소로 전송됩니다.
    • 인증 코드를 입력하고 인증을 클릭합니다.
    • 소비자 키를 복사하여 클라이언트 ID로 사용합니다.
    • 고객 보안 비밀을 복사하여 클라이언트 보안 비밀로 사용합니다.

Salesforce 커넥터 만들기

콘솔

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

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

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

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

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

  4. 데이터 소스 선택 페이지에서 스크롤하거나 Salesforce를 검색하여 서드 파티 소스를 연결합니다.

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

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

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

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

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

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

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

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

다음 단계

ServiceNow 연결

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

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

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

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

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

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

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

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

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

        자세한 내용은 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와 동기화합니다.

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

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

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

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

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

    • 인스턴스 URL. 형식은 다음과 같습니다. http://DOMAIN_OR_SERVER/[sites/]WEBSITE URL에 관한 자세한 내용은 SharePoint 문서의 SharePoint의 URL 및 토큰을 참조하세요.

    • 테넌트 ID, 클라이언트 ID, 클라이언트 보안 비밀번호. 애플리케이션을 등록하려면 로그인 잠재고객에 이 조직 디렉터리의 계정만을 선택한 다음 이 인증 정보를 찾습니다. 자세한 내용은 Microsoft 문서의 빠른 시작: Microsoft ID 플랫폼에 애플리케이션 등록을 참조하세요.

    • 애플리케이션을 등록할 때 https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html을 웹 콜백 URL로 사용합니다.

    • 애플리케이션 권한을 구성할 때 Graph API에 다음 애플리케이션 권한을 추가합니다.

    • 애플리케이션 권한을 구성할 때 Sharepoint REST API에 다음과 같은 위임된 권한을 추가합니다.

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

콘솔

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

다음 단계

Slack 연결

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

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

시작하기 전에

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

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

  • Workspace 소유자에게 문의하여 워크스페이스에 새 앱을 설치할 권한을 요청합니다.

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

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

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

Slack 앱 구성

Vertex AI Search가 Slack 워크스페이스에서 문서를 처리할 수 있도록 액세스 토큰을 가져옵니다.

봇 토큰 생성

비공개 채널, 인스턴트 메시지 (IM), 다자간 인스턴트 메시지 (MPIM)에 안전하게 액세스할 수 있는 봇 토큰을 생성합니다. 봇 토큰은 자신이 속하지 않은 공개 채널을 크롤링할 수 없으며 공개 채널에 가입하면 가입 메시지가 생성됩니다.

  1. Slack API 앱에 로그인합니다.
  2. 새 앱 만들기를 클릭합니다.
  3. 처음부터를 선택합니다.
  4. 앱 이름을 입력하고 통합할 워크스페이스를 선택합니다.
  5. 앱 만들기를 클릭합니다.
  6. OAuth 및 권한을 클릭합니다.

  7. Bot token scopes(봇 토큰 범위)에서 다음 필수 범위를 추가합니다.

    기본적으로 봇은 #general 및 #random 채널에서 읽습니다. 크롤링을 사용 설정하려면 다음 단계를 따르세요.

    • 공개 채널의 경우 channels:join 범위를 부여하여 봇이 자동으로 참여하도록 허용합니다.
    • 비공개 채널의 경우 봇을 수동으로 초대합니다.

  8. 사용자 이름 워크스페이스에 설치를 클릭합니다.

  9. 화면에 표시된 안내에 따라 앱을 설치하고 봇 토큰을 가져옵니다.

사용자 토큰 생성

사용자 토큰을 생성하여 먼저 채널에 가입하지 않고도 모든 공개 채널에 액세스할 수 있습니다. 사용자에게 액세스 권한이 없는 경우 사용자 토큰은 비공개 채널, IM 또는 MPIM을 크롤링할 수 없습니다.

  1. Slack API 앱에 로그인합니다.
  2. 새 앱 만들기를 클릭합니다.
  3. 처음부터를 선택합니다.
  4. 앱 이름을 입력하고 통합할 워크스페이스를 선택합니다.
  5. 앱 만들기를 클릭합니다.
  6. OAuth 및 권한을 클릭합니다.

  7. 사용자 토큰 범위에서 다음과 같은 필수 범위를 추가합니다.

  8. 사용자 이름 워크스페이스에 설치를 클릭합니다.

  9. 화면에 표시된 안내에 따라 앱을 설치하고 사용자 토큰을 가져옵니다.

Slack Cloud 커넥터 만들기

콘솔

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

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

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

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

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

  4. 데이터 소스 선택 페이지에서 스크롤하거나 Slack을 검색하여 서드 파티 소스를 연결합니다.

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

    • 인스턴스 ID (작업공간 ID): 브라우저를 통해 로그인하여 Slack 워크스페이스에서 가져옵니다. 워크스페이스 ID는 URL에서 /client 다음에 오는 세그먼트입니다.
    • 인증 토큰: 이전 섹션에서 가져온 토큰을 사용합니다.

  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 엔드포인트를 만들 때 다음 범위를 구성합니다.

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

Box 앱 만들기

  1. 관리자 계정으로 Box 개발자 콘솔에 로그인합니다.
  2. 새 앱 만들기를 클릭합니다.
  3. 맞춤 앱 유형을 선택합니다.
  4. 앱 이름을 입력합니다.
  5. 앱의 목적(통합, AI, Google Cloud Agent Builder)을 설정합니다.
  6. JWT를 사용한 서버 인증을 선택합니다.

Box 앱 구성

Box 앱의 설정을 구성합니다.

공개 키/비공개 키 만들기

  1. Box Developer Console로 이동합니다.

  2. 구성 탭에서 공개/비공개 키 쌍 생성을 클릭합니다.

    • 공개 키는 ID와 함께 콘솔에 자동으로 업로드됩니다. 이 ID는 연결을 만들 때 사용됩니다.
    • 비공개 키와 암호가 포함된 구성 파일을 로컬에서 다운로드할 수 있습니다. 나중에 사용할 수 있도록 이 구성 파일을 보관해야 합니다.
    • 원하는 경우 자체 키를 생성하려면 Box 키 쌍 설정 가이드를 참고하세요.

필수 권한 구성

  1. 애플리케이션 범위 섹션에서 다음 권한을 선택합니다.
    • Box에 저장된 모든 파일 및 폴더 읽기

앱 승인

  1. 승인 탭에서 검토 및 제출을 클릭하고 관리자의 승인을 기다립니다.
  2. 관리자는 관리 콘솔에서 앱을 승인할 수 있습니다.

승인 후 Box에서 앱을 완전히 설정합니다.

Box 커넥터 만들기

콘솔

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로 동기화합니다.

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

시작하기 전에

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

콘솔

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

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

다음 단계