서드 파티 데이터 소스 연결

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

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

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

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

고객 관리 암호화 키를 사용하는 경우 Google Agentspace 문서의 서드 파티 커넥터의 단일 리전 키 정보를 참고하세요.

시작하기 전에

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

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

Adobe Experience Manager 연결

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

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

시작하기 전에

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

  1. 이 커넥터는 서드 파티 커넥터 허용 목록 외에도 프로젝트를 추가 허용 목록에 추가해야 합니다. 이 허용 목록에 추가하려면 Vertex AI Search 계정팀에 문의하세요.

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

  3. Adobe Experience Manager 관리자는 Vertex AI Search와 통합하기 위해 다음을 생성하거나 가져와야 합니다.

    • Adobe Experience Manager 인스턴스의 서비스 사용자 인증 정보
    • Adobe Experience Manager 사이트의 인스턴스 URL입니다.

Adobe Experience Manager 커넥터 만들기

콘솔

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

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

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

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

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

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

  5. Adobe Experience Manager 인증 정보를 입력하고 계속을 클릭합니다.

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

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

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

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

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

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

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

다음 단계

AODocs 연결

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

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

시작하기 전에

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

  1. 이 커넥터는 서드 파티 커넥터 허용 목록 외에도 프로젝트를 추가 허용 목록에 추가해야 합니다. 이 허용 목록에 추가하려면 Vertex AI Search 계정팀에 문의하세요.

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

  3. AODocs 관리자는 Vertex AI Search와 통합하기 위해 다음을 생성하거나 가져와야 합니다.

    • 인스턴스 ID (AODocs 인스턴스의 도메인 URL)
    • 클라이언트 ID
    • 클라이언트 보안 비밀번호

AODocs 커넥터 만들기

콘솔

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

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

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

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

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

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

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

  6. 계정을 인증하고 인증이 완료되었는지 확인한 후 데이터 스토어의 AODocs 소스 지정 페이지로 돌아갑니다.

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

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

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

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

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

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

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

다음 단계

Asana 연결

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

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

시작하기 전에

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

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

  • Asana 관리자가 다음과 같이 개인 액세스 토큰 (PAT)을 생성하거나 가져와야 인증할 수 있습니다. 자세한 내용은 Asana 문서의 개인 액세스 토큰을 참고하세요.

Asana 워크스페이스에 구성원을 초대하려면 다음 단계를 따르세요.

  1. 관리자 계정으로 Asana 애플리케이션에 로그인합니다.

  2. 관련 프로젝트를 선택합니다.

  3. 방문자 공유 대화상자의 이메일로 초대에서 다음을 수행합니다.

    1. 초대를 클릭합니다.
    2. 사용자의 이메일 주소를 입력합니다.
    3. 권한 수준을 뷰어로 선택합니다.

PAT를 생성하려면 다음 단계를 따르세요.

  1. Asana Developer Console을 엽니다.

  2. 내 앱을 클릭합니다.

  3. 토큰 만들기를 클릭합니다.

  4. 새 토큰 만들기 대화상자에서 필수 정보를 입력합니다.

  5. 토큰 만들기를 클릭합니다.

  6. 나중에 사용할 수 있도록 토큰을 복사합니다.

  7. 완료를 클릭합니다.

Asana Cloud 커넥터 만들기

콘솔

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

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

    Agent Builder

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

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

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

  5. 생성된 PAT를 포함한 인증 세부정보를 입력합니다.

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

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

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

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

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

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

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

다음 단계

Box 연결

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

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

시작하기 전에

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

  1. 2FA가 사용 설정된 Box 인스턴스에 대한 관리자 액세스 권한이 있어야 합니다. 모든 설정 안내는 관리자 계정에서만 실행할 수 있습니다.

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

  3. 스크린샷이 포함된 설정 개요는 Box 문서의 JWT 사용 설정을 참고하세요.

Box 앱 만들기

  1. 관리자 계정으로 Box 개발자 콘솔에 로그인합니다.
  2. 플랫폼 앱 만들기를 클릭합니다.
  3. 앱 유형으로 맞춤 앱을 선택합니다.
  4. 앱 이름을 입력합니다.
  5. 다음 속성을 설정합니다.
    1. 목적: 통합
    2. 카테고리: AI
    3. 외부 시스템: Google Cloud Agent Builder
  6. Authentication method(인증 방법)를 Server authentication (with JWT)(JWT로 서버 인증)으로 선택합니다.
  7. 앱 만들기를 클릭합니다.

Box 앱 구성

  1. Box 개발자 콘솔에서 플랫폼 앱을 선택한 다음 구성 탭으로 이동합니다.
  2. 앱 액세스 수준 섹션에서 앱 + 엔터프라이즈 액세스를 선택합니다.

  3. 애플리케이션 범위 섹션에서 다음 범위를 선택합니다.

    1. Box에 저장된 모든 파일 및 폴더 읽기
    2. Box에 저장된 모든 파일 및 폴더 쓰기
    3. 사용자 관리
    4. 그룹 관리하기
    5. 엔터프라이즈 속성 관리

  4. 고급 기능 섹션에서 as-user 헤더를 사용하여 API 호출을 선택합니다.

  5. 공개 키 추가 및 관리 섹션에서 공개/비공개 키 쌍 생성을 클릭합니다.

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

  6. 변경사항 저장을 클릭합니다.

Box 앱 승인

  1. Box Developer Console에서 플랫폼 앱을 선택한 다음 승인 탭으로 이동합니다.
  2. 검토 및 제출을 클릭합니다.
  3. 앱 승인 제출 검토 대화상자에서 제출을 클릭합니다.
  4. 관리자 계정으로 Box 관리 플랫폼 앱 관리자에 로그인합니다.
  5. 구성한 플랫폼 앱을 선택합니다.
  6. 해당 행에서 점 3개 (...)를 클릭합니다.
  7. 드롭다운 목록에서 앱 승인을 선택합니다.
  8. 앱 승인 대화상자에서 승인을 클릭하여 승인 절차를 완료합니다.

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

  • 엔터프라이즈 ID: 일반 설정 탭에서 가져옵니다.
  • 클라이언트 ID 및 클라이언트 보안 비밀번호: OAuth 2.0 사용자 인증 정보의 구성 탭에서 가져옵니다.
  • 비공개 키, 키 ID, 암호: 이러한 매개변수는 앱을 구성하는 동안 공개 키 추가 및 관리의 구성 탭에서 이미 생성되어 로컬 파일에 다운로드되었습니다.

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

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

다음 단계

Coda 연결

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

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

시작하기 전에

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

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

  2. Vertex AI Search와 통합하려면 Coda 관리자가 Coda API 토큰을 생성하거나 가져와야 합니다.

Coda 커넥터 만들기

콘솔

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

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

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

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

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

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

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

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

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

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

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

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

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

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

다음 단계

Confluence Cloud 연결

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

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

시작하기 전에

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

  1. Confluence 인스턴스 및 프로젝트에 대한 관리자 액세스 권한이 있는지 확인합니다.

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

Confluence에서 인증 및 권한 설정

Confluence 인스턴스에 대한 필요한 인증 세부정보와 관리자 액세스 권한이 있는지 확인합니다. 다음 안내에 따라 Atlassian 개발자 콘솔을 통해 클라이언트 ID 및 클라이언트 보안 비밀번호를 만들고, 필요한 OAuth 2.0 범위를 구성하고, 사용자 권한을 설정하고, 인스턴스 URL 및 ID를 검색하고, 역할을 구성하고, 인증하여 Confluence Cloud와 Vertex AI Search 간에 데이터를 동기화합니다. OAuth 2.0을 사용 설정하고 클라이언트 ID와 보안 비밀을 가져오려면 Atlassian 개발자 문서에서 OAuth 2.0 (3LO) 앱을 참고하세요.

  1. Atlassian Developer Console에서 OAuth 2.0 통합을 만듭니다.

    1. Atlassian Developer Console에 로그인합니다.
    2. 프로필 아이콘을 클릭하고 Atlassian Developer Console을 선택합니다.
    3. 만들기를 클릭하고 OAuth 2.0 통합을 선택합니다.
    4. 앱 이름을 입력하고 다음을 실행합니다.
      1. 이용 약관 체크박스를 선택합니다.
      2. 만들기를 클릭합니다.
      3. 승인을 클릭합니다.
      4. 승인 유형 테이블에서 OAuth 2.0(3LO)에 대해 추가를 선택합니다.
    5. 콜백 URL 필드에 https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html를 입력합니다.
    6. 변경사항 저장을 클릭합니다.

    경고: 앱에 API가 없습니다. 앱에 API를 추가하고 2단계로 진행하여 나머지 모든 단계를 완료합니다. 그렇지 않으면 4단계와 5단계로 건너뜁니다.

  2. OAuth 2.0 사용 설정:

    1. 권한을 클릭합니다.
    2. Confluence API로 이동합니다.
    3. 추가를 클릭합니다.
    4. 구성을 클릭합니다.
    5. 세분화된 범위 탭으로 이동하여 범위 수정을 클릭합니다.
    6. 다음 범위를 선택합니다.
    7. 7개 범위가 선택되었는지 확인하고 변경사항을 저장합니다.

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

    1. 배포를 클릭합니다.
    2. 수정을 선택합니다.
    3. 공유를 선택하여 다른 필드 수정을 사용 설정합니다.
    4. 나머지 필드를 작성합니다.
    5. Does your app store personal data?가 표시되면 예를 선택합니다.
    6. 설정을 선택하여 클라이언트 ID 및 클라이언트 보안 비밀번호를 복사합니다.

  4. 인스턴스 URL을 가져옵니다.

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

  5. 인스턴스 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. Atlassian 도메인 사이트로 이동하여 Confluence Cloud 인스턴스를 엽니다.
  5. IAM으로 이동합니다.

  6. Confluence 관리자에게 탐색 엔진 역할을 부여합니다. 그러면 Confluence 관리자가 Confluence Cloud 커넥터 만들기에 설명된 대로 커넥터를 구성할 수 있습니다.

  7. 사용자에게 관리자 역할을 부여합니다.

    1. 전용 사용자 계정을 만듭니다. 데이터 스토어 설정에 이 계정을 사용합니다.
    2. 새 사용자에게 관리자 역할을 할당합니다.

  8. Atlassian에서 권한을 구성합니다.

    1. Atlassian 도메인 사이트로 이동하여 Confluence Cloud 인스턴스를 엽니다. 또는 admin.atlassian.com으로 직접 이동하세요.

    2. 메뉴 아이콘을 클릭하고 필요한 옵션을 선택합니다.

    3. 선택사항: 메시지가 표시되면 방문 페이지에서 적절한 조직을 선택합니다.

  9. 그룹 만들기 및 구성:

    1. 필요한 경우 관리자 페이지에서 사용자 관리 버튼을 클릭하고 드롭다운 목록에서 사용자 관리를 선택합니다.
    2. 사용자 관리 페이지에서 그룹을 선택합니다.
    3. 그룹 만들기를 클릭하고 이름을 할당합니다. 커넥터에 필요한 권한을 할당하는 데 이 그룹을 사용합니다.

  10. 그룹에 권한 추가: 사용자 액세스 관리자 역할을 할당합니다.

  11. 그룹 구성원 할당:

    1. 그룹 페이지에서 제품 추가를 클릭하고 드롭다운 목록에서 적절한 제품 역할을 선택합니다.이 경우 사용자 액세스 관리자를 선택합니다.
    2. 추가를 클릭하여 역할 할당을 확인합니다.
    3. 그룹 구성원 추가를 클릭하여 사용자 계정 또는 그룹 구성원을 포함합니다. 커넥터가 이러한 사용자를 대신하여 인증하여 문서를 가져오는지 확인합니다.

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

Confluence Cloud 커넥터 만들기

콘솔

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

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

다음 단계

Confluence 데이터 센터 온프레미스 연결

이 절차에 따라 Agent Builder에서 Confluence Data Center 데이터 스토어와 검색 앱을 만들어 온프레미스 Confluence 데이터를 Vertex AI Search와 동기화합니다.

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

시작하기 전에

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

  1. 서비스 첨부파일 (비공개 대상 유형에만 필요): 보안 데이터 전송을 위해 서비스 첨부파일을 구성합니다.
  2. 사용자 이름 및 비밀번호: Confluence 관리자에게서 인증에 사용할 유효한 사용자 인증 정보를 받습니다.
  3. 비공개 대상 유형의 경우 선택사항: 도메인 URL: Confluence Data Center 인스턴스의 URL을 지정합니다.
  4. 선택사항: 기본 도메인 이름: Confluence 인스턴스의 기본 도메인 이름을 입력합니다.
  5. 선택사항: 목적지 포트: Confluence 데이터 센터와 통신하는 데 사용되는 포트를 식별합니다.

  6. 다음 구성 가이드라인에 따라 Private Service Connect(PSC)와 연결을 설정합니다. 필요에 따라 리소스를 조정하거나 추가합니다. PSC 서비스 연결이 비공개 인스턴스에 연결되도록 올바르게 구성되었으며 게시된 서비스의 요구사항을 충족하는지 확인합니다.

    1. 네트워크 설정을 구성합니다.

      1. PSC 서비스 연결과 부하 분산기를 동일한 Virtual Private Cloud 네트워크 내 서로 다른 서브넷에 배치합니다.

      2. 백엔드 시스템은 보안상의 이유로 공용 네트워크에 대해 닫혀 있어야 합니다. 하지만 다음 소스에서 트래픽을 수신할 수 있는지 확인합니다.

        • 프록시 기반/HTTP(S) 부하 분산기 (L4 프록시 ILB, L7 ILB)의 경우 Virtual Private Cloud 네트워크의 프록시 서브넷에서 요청을 수락하도록 백엔드를 구성합니다.

        • 자세한 내용은 Envoy 기반 부하 분산기용 프록시 전용 서브넷 문서를 참고하세요.

    2. 방화벽 규칙을 조정합니다.

      1. 인그레스 규칙:

        • PSC 서비스 연결 서브넷에서 내부 부하 분산기 (ILB) 서브넷으로 흐르는 트래픽을 허용합니다.
        • ILB가 백엔드로 트래픽을 전송할 수 있는지 확인합니다.
        • 상태 점검 프로브가 백엔드에 도달하도록 허용합니다.

      2. 이그레스 규칙: 특정 거부 규칙이 적용되지 않는 한 기본적으로 이그레스 트래픽을 사용 설정합니다.

  7. 추가 고려사항: PSC 서비스 연결 및 부하 분산기를 비롯한 모든 구성요소를 동일한 리전에 유지해야 합니다.

서비스 연결 생성

서비스 첨부파일을 생성하려면 다음 단계를 따르세요.

  1. 엔드포인트 유형 결정: 공개 또는 비공개 엔드포인트를 선택합니다.

  2. 공개 엔드포인트: Confluence Data Center 대상 유형이 공개인 경우 서비스 연결 설정을 만들 필요가 없습니다. 대신 커넥터를 만들 때 Google Cloud 콘솔의 도메인 URL 필드에서 공개 URL을 사용할 수 있습니다.

  3. 비공개 엔드포인트의 경우:

    1. Private Service Connect (PSC)를 사용하여 비공개 인스턴스에서 Google Cloud로의 연결을 사용 설정합니다.
    2. Virtual Private Cloud 네트워크와 필요한 서브넷을 만듭니다.
    3. 가상 머신 (VM) 인스턴스를 만들고 백엔드 서비스를 설치합니다.
    4. 선택사항: 백엔드 상태를 모니터링하는 상태 점검 프로브를 설정합니다.
    5. 트래픽을 VM 또는 백엔드로 라우팅하는 부하 분산기를 추가합니다.
    6. PSC 엔드포인트와 백엔드 간의 트래픽을 허용하는 방화벽 규칙을 정의합니다.
    7. PSC 서비스 연결을 만들어 엔드포인트를 게시합니다.

Confluence 데이터 센터 사용자 만들기 및 권한 설정

Vertex AI Search가 Confluence에서 데이터를 가져오도록 하려면 필요한 최소 권한을 가진 새 사용자를 만들어야 합니다. 다음 단계에 따라 사용자를 만들고 필요한 권한을 설정하세요.

  1. 관리자로 로그인합니다.

    1. Atlassian 도메인 사이트로 이동하여 Confluence 데이터 센터 인스턴스를 엽니다.
    2. 관리자 사용자 이름과 비밀번호를 입력합니다.
    3. 로그인을 클릭합니다.

  2. 새 사용자를 만듭니다.

    데이터 스토어를 만들 때는 서드 파티 인스턴스에서 데이터를 가져올 사용자를 만들어야 합니다.

    1. 설정 아이콘을 클릭합니다.
    2. 사용자 관리를 선택합니다.
    3. 메시지가 표시되면 관리자 사용자 인증 정보를 입력합니다.
    4. 관리 페이지에서 사용자 만들기를 클릭합니다.
    5. 이메일 주소, 전체 이름, 사용자 이름, 비밀번호를 입력합니다.
    6. 사용자 만들기를 클릭합니다.

  3. 사용자를 그룹에 할당하려면 다음 단계를 따르세요.

    1. Confluence 관리 페이지에서 사용자 및 보안 탭으로 이동하여 그룹을 클릭합니다.
    2. 그룹 추가를 클릭합니다. 그룹 이름을 입력하고 만듭니다.
    3. 그룹 찾기 입력란에 그룹 이름을 입력하여 그룹을 찾습니다.
    4. 설정 아이콘을 클릭합니다.
    5. 프로필 계정을 선택하고 사용자 관리로 이동합니다.
    6. 사용자 페이지의 사용자 목록에서 사용자 찾기 입력란에 새로 만든 사용자를 검색합니다.
    7. 사용자를 클릭하여 사용자 보기 페이지를 엽니다.
    8. 그룹 수정을 클릭하여 사용자 그룹 수정 페이지를 엽니다.
    9. 생성된 사용자 그룹의 체크박스를 선택합니다.
    10. 저장을 클릭하여 새로 만든 그룹에 사용자를 할당합니다.

    추가된 사용자는 그룹 구성원 섹션에 할당됩니다.

  4. 사용자 권한을 구성합니다.

    1. Confluence 관리 페이지에서 문제 탭으로 이동합니다.
    2. 권한을 찾습니다.
    3. 전역 권한 보기를 선택합니다.
    4. 권한 수정을 선택합니다.
    5. 전체 권한 수정 페이지에서 사용자에게 할당된 그룹을 검색하고 사용 가능 옵션을 사용 설정합니다.

문서 공간 구성

  1. Confluence 아이콘을 클릭하여 대시보드 페이지로 이동합니다.
  2. 스페이스 만들기를 클릭합니다.
  3. 문서 공간을 선택하고 다음을 클릭합니다.
  4. 필요한 모든 세부정보를 입력하고 만들기를 클릭하여 문서 스페이스를 만듭니다.
  5. 내 스페이스에서 새로 만든 스페이스를 클릭합니다.
  6. 페이지로 이동하여 메뉴 (점 3개)를 엽니다.
  7. 제한사항을 선택합니다.
  8. 제한사항 드롭다운 메뉴에서 보기 및 수정 제한됨 옵션을 선택합니다.
  9. 그룹을 검색하고 보기 권한을 할당합니다.
  10. 적용을 클릭합니다. 사용자는 최소 액세스 권한으로 생성되며 스페이스에 권한이 설정됩니다. 블로그에 권한을 할당할 수도 있습니다.

Confluence 데이터 센터 온프레미스 커넥터 만들기

콘솔

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

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

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

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

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

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

  6. 대상 유형 드롭다운 목록에서 공개 또는 비공개를 선택합니다.

    1. 공개 대상 유형의 경우 서비스 연결 설정을 만들 필요가 없습니다. 대신 Google Cloud 콘솔의 도메인 URL 필드에 공개 URL을 사용하면 됩니다.
    2. 비공개 대상 유형의 경우 다음과 같이 모든 필수 정보를 입력합니다.
      1. 인스턴스에 도메인 URL이 있는 경우 다음 단계를 따르세요.
        • 서비스 연결: 서비스 연결을 입력합니다.
        • 선택사항: 기본 도메인 이름: 기본 도메인을 입력합니다.
        • 도메인 URL: 도메인 URL을 입력합니다.
        • 선택사항: 대상 포트: 대상 포트를 입력합니다.
      2. 인스턴스에 도메인 URL이 없는 경우 다음 단계를 따르세요.
        • 서비스 연결: 서비스 연결을 입력합니다.
        • 선택사항: 대상 포트: 대상 포트를 입력합니다.

  7. 계속을 클릭합니다.

  8. 선택사항: 고급 옵션: 필요한 경우 프록시 설정 및 SSL 설정을 선택하고 사용 설정합니다.

  9. 동기화할 항목에서 동기화해야 하는 모든 항목을 선택하고 계속을 클릭합니다.

  10. 데이터 커넥터의 리전을 선택하고 데이터 커넥터의 이름을 입력합니다.

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

비공개 대상 유형의 경우 커넥터 세부정보를 제출하면 VAIS에서 PSC에 연결 요청을 전송합니다. 커넥터로 이동하여 PSC에서 projectId를 허용 목록에 추가하라는 메시지를 확인합니다. PSC에서 연결을 허용할 때까지 커넥터는 오류 상태로 유지됩니다. 연결 요청을 수락하면 다음 동기화 실행 중에 커넥터가 활성 상태로 전환됩니다. 모든 연결을 허용하도록 PSC를 구성하면 커넥터가 생성된 후 자동으로 Active(활성) 상태로 이동합니다.

공개 대상 유형의 경우 커넥터는 제출 후 자동으로 활성 상태로 전환됩니다.

데이터 스토어 및 처리 활동의 상태를 확인하려면 다음 단계를 따르세요.

  1. 데이터 스토어 목록에서 커넥터로 이동하고 상태가 활성으로 변경될 때까지 모니터링합니다.
  2. 커넥터 상태가 활성으로 변경되면 필요한 항목을 클릭하고 선택한 모든 항목이 처리되었는지 확인합니다. 동기화가 시작되면 데이터 스토어 상태가 만들기에서 실행 중으로 전환되고 수집이 완료되면 활성으로 변경되어 데이터 스토어가 설정되었음을 나타냅니다. 데이터 크기에 따라 처리하는 데 몇 시간이 걸릴 수 있습니다.

다음 단계

DocuSign 연결

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

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

시작하기 전에

DocuSign 커넥터의 연결을 설정하기 전에 인증을 위한 다음 사용자 인증 정보가 있는지 확인합니다.

  • 고객 키
  • 비공개 키
  • 사용자 이름

키 및 사용자 인증 정보 생성

DocuSign 인스턴스에서 사용자를 만들고 사용자를 그룹에 할당한 다음 통합 및 인증에 필요한 소비자 키, 비공개 키, 사용자 이름을 생성하는 데 필요한 권한을 부여합니다.

  1. DocuSign 사용자 등록: 신규 사용자인 경우 다음 단계에 따라 DocuSign 개발자 계정을 만듭니다. 기존 사용자인 경우 계정 세부정보 액세스 섹션으로 이동하세요.

    1. DocuSign 개발자 계정으로 이동합니다.

    2. 개발자 계정 드롭다운을 펼치고 계정 만들기를 클릭합니다.

    3. 무료 개발자 계정 만들기 페이지에서 다음 필수 정보를 입력합니다.

      • 이름
      • 성
      • 이메일
      • Company
      • 국가
      • DocuSign 계정 상태 (해당하는 경우)

    4. 시작하기를 클릭합니다.

    5. 이메일 확인 창이 나타납니다. 이메일에서 인증 코드를 확인하고 입력한 후 다음을 클릭합니다.

    6. 휴대전화 번호 인증 창이 표시됩니다. 국가 코드를 선택하고 휴대전화 번호를 입력한 다음 코드 보내기를 클릭합니다.

    7. 받은 임시 코드를 입력하고 인증을 클릭합니다.

    8. 비밀번호 설정 창에 비밀번호를 입력하고 다음을 클릭합니다.

    9. 사용자가 샌드박스 환경에 로그인합니다.

  2. 계정 세부정보에 액세스하는 방법은 다음과 같습니다.

    1. 사용자 프로필 아이콘을 클릭하고 내 앱 및 키를 선택합니다.

    2. 계정 대시보드 및 앱 및 키 페이지가 표시되며 사용자 ID, 계정 ID, 앱 기본 URL이 표시됩니다.

  3. 앱 및 통합 키를 생성합니다.

    1. 앱 및 통합 키 추가를 클릭합니다.

    2. 통합 키 추가 대화상자에 앱 이름을 입력하고 앱 만들기를 클릭합니다.

    3. 사용자가 앱 페이지로 리디렉션됩니다. 인증 섹션에서 '애플리케이션이 클라이언트 보안 비밀을 안전하게 저장할 수 있나요?'라는 질문에 예를 선택하고 보안 비밀 키 추가를 클릭합니다. 보안 비밀 키가 추가됩니다.

    4. 서비스 통합 섹션에서 RSA 생성을 클릭합니다.

    5. RSA 키 쌍 대화상자에는 키 쌍 ID, 공개 키, 비공개 키가 표시됩니다. 다시 표시되지 않으므로 둘 다 복사하세요.

  4. 프로덕션에 사용자 추가:

    1. DocuSign 프로덕션 인스턴스에 로그인합니다.

    2. 관리를 클릭합니다.

    3. 사용자 및 그룹 > 사용자로 이동합니다.

    4. 좌석 및 사용자 페이지의 좌석 사용량에서 좌석 할당을 클릭합니다.

    5. 사용자 추가 페이지에서 이메일 주소를 입력합니다.

    6. 다음을 클릭합니다.

    7. 프로필 정보 섹션의 필수 입력란을 작성합니다.

    8. 다음을 클릭합니다.

    9. 보안 섹션에서 액세스 코드를 추가합니다.

    10. 다음을 클릭합니다.

    11. 권한 프로필 및 그룹 섹션에서 권한을 뷰어로 선택합니다.

    12. 사용자 추가를 클릭합니다.

    13. 좌석 및 사용자 페이지가 표시되고 사용자가 모든 사용자 아래에 표시됩니다.

    14. 사용자 이메일 계정을 열고 계정 활성화 이메일을 사용하여 계정을 활성화합니다.

    15. 활성화를 클릭하고 액세스 코드를 입력한 후 계정을 활성화합니다.

  5. RSA 키 쌍을 생성합니다.

    1. 관리 > 통합 > 앱 및 키로 이동합니다.

    2. 앱 및 키 페이지에서 작업을 클릭하고 앱 및 통합 키 섹션에서 기존 앱 이름에 대해 수정을 선택합니다.

    3. 앱 세부정보 페이지에서 서비스 통합 섹션으로 이동하여 RSA 생성을 클릭합니다.

    4. RSA 키 쌍 대화상자에는 키 쌍 ID, 공개 키, 비공개 키가 표시됩니다. 세부정보를 모두 복사하고 닫기를 클릭합니다.

    5. 프로필 아이콘을 클릭하고 로그아웃합니다.

  6. 프로덕션 인스턴스에 로그인: 최소 액세스 사용자 인증 정보를 사용하여 DocuSign 프로덕션 인스턴스에 로그인합니다. 최소 액세스 사용자 계정에는 관리 메뉴 옵션이 표시되지 않습니다.

DocuSign Cloud 커넥터 만들기

콘솔

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

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

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

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

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

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

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

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

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

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

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

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

다음 단계

Dropbox 연결

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

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

시작하기 전에

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

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

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

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

Dropbox 커넥터 만들기

콘솔

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

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

다음 단계

Dynamics 365 연결

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

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

시작하기 전에

Dynamics 365 커넥터를 만들기 전에 다음을 실행합니다.

  1. Dynamics 365 관리자는 Vertex AI Search와 통합하기 위해 다음을 생성하거나 가져와야 합니다.

    • 클라이언트 ID
    • 클라이언트 보안 비밀번호
    • Azure 테넌트
    • 조직 URL

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

Dynamics 365 커넥터 만들기

콘솔

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

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

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

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

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

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

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

  6. Azure 테넌트 및 조직 URL을 입력하고 계속을 클릭합니다.

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

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

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

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

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

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

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

다음 단계

Entra ID 연결

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

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

시작하기 전에

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

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

  2. 클라이언트 ID와 클라이언트 보안 비밀번호를 가져오려면 다음 단계를 따르세요.

    1. Entra ID 애플리케이션을 만듭니다.

      1. Microsoft Entra 관리자 센터에 로그인하고 애플리케이션을 클릭합니다.
      2. 애플리케이션 드롭다운 목록에서 앱 등록을 클릭합니다.
      3. 앱 등록 페이지에서 새 등록을 클릭합니다.
      4. 새 등록 추가를 클릭하고 다음을 수행합니다.
        • 애플리케이션 이름을 입력합니다.
        • 지원되는 계정 유형에서 조직 디렉터리의 계정만을 선택합니다.
        • 리디렉션 URI에서 https://login.microsoftonline.com/common/oauth2/nativeclient를 가리키는 웹 리디렉션 URI를 추가합니다.
      5. 등록을 클릭합니다.

    2. 사용자 인증 정보 저장:

      등록된 애플리케이션 창에서 나중에 사용할 수 있도록 다음 값을 저장합니다.

      1. 애플리케이션 (클라이언트) ID를 사용하여 클라이언트 ID 매개변수를 설정합니다.
      2. 디렉터리 (테넌트) ID를 사용하여 Azure 테넌트 매개변수를 설정합니다.

    3. 클라이언트 보안 비밀번호를 만듭니다.

      1. 인증서 및 보안 비밀로 이동하여 새 클라이언트 보안 비밀번호를 만듭니다.
      2. 새 클라이언트 보안 비밀번호를 클릭하고 필요한 기간을 지정합니다.
      3. 클라이언트 보안 비밀을 저장하고 나중에 사용할 수 있도록 키 값을 복사합니다.

Entra ID API 권한 구성

  1. 등록된 애플리케이션 창에서 API 권한을 클릭합니다.

  2. 구성된 권한에서 Microsoft Graph를 선택하고 다음 권한을 구성합니다.

    profileCardAttributes를 처리하려면 다음 권한을 구성합니다.

  3. 추가된 모든 권한에 대해 관리자 동의를 부여합니다. 인증 흐름에서 클라이언트 사용자 인증 정보를 사용하려면 관리자의 동의가 필요합니다.

Entra ID 커넥터 만들기

콘솔

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

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

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

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

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

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

  5. 인증 설정에서 클라이언트 ID와 클라이언트 보안 비밀을 입력합니다.

  6. 대상 옵션을 건너뛰고 계속을 클릭합니다.

  7. 고급 옵션에서 Azure 테넌트 ID를 입력합니다.

  8. 데이터를 거의 실시간으로 업데이트하려면 모든 항목에 실시간 동기화 사용을 선택합니다.

  9. 클라이언트 상태 필드에 문자열 값을 입력합니다. 클라이언트 상태는 변경 알림을 인증하는 데 사용됩니다. 서드 파티 앱의 웹훅 인증의 경우 커넥터 생성 중에 전달된 사용자 인증 정보가 재사용됩니다.

  10. 계속을 클릭합니다.

  11. 동기화할 항목에서 사용자 프로필을 선택합니다.

  12. 계속을 클릭합니다.

  13. 데이터 커넥터 구성에서 데이터 스토어의 리전을 선택합니다.

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

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

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

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

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

  18. 커넥터 상태가 활성으로 변경되면 항목 탭으로 이동합니다.

  19. userprofiles 항목을 클릭합니다.

  20. 처리된 문서 수를 확인하고 Entra ID의 사용자 수와 일치하는지 확인합니다.

    Entra ID 앱에 맞춤 속성을 처리하는 데 필요한 권한이 있는 경우 레코드당 최대 15개의 프로필 카드 속성을 처리합니다. 기본적으로 커스텀 속성은 검색할 수 없습니다.

맞춤 속성을 검색 가능하도록 하려면 다음 단계를 따르세요.

  1. userprofiles 페이지에서 스키마 탭으로 이동합니다.
  2. 수정을 클릭합니다.

  3. 주소와 같은 속성이 검색 가능, 색인 생성 가능이 되도록 선택 해제한 다음 저장을 클릭합니다.

    수정 버튼은 다시 활성화되기까지 몇 분 동안 비활성 상태로 유지됩니다.

  4. 수정 버튼이 활성 상태이면 수정을 클릭합니다.

  5. 필수 맞춤 속성에 대해 가져오기 가능, 검색 가능, 색인 생성 가능 체크박스를 선택합니다.

  6. 검색을 사용 설정합니다.

  7. 저장을 클릭합니다.

검색엔진 테스트

검색엔진을 구성한 후 기능을 테스트합니다. 이렇게 하면 사용자 액세스에 따라 정확한 결과를 반환할 수 있습니다.

  1. 웹 앱 사용 설정:

    1. 앱 통합 구성으로 이동하여 웹 앱 사용 설정으로 전환합니다.

  2. 웹 앱 테스트:

    1. 웹 앱 링크 옆에 있는 열기를 클릭하고 사용자로 로그인합니다.

    2. 검색 결과가 사용자가 액세스할 수 있는 항목으로 제한되는지 확인합니다.

사용자 검색 결과 미리보기

  1. 검색 앱에서 미리보기로 이동하고 Google IdP를 사용하는 경우 콘솔 내에서 검색을 시작합니다.

    • 또는 제공된 링크로 이동하여 ID 공급업체로 로그인하여 검색을 시작할 수 있습니다.
    • 검색 결과는 사용자 카드로 표시되며 이름, 직책, 이메일, 프로필 사진과 같은 사용자 세부정보를 표시합니다.

  2. 사용자 카드를 클릭하면 다음과 같은 세부정보 프로필 페이지가 표시됩니다.

    • 이름
    • 프로필 사진
    • 직책
    • 부서
    • 관리 체인
    • 직속 부하 직원

  3. 커스텀 속성 (프로필 카드 속성)이 처리되고 색인 생성, 검색, 검색 가능으로 설정된 경우:

    • 맞춤 속성 값으로 검색하면 해당 속성이 포함된 사용자 프로필만 반환됩니다.
    • 맞춤 속성은 검색 결과에 표시되지만 Vertex Search 사용자 인터페이스가 아닌 API를 통해서만 액세스할 수 있습니다.

SSO 없이 Google 이외의 IdP용 직원 풀 구성

  1. 직원이 Google 이외의 IdP를 사용하거나 Google과의 SSO가 없거나 Google Workspace 고객이 아닌 경우 데이터 소스 액세스 제어 사용에 설명된 대로 인력 풀을 설정하여 직원 검색을 사용 설정하세요.

    직원 풀을 사용하면 Google Cloud 콘솔 내에서 Azure 또는 Okta와 같은 외부 ID 공급업체의 사용자를 관리하고 인증할 수 있습니다.

  2. 원활한 사용자 액세스를 위해 직원 풀을 구성하고 웹 앱을 사용 설정하려면 다음 단계를 따르세요.

    1. 적절한 설정 매뉴얼에 따라 Google Cloud 에서 조직 수준으로 직원 풀을 만듭니다.

      1. Azure OIDC 설정
      2. Azure SAML 설정
      3. Okta 및 OIDC 설정
      4. Okta 및 SAML 설정

    2. 앱을 만드는 리전의 Agent Builder > Settings에서 Workforce Pool을 구성합니다.

다음 단계

GitHub 연결

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

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

시작하기 전에

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

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

  2. Vertex AI Search와 통합하려면 GitHub 관리자가 GitHub 인스턴스 개인 액세스 토큰을 가져와야 합니다.

GitHub 커넥터 만들기

콘솔

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

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

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

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

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

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

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

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

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

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

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

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

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

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

다음 단계

GitLab 연결

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

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

시작하기 전에

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

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

  2. Vertex AI Search와 통합하려면 GitLab 관리자가 GitLab 인스턴스 개인 액세스 토큰을 가져와야 합니다.

GitLab 커넥터 만들기

콘솔

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

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

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

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

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

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

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

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

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

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

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

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

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

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

다음 단계

HubSpot 연결

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

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

시작하기 전에

HubSpot 커넥터를 설정하기 전에 비공개 액세스 토큰 (PAT)을 비롯한 필수 인증 사용자 인증 정보를 사용할 수 있는지 확인합니다.

최고 관리자 사용자 만들기

HubSpot 프로젝트에 최고 관리자 사용자를 추가하려면 다음 단계를 따르세요.

  1. 최고 관리자 사용자 사용자 인증 정보로 HubSpot 개발자 콘솔에 로그인합니다.
  2. 설정을 클릭합니다.
  3. 사용자 및 팀으로 이동합니다.
  4. 사용자 만들기를 클릭합니다.
  5. 추가하려는 사용자의 이메일 주소를 입력하고 다음을 클릭합니다.
  6. 좌석 할당 드롭다운 목록에서 맞춤 권한 세트 사용을 선택합니다.
  7. 맞춤 권한 세트 선택을 클릭합니다.
  8. 권한 세트에서 최고 관리자를 선택합니다.
  9. 다음을 클릭합니다.
  10. 사용자 액세스 검토 창에서 액세스 설정을 확인한 다음 결제를 클릭합니다.

HubSpot 비공개 액세스 토큰 만들기

HubSpot PAT를 만들려면 다음 단계를 따르세요.

  1. 최고 관리자 사용자 사용자 인증 정보로 HubSpot 개발자 콘솔에 로그인합니다.
  2. 설정 > 통합으로 이동합니다.
  3. 이름 및 설명을 입력합니다.
  4. + 새 범위 추가를 클릭합니다.
  5. 모든 필수 범위를 추가합니다.
  6. 앱 만들기를 클릭합니다.
  7. 계속 만들기를 클릭하고 비공개 액세스 토큰을 복사합니다.
  8. 닫기를 클릭합니다.

HubSpot 커넥터 만들기

콘솔

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

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

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

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

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

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

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

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

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

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

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

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

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

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

다음 단계

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. Atlassian Developer Console에서 OAuth 2.0 통합을 만듭니다.

    1. Atlassian Developer Console에 로그인합니다.
    2. 프로필 아이콘을 클릭하고 개발자 콘솔을 선택합니다.
    3. 만들기를 클릭하고 OAuth 2.0 통합을 선택합니다.

    4. 앱 이름을 입력하고 다음을 실행합니다.

      1. 이용 약관 체크박스를 선택합니다.
      2. 만들기를 클릭합니다.
      3. 승인을 클릭합니다.
      4. 승인 유형 테이블에서 OAuth 2.0(3LO)에 대해 추가를 선택합니다.

    5. 콜백 URL 필드에 https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html를 입력합니다.

    6. 변경사항 저장을 클릭합니다.

    경고: 앱에 API가 없습니다. 앱에 API를 추가하고 2단계로 진행하여 나머지 모든 단계를 완료합니다. 그렇지 않으면 4단계와 5단계로 건너뜁니다.

  2. OAuth 2.0 사용 설정:

    1. 권한을 선택합니다.

      1. Jira API로 이동합니다.
      2. 추가를 클릭합니다.
      3. 구성을 클릭합니다.
      4. 기존 범위 탭으로 이동하고 범위 수정을 클릭합니다. 다음 범위를 선택합니다.

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

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

    1. 배포를 클릭합니다.

    2. 수정을 선택하고 다음을 수행합니다.

      1. 공유를 선택하여 다른 필드 수정을 사용 설정합니다.
      2. 나머지 필드를 작성합니다.
      3. Does your app store personal data?가 표시되면 예를 선택합니다.

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

  4. 인스턴스 URL을 가져옵니다.

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

  5. 인스턴스 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. 그룹에 제품 추가 대화상자에서 사용자 액세스 관리자를 제품 역할로 선택합니다.
  7. 추가를 클릭합니다.
  8. 그룹 페이지에서 그룹 멤버 추가를 클릭하여 커넥터가 인증하는 사용자 또는 계정을 추가합니다.

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

Jira Cloud 커넥터 만들기

콘솔

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

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

    Agent Builder

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

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

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

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

  6. 인스턴스 사용자 이름과 비밀번호를 입력합니다.

  7. 데이터 스토어의 Jira 소스 지정 페이지로 돌아가기 전에 인증이 완료되었는지 확인합니다.

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

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

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

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

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

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

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

다음 단계

Jira 데이터 센터 온프레미스 연결

이 절차에 따라 Agent Builder에서 Jira 데이터 센터 데이터 스토어와 검색 앱을 만들어 온프레미스 Jira 데이터를 Vertex AI Search와 동기화합니다.

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

시작하기 전에

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

  1. 서비스 첨부파일 (비공개 대상 유형에만 필요): 보안 데이터 전송을 위해 서비스 첨부파일을 구성합니다.
  2. 사용자 이름 및 비밀번호: Jira 관리자에게서 인증을 위한 유효한 사용자 인증 정보를 받습니다.
  3. 비공개 대상 유형의 경우 선택사항: 도메인 URL: Jira Data Center 인스턴스의 URL을 지정합니다.
  4. 선택사항: 기본 도메인 이름: Jira 인스턴스의 기본 도메인 이름을 입력합니다.
  5. 선택사항: 목적지 포트: Jira 데이터 센터와 통신하는 데 사용되는 포트를 식별합니다.

  6. 다음 구성 가이드라인에 따라 Private Service Connect(PSC)와 연결을 설정합니다. 필요에 따라 리소스를 조정하거나 추가합니다. PSC 서비스 연결이 비공개 인스턴스에 연결되도록 올바르게 구성되었으며 게시된 서비스의 요구사항을 충족하는지 확인합니다.

    1. 네트워크 설정을 구성합니다.

      1. PSC 서비스 연결과 부하 분산기를 동일한 Virtual Private Cloud 네트워크 내 서로 다른 서브넷에 배치합니다.

      2. 백엔드 시스템은 보안상의 이유로 공용 네트워크에 대해 닫혀 있어야 합니다. 하지만 다음 소스에서 트래픽을 수신할 수 있는지 확인합니다.

        • 프록시 기반/HTTP(S) 부하 분산기 (L4 프록시 ILB, L7 ILB)의 경우 Virtual Private Cloud 네트워크의 프록시 서브넷에서 요청을 수락하도록 백엔드를 구성합니다.

        • 자세한 내용은 Envoy 기반 부하 분산기용 프록시 전용 서브넷 문서를 참고하세요.

    2. 방화벽 규칙을 조정합니다.

      1. 인그레스 규칙:

        • PSC 서비스 연결 서브넷에서 내부 부하 분산기 (ILB) 서브넷으로 흐르는 트래픽을 허용합니다.
        • ILB가 백엔드로 트래픽을 전송할 수 있는지 확인합니다.
        • 상태 점검 프로브가 백엔드에 도달하도록 허용합니다.

      2. 이그레스 규칙: 특정 거부 규칙이 적용되지 않는 한 기본적으로 이그레스 트래픽을 사용 설정합니다.

  7. 추가 고려사항: PSC 서비스 연결 및 부하 분산기를 비롯한 모든 구성요소를 동일한 리전에 유지해야 합니다.

서비스 연결 생성

서비스 첨부파일을 생성하려면 다음 단계를 따르세요.

  1. 엔드포인트 유형 결정: 공개 또는 비공개 엔드포인트를 선택합니다.

  2. 공개 엔드포인트: Jira Data Center 대상 유형이 공개인 경우 서비스 연결 설정을 만들 필요가 없습니다. 대신 Google Cloud 콘솔의 도메인 URL 필드에서 공개 URL을 사용하면 됩니다.

  3. 비공개 엔드포인트의 경우:

    1. PSC를 사용하여 비공개 인스턴스에서 Google Cloud에 대한 연결을 사용 설정합니다.
    2. Virtual Private Cloud 네트워크와 필요한 서브넷을 만듭니다.
    3. 가상 머신 (VM) 인스턴스를 만들고 백엔드 서비스를 설치합니다.
    4. 선택사항: 백엔드 상태를 모니터링하는 상태 점검 프로브를 설정합니다.
    5. 트래픽을 VM 또는 백엔드로 라우팅하는 부하 분산기를 추가합니다.
    6. PSC 엔드포인트와 백엔드 간의 트래픽을 허용하는 방화벽 규칙을 정의합니다.
    7. PSC 서비스 연결을 만들어 엔드포인트를 게시합니다.

Jira Data Center 사용자 만들기 및 권한 설정

Vertex AI Search에서 Jira에서 데이터를 가져오도록 하려면 필요한 최소 권한을 가진 새 사용자를 만들어야 합니다. 다음 단계에 따라 사용자를 만들고 필요한 권한을 설정하세요.

  1. 관리자로 로그인합니다.

    1. Atlassian 도메인 사이트로 이동하여 Jira 데이터 센터 인스턴스를 엽니다.
    2. 관리자의 사용자 이름과 비밀번호를 입력합니다.
    3. 로그인을 클릭합니다.

  2. 새 사용자를 만듭니다.

    데이터 스토어를 만들 때는 서드 파티 인스턴스에서 데이터를 가져올 사용자를 만들어야 합니다.

    1. 설정 아이콘을 클릭합니다.
    2. 사용자 관리를 선택합니다.
    3. 메시지가 표시되면 관리자 사용자 인증 정보를 입력합니다.
    4. 관리 페이지에서 사용자 만들기를 클릭합니다.
    5. 이메일 주소, 전체 이름, 사용자 이름, 비밀번호를 입력합니다.
    6. 사용자 만들기를 클릭합니다.

  3. 사용자를 그룹에 할당하려면 다음 단계를 따르세요.

    1. 관리 페이지의 사용자 관리에서 그룹을 클릭합니다.
    2. 이름을 입력하고 그룹 추가를 클릭하여 그룹을 만듭니다.
    3. 새로 만든 그룹을 선택합니다.
    4. 사용자 추가/삭제를 클릭합니다.
    5. 선택한 그룹에 구성원 추가 상자 옆에 있는 구성원 아이콘을 클릭합니다.
    6. 새로 만든 사용자를 선택하고 선택사항 저장을 클릭합니다.
    7. 선택한 사용자 추가를 클릭하여 그룹 구성원 섹션에 새 사용자를 표시합니다.

    그룹 구성원 섹션에서 추가된 사용자가 할당된 것을 확인할 수 있습니다.

  4. 사용자 권한을 구성합니다.

    1. 관리 페이지에서 문제 탭으로 이동합니다.
    2. 권한 스키마를 선택합니다.
    3. 권한 스키마 추가를 클릭합니다.
    4. 스키마의 이름을 입력하고 추가를 클릭합니다.
    5. 스키마를 선택하고 권한 아이콘을 클릭합니다.
    6. 권한 부여를 클릭합니다.
    7. 다음 권한을 추가하고, 앞서 만든 그룹에 이러한 권한을 할당한 후 부여를 클릭합니다.
      1. 프로젝트를 탐색합니다.
      2. 프로젝트 보관 파일 탐색
    8. 그룹의 사용자가 프로젝트, 문제, 댓글, 워크로그, 첨부파일을 보려면 액세스 권한이 필요한 프로젝트에 이 스키마를 추가합니다.

이 그룹의 사용자가 해당 프로젝트 및 프로젝트의 문제, 댓글, 워크로그, 첨부파일을 볼 수 있는 액세스 권한이 필요한 프로젝트에 이 스키마를 추가할 수 있습니다.

애플리케이션 액세스 구성

  1. 관리 페이지에서 애플리케이션 탭으로 이동합니다.
  2. 애플리케이션 탭에서 애플리케이션 액세스를 선택합니다.
  3. 만든 그룹을 검색하여 선택합니다.
  4. 그룹이 액세스 목록에 표시되는지 확인합니다.

최소 액세스 권한으로 사용자가 생성됩니다. 이 스키마가 프로젝트에 추가됩니다. Jira 관리자는 해당 그룹에 구성원을 더 추가하거나 해당 프로젝트에 사용자를 추가할 수 있습니다.

Jira Data Center 온프레미스 커넥터 만들기

콘솔

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

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

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

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

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

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

  6. 대상 유형 드롭다운 목록에서 공개 또는 비공개를 선택합니다.

    1. 공개 대상 유형의 경우 서비스 연결 설정을 만들 필요가 없습니다. 대신 Google Cloud 콘솔의 도메인 URL 필드에 공개 URL을 사용하면 됩니다.

    2. 비공개 대상 유형의 경우 다음과 같이 모든 필수 정보를 입력합니다.

      1. 인스턴스에 도메인 URL이 있는 경우 다음 단계를 따르세요.
        • 서비스 연결: 서비스 연결을 입력합니다.
        • 선택사항: 기본 도메인 이름: 기본 도메인을 입력합니다.
        • 도메인 URL: 도메인 URL을 입력합니다.
        • 선택사항: 대상 포트: 대상 포트를 입력합니다.
      2. 인스턴스에 도메인 URL이 없는 경우 다음 단계를 따르세요.
        • 서비스 연결: 서비스 연결을 입력합니다.
        • 선택사항: 대상 포트: 대상 포트를 입력합니다.

  7. 계속을 클릭합니다.

  8. 선택사항: 고급 옵션: 필요한 경우 프록시 설정 및 SSL 설정을 선택하고 사용 설정합니다.

  9. 동기화할 항목에서 동기화해야 하는 모든 항목을 선택하고 계속을 클릭합니다.

  10. 데이터 커넥터의 리전을 선택하고 데이터 커넥터의 이름을 입력합니다.

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

비공개 대상 유형의 경우 커넥터 세부정보를 제출하면 VAIS에서 PSC에 연결 요청을 전송합니다. 커넥터로 이동하여 PSC에서 projectId를 허용 목록에 추가하라는 메시지를 확인합니다. PSC에서 연결을 허용할 때까지 커넥터는 오류 상태로 유지됩니다. 연결 요청을 수락하면 다음 동기화 실행 중에 커넥터가 활성 상태로 전환됩니다. 모든 연결을 허용하도록 PSC를 구성하면 커넥터가 생성된 후 자동으로 Active(활성) 상태로 이동합니다.

공개 대상 유형의 경우 커넥터는 제출 후 자동으로 활성 상태로 전환됩니다. 데이터 스토어 및 처리 활동의 상태를 확인하려면 다음 단계를 따르세요.

  1. 데이터 스토어 목록에서 커넥터로 이동하고 상태가 활성으로 변경될 때까지 모니터링합니다.
  2. 커넥터 상태가 활성으로 변경되면 필요한 항목을 클릭하고 선택한 모든 항목이 처리되었는지 확인합니다. 동기화가 시작되면 데이터 스토어 상태가 만들기에서 실행 중으로 전환되고 수집이 완료되면 활성으로 변경되어 데이터 스토어가 설정되었음을 나타냅니다. 데이터 크기에 따라 처리하는 데 몇 시간이 걸릴 수 있습니다.

다음 단계

Marketo Cloud 연결

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

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

시작하기 전에

연결을 설정하기 전에 클라이언트 ID 및 클라이언트 보안 비밀번호를 비롯한 인증 사용자 인증 정보가 있는지 확인합니다.

인증 사용자 인증 정보 생성

  1. Marketo 관리자 사용자를 만듭니다.

    1. 관리자 사용자 인스턴스로 Marketo에 로그인합니다.
    2. 홈 탭에서 관리를 클릭합니다.
    3. 보안 > 사용자 및 역할로 이동하여 관리 콘솔로 이동을 클릭합니다.
    4. Adobe Console의 빠른 링크에서 사용자 추가를 클릭합니다.

    5. 팀에 사용자 추가 대화상자에서 다음을 수행합니다.

      1. 이메일 주소를 입력해 주세요.
      2. 제품 구독을 Marketo Engage – googledevsandbox로 선택합니다.
      3. 저장을 클릭합니다.

    6. Marketo 관리 > 보안 > 사용자 및 역할로 돌아가 새로 만든 사용자를 찾습니다.

    7. 사용자를 선택하고 수정을 클릭합니다.

    8. 일반 사용자 역할을 삭제하고 관리자 역할을 할당합니다.

    9. 저장을 클릭합니다.

  2. Marketo 클라이언트 ID 및 보안 비밀번호를 만듭니다.

    1. Marketo 인증 서비스 인스턴스로 이동합니다.
    2. 관리자 사용자 인증 정보를 입력하고 계속을 클릭합니다.
    3. 관리를 클릭합니다.
    4. 관리 대시보드에서 보안 > 사용자 및 역할로 이동합니다.
    5. API 전용 사용자 만들기를 클릭합니다.

    6. 새 API 전용 사용자 만들기 창에서 다음을 수행합니다.

      1. 다음 필수 입력란을 작성합니다.

        • 이메일
        • 이름
        • 성

      2. 필요한 역할을 선택하고 API 전용 사용자 만들기를 클릭합니다.

    7. 관리를 클릭한 다음 통합 > LaunchPoint로 이동합니다.

    8. 새로 만들기 > 새 서비스를 클릭합니다.

    9. 새 서비스 창에서 다음을 수행합니다.

      1. 식별을 위한 표시 이름을 입력합니다.
      2. 서비스 필드에서 맞춤을 선택합니다.
      3. 설명을 입력합니다.
      4. API 전용 사용자 필드에서 이전에 만든 API 사용자를 선택합니다.
      5. 만들기를 클릭합니다. API 사용자가 설치된 서비스 페이지에 표시됩니다.

    10. 설치된 서비스 페이지에서 API 사용자 행으로 이동합니다.

    11. 세부정보 열에서 세부정보 보기를 클릭하여 클라이언트 ID 및 보안 키를 가져옵니다.

Marketo Cloud 커넥터 만들기

콘솔

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

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

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

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

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

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

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

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

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

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

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

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

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

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

다음 단계

Microsoft Outlook 연결

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

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

시작하기 전에

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

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

  2. Vertex AI Search와 통합하려면 Microsoft Outlook 관리자가 다음을 생성하거나 가져와야 합니다.

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

  3. 다음 범위를 구성합니다.

Microsoft Outlook 커넥터 만들기

콘솔

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

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

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

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

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

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

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

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

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

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

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

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

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

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

다음 단계

Microsoft Teams 연결

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

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

시작하기 전에

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

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

  2. Vertex AI Search와 통합하려면 Microsoft Teams 관리자가 다음을 생성하거나 가져와야 합니다.

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

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

Microsoft Teams 커넥터 만들기

콘솔

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

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

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

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

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

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

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

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

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

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

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

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

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

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

다음 단계

Connect Monday

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

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

시작하기 전에

연결을 설정하기 전에 도메인 URL, 관리자 액세스 권한, API 토큰이 있는지 확인하세요.

계정 URL 및 API 토큰을 생성하려면 다음 단계를 따르세요.

  1. 관리자 계정으로 Monday 애플리케이션에 로그인합니다.
  2. 프로필 아이콘을 클릭합니다.
  3. 관리를 선택합니다.
  4. 일반 탭으로 이동하여 계정 이름 및 계정 URL을 입력합니다.
  5. 프로필 아이콘으로 돌아가서 개발자를 선택합니다.
  6. Monday 개발자 센터 페이지에서 내 액세스 토큰을 클릭합니다.
  7. 표시를 클릭하여 토큰을 표시합니다.
  8. 인증에 사용할 토큰을 복사합니다.

Monday 커넥터 만들기

콘솔

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

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

    Agent Builder

  2. 데이터 스토어 페이지에서 데이터 스토어 만들기를 클릭합니다.

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

  4. Monday 인증 정보를 입력하고 계속을 클릭합니다.

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

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

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

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

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

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

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

다음 단계

Notion 연결

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

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

시작하기 전에

커넥터를 설정하기 전에 다음을 확인하세요.

  1. 이 커넥터는 서드 파티 커넥터 허용 목록 외에도 프로젝트를 추가 허용 목록에 추가해야 합니다. 이 허용 목록에 추가하려면 Vertex AI Search 계정팀에 문의하세요.

  2. Notion 관리자는 Vertex AI Search와 통합하기 위해 다음을 생성하거나 가져와야 합니다.

    • Notion 인스턴스의 API 토큰
    • 작업공간 ID

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

Notion 커넥터 만들기

콘솔

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

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

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

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

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

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

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

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

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

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

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

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

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

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

다음 단계

Okta 연결

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

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

시작하기 전에

커넥터를 설정하기 전에 도메인 URL과 Okta 인스턴스에 대한 관리자 액세스 권한이 있는지 확인하세요. 다음 단계에 따라 Okta 인스턴스 URL, 클라이언트 ID, API 토큰을 가져옵니다.

  1. Okta 인스턴스 URL을 가져오려면 다음 단계를 따르세요.

    1. 관리자 사용자 인증 정보로 Okta 로그인 페이지에 로그인합니다.
    2. 프로필 아이콘을 클릭하거나 관리 콘솔로 바로 이동합니다. Okta 인스턴스 URL이 주소 표시줄에 하위 도메인으로 표시됩니다.

  2. 클라이언트 ID 및 API 토큰을 생성하려면 다음 단계를 따르세요.

    1. 관리자 계정으로 Okta 인스턴스 URL에 로그인합니다.
    2. 관리 대시보드로 이동합니다.
    3. 애플리케이션 아이콘을 클릭하고 애플리케이션을 선택합니다.
    4. 앱 통합 만들기를 클릭합니다.
    5. OIDC - OpenID Connect를 선택합니다.
    6. 애플리케이션 유형으로 웹 애플리케이션을 선택한 다음 다음을 클릭합니다.
    7. 앱 통합 이름 필드에 이름을 입력합니다.
    8. 스크롤하여 할당을 확인하고 지금은 그룹 할당 건너뛰기를 선택합니다.
    9. 저장을 클릭합니다.
    10. 클라이언트 사용자 인증 정보 창에서 수정을 클릭합니다.
    11. 공개 키 / 비공개 키를 선택합니다.
    12. 공개 키에서 키 추가를 클릭합니다.
    13. 새 키 생성을 클릭한 다음 완료 및 저장을 클릭합니다.
    14. 대화상자가 표시되면 저장을 클릭합니다.
    15. 일반 설정에서 수정을 클릭합니다.
    16. 클라이언트 사용자 인증 정보를 선택한 다음 저장을 클릭합니다.

Okta 커넥터 만들기

콘솔

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

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

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

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

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

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

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

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

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

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

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

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

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

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

다음 단계

OneDrive 연결

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

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

시작하기 전에

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

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

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

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

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

    3. 다음 범위를 구성합니다.

OneDrive 커넥터 만들기

콘솔

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

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

다음 단계

Salesforce 연결

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

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

시작하기 전에

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

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

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

    • 인스턴스 URL
    • 소비자 ID
    • 고객 비밀번호

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

  1. Enterprise 또는 개발자 요금제를 사용합니다. 무료 체험 계정은 지원되지 않습니다.
  2. Sales Cloud를 사용하고 있는지 확인합니다. Service Cloud는 지원되지 않습니다.
  3. Salesforce CORS 허용 목록에 Google Cloud 를 추가합니다. 이 작업을 이미 완료한 경우 다음 단계로 이동합니다.
    1. Salesforce 문서의 안내에 따라 CORS 허용 목록을 구성합니다.
    2. 출처 URL로 https://console.cloud.google.com/을 입력하고 구성을 저장합니다.

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

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

시작하기 전에

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

  1. ServiceNow 인스턴스: ServiceNow 개발자 문서의 안내에 따라 ServiceNow 인스턴스를 만듭니다.

  2. Google Cloud 프로젝트: 조직 수준 구성을 관리할 수 있는 관리자 계정으로 프로젝트를 설정하여 조직에서 인력 풀을 설정할 수 있도록 합니다. Google Cloud

  3. 직원 풀: 조직이 직원 풀을 관리하도록 설정되어 있는지 확인합니다.

ServiceNow 설정

ServiceNow는 다음과 같은 두 가지 기본 사이트를 제공합니다.

  1. 기본 ServiceNow 사이트: ServiceNow 인스턴스의 사이트입니다.

    • 사용자, 그룹, 시스템 관리 작업을 관리합니다.
    • URL: ServiceNow 인스턴스의 URL입니다.
    • 관리자 사용자 인증 정보를 사용하여 로그인합니다.

  2. 개발자 사이트:

    • 기술 자료 구성, 워크플로 설정, 맞춤 애플리케이션 개발
    • URL: https://developer.service-now.com
    • ServiceNow ID로 로그인합니다.

OAuth 엔드포인트를 만들려면 다음 단계를 따르세요.

  1. 관리자 권한으로 기본 ServiceNow 인스턴스에 로그인합니다.
  2. 모두 > 시스템 OAuth > 애플리케이션 레지스트리로 이동합니다.
  3. 새로 만들기를 클릭한 다음 외부 클라이언트용 OAuth API 엔드포인트 만들기를 선택합니다. 클라이언트 ID와 클라이언트 보안 비밀번호를 가져옵니다.

  4. 다음 필수 정보를 입력합니다.

    1. 이름: 고유한 이름입니다.
    2. 리디렉션 URL: https://vertexaisearch.cloud.google.com/console/oauth/servicenow_oauth.html.

  5. 제출을 클릭하여 사용자 인증 정보를 만듭니다.

  6. 제출 후 이름을 클릭하여 클라이언트 보안 비밀을 확인합니다.

  7. 보안 비밀이 마스킹됩니다. 옆에 있는 자물쇠 아이콘을 클릭하여 보안 비밀을 마스킹 해제하고 확인합니다.

  8. 필요할 때 사용할 수 있도록 클라이언트 ID와 보안 비밀의 사본을 보관합니다.

  9. developer.service-now.com로 이동하여 인스턴스 비밀번호 관리를 클릭합니다.

  10. 필요한 경우 사용할 수 있도록 사용자 이름과 비밀번호 사본을 보관합니다.

  11. 이 단계에서는 ServiceNow 데이터 스토어를 설정하는 데 필요한 5가지 정보를 모두 사용할 수 있습니다. 관리자 역할을 사용하여 데이터를 가져오는 데 문제가 없다면 데이터 스토어를 만듭니다.

역할 및 권한 설정하기

사용자를 만들고 관리하려면 보안 관리자 역할이 있어야 합니다. 이 역할이 없으면 프로필에서 역할 승격을 클릭하여 역할을 security_admin으로 승격하세요. security_admin 역할을 선택하고 업데이트를 클릭합니다. 역할 만들기 및 사용자 관리에는 security_admin 역할이 필요합니다.

  1. ACL 규칙이 있는 커스텀 역할을 만듭니다.

    1. 모두 > 사용자 관리 > 역할로 이동합니다.
    2. 새로 만들기를 클릭하여 새 역할을 만듭니다.
    3. 이름을 선택하고 제출을 클릭합니다.
    4. 시스템 보안 > 액세스 제어 (ACL)로 이동하여 새 ACL 규칙을 만듭니다.
    5. 새로 만들기를 클릭하여 새 ACL 규칙을 만듭니다.
    6. 역할(예: sys_user_role)을 선택합니다.
    7. 제출을 클릭하고 역할을 할당합니다.

    8. 모든 테이블 액세스 권한이 부여될 때까지 이 프로세스를 반복합니다. 각 항목이 실행되려면 커넥터에 다음 테이블에 대한 액세스 권한이 필요합니다.

      1. Incident: incident.
      2. 카탈로그 항목: sc_cat_item, sc_cat_item_user_criteria_mtom, sc_cat_item_user_criteria_no_mtom, sc_cat_item_user_mtom, sc_cat_item_user_no_mtom
      3. 지식: kb_knowledge, kb_knowledge_base, kb_uc_can_read_mtom, kb_uc_can_contribute_mtom
      4. 첨부파일: 나열된 모든 항목입니다.
      5. ID: sys_user_role, sys_user_has_role, sys_user_group, sys_user_grmember, sys_user
      6. 새로운 기준이 가져올 때 업데이트됨: core_company, cmn_location, cmn_department
      7. 사용자 기준: user_criteria.

    9. 검색창에서 sys_security_acl_role_list.do로 이동하여 모든 ACL이 업데이트되었는지 확인합니다.

    10. 확인할 역할을 선택합니다.

    11. 선택한 역할에 모든 필수 ACL이 할당되었는지 확인합니다.

  2. 서비스 계정에 역할을 부여합니다.

    1. 모두 > 사용자 관리 > 사용자로 이동하여 사용자를 선택합니다.
    2. 역할이 부여될 사용자를 찾아 선택합니다.

  3. 사용할 수 있는 사용자가 없는 경우 시스템 보안 > 사용자 및 그룹 > 사용자로 이동합니다.

  4. 새로 만들기를 클릭하여 사용자 테이블에 새 서비스 계정을 만듭니다.

  5. 웹 서비스 액세스 전용 체크박스를 선택해야 합니다.

  6. 페이지 하단의 역할 표로 이동합니다.

  7. 오른쪽에서 수정을 클릭합니다.

  8. 앞서 만든 역할을 부여하고 사용자에게 할당합니다. 만든 역할 유형에 따라 적절한 역할을 선택하고 할당합니다.

  9. 사용자의 사용자 이름과 비밀번호를 가져옵니다. 동일한 페이지에서 비밀번호 설정을 클릭합니다.

  10. 비밀번호를 자동 생성하고 나중에 사용할 수 있도록 저장합니다.

    1. 사용자 ID: manager.
    2. 비밀번호: 자동 생성된 비밀번호를 입력합니다.

직원 풀 구성

안내에 따라 다음 구성 중 하나를 사용하여 직원 풀을 설정합니다.

  1. Azure OIDC 설정
  2. Azure SAML 설정
  3. Okta 및 OIDC 설정
  4. Okta 및 SAML 설정

ServiceNow 커넥터 만들기

콘솔

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 데이터 센터 온프레미스 연결

이 섹션에서는 SharePoint 데이터 센터 온프레미스 커넥터를 만드는 프로세스를 설명합니다.

온프레미스 SharePoint 데이터 센터의 데이터 동기화

다음 절차에 따라 온프레미스 SharePoint 데이터 센터의 데이터를 동기화합니다.

데이터 소스를 설정하고 데이터를 처음 가져온 후에는 데이터 스토어가 구성 중에 지정된 빈도로 소스의 데이터를 동기화합니다.

시작하기 전에

연결을 설정하기 전에 다음을 실행합니다.

  1. 서비스 연결 (비공개 대상 유형에만 필요): 다음 단계에 따라 안전한 데이터 전송을 위한 서비스 연결을 생성합니다.

    1. 엔드포인트 유형 결정: 공개 또는 비공개 엔드포인트를 선택합니다.

    2. 공개 엔드포인트: SharePoint 데이터 센터 대상 유형이 공개인 경우 서비스 첨부파일 설정을 만들 필요가 없습니다. 대신 커넥터를 만들 때 Google Cloud 콘솔의 도메인 URL 입력란에 공개 URL을 사용할 수 있습니다.

    3. 비공개 엔드포인트의 경우:

      1. Private Service Connect (PSC)를 사용하여 비공개 인스턴스에서 Google Cloud
      2. Virtual Private Cloud 네트워크와 필요한 서브넷을 만듭니다.
      3. 가상 머신 (VM) 인스턴스를 만들고 백엔드 서비스를 설치합니다.
      4. 선택사항: 백엔드 상태를 모니터링하는 상태 점검 프로브를 설정합니다.
      5. 트래픽을 VM 또는 백엔드로 라우팅하는 부하 분산기를 추가합니다.
      6. PSC 엔드포인트와 백엔드 간의 트래픽을 허용하는 방화벽 규칙 정의
      7. PSC 서비스 연결을 만들어 엔드포인트를 게시합니다.

  2. 사용자 이름 및 비밀번호: SharePoint 관리자로부터 유효한 인증 사용자 인증 정보를 받습니다.

  3. 비공개 대상 유형의 선택사항: 도메인 URL: 인스턴스가 프록시 또는 SSL 기반 연결 뒤에 있는 경우 SharePoint 데이터 센터 인스턴스의 도메인 URL을 유지합니다.

  4. 선택사항: 기본 도메인 이름: SharePoint 인스턴스의 기본 도메인 이름을 입력합니다.

  5. 선택사항: 목적지 포트: SharePoint 데이터 센터와의 통신에 사용되는 포트를 식별합니다.

  6. 다음 구성 가이드라인에 따라 Private Service Connect(PSC)와 연결을 설정합니다. 필요에 따라 리소스를 조정하거나 추가합니다. PSC 서비스 연결이 비공개 인스턴스에 연결되도록 올바르게 구성되었으며 게시된 서비스의 요구사항을 충족하는지 확인합니다.

    1. 네트워크 설정을 구성합니다.

      1. PSC 서비스 연결과 부하 분산기를 동일한 Virtual Private Cloud 네트워크 내의 서로 다른 서브넷에 배치합니다.

      2. 백엔드 시스템은 보안상의 이유로 공용 네트워크에 대해 닫혀 있어야 합니다. 하지만 다음 소스에서 트래픽을 수신할 수 있는지 확인합니다.

        • 프록시 기반/HTTP(S) 부하 분산기 (L4 프록시 ILB, L7 ILB)의 경우 가상 프라이빗 클라우드 네트워크의 프록시 서브넷에서 요청을 수락하도록 백엔드를 구성합니다.

        • 자세한 내용은 Envoy 기반 부하 분산기용 프록시 전용 서브넷 문서를 참고하세요.

    2. 방화벽 규칙을 조정합니다.

      1. 인그레스 규칙:

        • PSC 서비스 연결 서브넷에서 내부 부하 분산기 (ILB) 서브넷으로의 트래픽을 허용합니다.
        • ILB가 백엔드로 트래픽을 전송할 수 있는지 확인합니다.
        • 상태 점검 프로브가 백엔드에 도달하도록 허용합니다.

      2. 이그레스 규칙: 특정 거부 규칙이 적용되지 않는 한 기본적으로 이그레스 트래픽을 사용 설정합니다.

  7. 추가 고려사항: PSC 서비스 연결 및 부하 분산기를 비롯한 모든 구성요소를 동일한 리전에 유지해야 합니다.

SharePoint 최소 액세스 권한 사용자 만들기 및 권한 설정

SharePoint 최소 액세스 권한 사용자를 만들려면 관리자로부터 사용자 이름과 비밀번호를 받습니다. 관리자는 로그인한 후 다음 단계에 따라 SharePoint 데이터 센터 인스턴스에 새 사용자를 만듭니다.

  1. 시작 메뉴를 클릭하고 Windows 관리 도구 > Active Directory 사용자 및 컴퓨터로 이동합니다.
  2. Active Directory 사용자 및 컴퓨터 애플리케이션을 실행합니다.
  3. 조직 단위를 펼치고 새 사용자가 추가된 사용자 컨테이너로 이동합니다.
  4. 사용자를 마우스 오른쪽 버튼으로 클릭하고 새로 만들기 > 사용자를 선택합니다.
  5. 새 객체: 사용자 창에 다음 세부정보를 입력합니다.
    • 이름 (쉼표 또는 마침표를 사용하지 않음)
    • 이름
    • 사용자 로그온 이름
  6. 다음을 클릭합니다.
  7. 비밀번호를 입력하고 확인한 다음 다음 중 하나를 선택합니다.
    • 사용자가 비밀번호를 변경할 수 없음
    • 비밀번호 만료일 없음
  8. 다음을 클릭한 후 마침을 클릭합니다.
  9. 사용자 섹션에서 생성된 사용자를 찾아 더블클릭하고 속성을 선택합니다.
  10. 속성 창에서 사용자의 이메일을 추가하고 적용을 클릭합니다.

SharePoint 사용자에게 최소 액세스 권한 할당

  1. 사이트 모음으로 이동합니다.
  2. 설정 (톱니바퀴 아이콘 메뉴)을 클릭합니다.
  3. 사이트 권한으로 이동합니다.
  4. 고급 권한 설정을 선택합니다.
  5. SiteName 방문자 그룹을 찾아 선택합니다. 이 그룹은 사이트가 설정될 때 자동으로 생성되며 기본 읽기 액세스 권한이 있습니다.
  6. 사용자에게 읽기 전용 액세스 권한을 부여하려면 SiteName 방문자 그룹에 사용자를 추가합니다.

참고: 이 액세스 권한은 읽기 권한이 있는 목록, 라이브러리, 페이지, 이벤트의 모든 권한을 상속합니다.

SharePoint에서 사이트 모음 구성

  1. 관리자 사용자 이름과 비밀번호를 사용하여 SharePoint 관리 콘솔에 로그인합니다.
  2. 중앙 관리 페이지에서 애플리케이션 관리로 이동합니다.
  3. 사이트 컬렉션 만들기를 클릭합니다.
  4. 사이트 컬렉션 만들기 페이지에서 다음을 실행합니다.
    • 제목 및 설명 필드에 필수 세부정보를 입력합니다.
    • 웹사이트 주소 섹션에 사이트의 URL 이름을 입력합니다.
  5. 기본 사이트 모음 관리자 섹션에서 다음을 수행합니다.
    • 사용자 이름 입력란 옆에 있는 찾아보기 버튼을 클릭합니다.
    • 사용자 선택 대화상자에서 관리자 사용자 이름을 입력하고 검색 아이콘을 클릭합니다.
    • 사용자를 선택하고 확인을 클릭합니다.
  6. 사이트가 생성되었습니다 페이지가 표시되고 사이트 URL이 표시됩니다.
  7. URL을 복사하여 새 탭에서 열면 사이트에 액세스할 수 있습니다.

생성된 사용자로 로그인

  1. 생성된 사용자의 사용자 인증 정보를 사용하여 SharePoint 사이트에 로그인합니다.
  2. 사용자의 액세스 및 권한을 확인합니다.

SharePoint 데이터 센터 온프레미스 커넥터 만들기

콘솔

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

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

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

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

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

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

  6. 대상 유형 드롭다운 목록에서 공개 또는 비공개를 선택합니다.

    1. 공개 대상 유형의 경우 서비스 연결 설정을 만들 필요가 없습니다. 대신 Google Cloud 콘솔의 도메인 URL 필드에서 공개 URL을 사용할 수 있습니다.

    2. 비공개 대상 유형의 경우 다음과 같이 모든 필수 정보를 입력합니다.

      1. 인스턴스에 도메인 URL이 있는 경우 다음 단계를 따르세요.
        • 서비스 연결: 서비스 연결을 입력합니다.
        • 선택사항: 기본 도메인 이름: 기본 도메인을 입력합니다.
        • 도메인 URL: 도메인 URL을 입력합니다.
        • 선택사항: 대상 포트: 대상 포트를 입력합니다.
      2. 인스턴스에 도메인 URL이 없는 경우 다음 단계를 따르세요.
        • 서비스 연결: 서비스 연결을 입력합니다.
        • 선택사항: 대상 포트: 대상 포트를 입력합니다.

  7. 계속을 클릭합니다.

  8. 선택사항: 고급 옵션: 필요한 경우 프록시 설정 및 SSL 설정을 선택하고 사용 설정합니다.

  9. 동기화할 항목에서 동기화해야 하는 모든 항목을 선택하고 계속을 클릭합니다.

  10. 데이터 커넥터의 리전을 선택하고 데이터 커넥터의 이름을 입력합니다.

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

커넥터 상태를 관리하려면 다음 단계를 따르세요.

  1. 비공개 대상 유형:

    1. 커넥터 세부정보를 제출합니다.
    2. VAIS에서 PSC에 연결 요청을 전송합니다.
    3. 커넥터로 이동하여 PSC에서 projectId를 허용 목록에 추가하라는 메시지를 확인합니다.
    4. PSC에서 연결을 허용합니다.
      1. 요청을 승인할 때까지 커넥터는 오류 상태로 유지됩니다.
      2. 승인 후에는 다음 동기화 실행 중에 커넥터가 활성 상태로 전환됩니다.
    5. PSC가 모든 연결을 수락하도록 구성된 경우 커넥터는 생성 후 자동으로 Active 상태로 이동합니다.

  2. 공개 대상 유형의 경우:

    1. 커넥터 세부정보를 제출합니다.
    2. 커넥터는 제출 후 자동으로 Active(활성) 상태로 전환됩니다.

데이터 스토어 및 처리 활동의 상태를 확인하려면 다음 단계를 따르세요.

  1. 데이터 저장소 목록에서 커넥터로 이동하고 상태가 활성으로 변경될 때까지 모니터링합니다.
  2. 커넥터 상태가 Active(활성)로 변경되면 필요한 항목을 클릭하고 선택한 모든 항목이 처리되었는지 확인합니다. 데이터 스토어 상태는 동기화가 시작되면 만들기에서 실행 중으로 전환되고, 처리가 완료되면 활성으로 변경되어 데이터 스토어가 설정되었음을 나타냅니다. 데이터 크기에 따라 처리하는 데 몇 시간이 걸릴 수 있습니다.

다음 단계

SharePoint Online 연결

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

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

시작하기 전에

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

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

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

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

    1. 인스턴스 URL. 형식은 다음과 같습니다. http://DOMAIN_OR_SERVER/[sites/]WEBSITE

    2. 제휴 인증에는 테넌트 ID와 클라이언트 ID가 필요하지만 OAuth에는 테넌트 ID, 클라이언트 ID, 클라이언트 보안 비밀번호가 필요합니다. 애플리케이션을 등록하려면 로그인 사용자 집단에 이 조직 디렉터리의 계정만을 선택한 다음 이 인증 정보를 찾습니다. 자세한 내용은 Microsoft Entra 문서의 빠른 시작: Microsoft ID 플랫폼에 애플리케이션 등록을 참고하세요.

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

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

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

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

이 메서드를 사용하여 SharePoint REST API 권한을 세분화된 방식으로 제어하여 사용자 계정의 리소스 액세스를 제한할 수 있습니다. 새 SharePoint 사용자를 만들어야 하며, 이 경우 라이선스 비용이 추가될 수 있습니다. OAuth 2.0 갱신 토큰 메서드를 사용하여 Entra 애플리케이션 등록을 설정하고 SharePoint에 대한 안전한 액세스를 사용 설정합니다.

Entra 애플리케이션 등록 구성

SharePoint에 대한 안전한 액세스를 사용 설정하려면 Entra 애플리케이션 등록을 설정하세요. 토큰 기반 액세스를 위한 제휴 사용자 인증 정보 또는 세분화된 제어를 위한 OAuth 2.0 갱신 토큰 중에서 선택합니다. 다음 단계에 따라 앱 등록을 구성하고, 권한을 부여하고, 인증을 설정합니다.

  1. 제휴 사용자 인증 정보: Google이 암호화 서명된 토큰을 사용하여 SharePoint에 안전하게 액세스할 수 있도록 제휴 사용자 인증 정보를 설정하면 실제 사용자 사용자 인수자가 필요하지 않습니다. 권한을 구성하고 액세스 권한을 부여하려면 다음 단계를 따르세요.

    1. 서비스 계정 클라이언트 ID를 가져옵니다.

      1. Google Cloud 콘솔에서 Agent Builder 페이지로 이동합니다.
      2. 탐색 메뉴에서 데이터 스토어를 클릭합니다.
      3. 데이터 스토어 만들기를 클릭합니다.
      4. 데이터 소스 선택 페이지에서 스크롤하거나 SharePoint Online을 검색하여 서드 파티 소스를 연결합니다.
      5. 항목 식별자를 기록해 둡니다.

    2. Microsoft Entra에서 앱 등록:

      1. Entra 관리자 센터로 이동합니다.

      2. 앱 등록을 만듭니다.

        • 지원되는 계정 유형: 조직 디렉터리의 계정만
        • 다른 설정은 기본값으로 두고 등록을 클릭합니다.

      3. 클라이언트 ID와 테넌트 ID를 기록합니다.

    3. 제휴 사용자 인증 정보를 추가합니다.

      1. Certificates & secrets(인증서 및 보안 비밀) > Federated credentials(제휴 사용자 인증 정보) > Add credential(사용자 인증 정보 추가)로 이동합니다.

      2. 다음 설정을 사용하세요.

        • 발급자: https://accounts.google.com
        • 제목 식별자: 메모된 제목 식별자를 사용합니다.
        • 이름: 고유한 이름을 입력합니다.

      3. 추가를 클릭하여 액세스 권한을 부여합니다.

    4. API 권한을 설정합니다.

      1. 다음 권한에 대한 관리자 동의를 추가하고 부여합니다.

        • GroupMember.Read.All (애플리케이션): 모든 그룹 멤버십을 읽습니다.
        • Sites.Read.All (애플리케이션): 모든 사이트를 읽습니다.
        • User.Read.All (애플리케이션): 모든 사용자의 전체 프로필을 읽습니다.
        • Sites.FullControl.All (애플리케이션): 모든 사이트를 완전히 관리할 수 있습니다.

      2. Sites.FullControl.All 대신 Sites.Selected를 사용하여 특정 사이트 권한을 할당합니다. Sites.Selected는 UI를 통해 직접 구성할 수 없습니다. Sites.Selected를 선택한 후 Microsoft Graph API를 호출하여 크롤링하려는 사이트의 애플리케이션에 fullcontrol 역할을 명시적으로 부여해야 합니다.

      3. 루트 사이트 URL 아래의 모든 하위 사이트를 크롤링할 수 있도록 Sites.Read.All를 부여합니다.

  2. OAuth 2.0 갱신 토큰: SharePoint 사용자의 클라이언트 비밀 및 갱신 토큰을 사용하여 OAuth 2.0 인증을 구성하여 SharePoint API 액세스를 세분화하여 제어할 수 있습니다. 앱 등록을 설정하고, 클라이언트 암호를 추가하고, API 권한을 할당하려면 다음 단계를 따르세요.

    1. 앱 등록을 만듭니다.

      1. Entra 관리자 센터로 이동합니다.

      2. 앱 등록을 만듭니다.

        • 지원되는 계정 유형: 조직 디렉터리의 계정만
        • 리디렉션 URI: https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html.

      3. 클라이언트 ID와 테넌트 ID를 기록합니다.

    2. 클라이언트 보안 비밀번호 추가:

      1. 인증서 및 보안 비밀 > 새 클라이언트 보안 비밀번호로 이동합니다.

      2. 보안 비밀 문자열을 기록합니다.

    3. API 권한을 설정합니다.

      1. 다음 권한에 대한 관리자 동의를 추가하고 부여합니다.

        • GroupMember.Read.All: 모든 그룹 멤버십을 읽습니다.
        • Sites.FullControl.All: 모든 사이트 컬렉션을 완전히 제어할 수 있습니다.
        • User.Read.All: 모든 사용자의 전체 프로필을 읽습니다.
        • AllSites.FullControl: 모든 사이트를 완전히 제어할 수 있습니다.

      2. 특정 사이트에 대한 액세스가 제한된 전용 사용자 계정을 사용합니다.

      3. 계정에 선택한 사이트에 대한 소유자 액세스 권한이 있는지 확인합니다.

SharePoint Online 커넥터 만들기

콘솔

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

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

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

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

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

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

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

  6. SharePoint 사이트 URL을 입력합니다.

    • 단일 사이트의 경우: https://<domain_name>.sharepoint.com/sites/<site_name>
    • 모든 1차 사이트: https://<domain_name>.sharepoint.com.

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

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

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

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

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

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

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

검색엔진 테스트

검색엔진을 구성한 후 기능을 테스트합니다. 이렇게 하면 사용자 액세스에 따라 정확한 결과를 반환할 수 있습니다.

  1. 웹 앱 사용 설정:

    1. 앱 통합 구성으로 이동하여 웹 앱 사용 설정으로 전환합니다.

  2. 웹 앱 테스트:

    1. 웹 앱 링크 옆에 있는 열기를 클릭하고 인력 풀의 사용자로 로그인합니다.

    2. 검색 결과가 로그인한 사용자가 액세스할 수 있는 항목으로 제한되는지 확인합니다.

직원 풀 구성

직원 풀을 사용하면 Google Cloud 콘솔 내에서 Azure 또는 Okta와 같은 외부 ID 공급업체의 사용자를 관리하고 인증할 수 있습니다. 직원 풀을 구성하고 원활한 사용자 액세스를 위해 웹 앱을 사용 설정하려면 다음 단계를 따르세요.

  1. 적절한 설정 매뉴얼에 따라 Google Cloud 에서 조직 수준으로 직원 풀을 만듭니다.

    1. Azure OIDC 설정
    2. Azure SAML 설정
    3. Okta 및 OIDC 설정
    4. Okta 및 SAML 설정

  2. 앱을 만드는 리전의 Agent Builder > Settings에서 Workforce Pool을 구성합니다.

다음 단계

Slack 연결

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

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

시작하기 전에

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

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

  2. 워크스페이스 소유자에게 문의하여 워크스페이스에 새 앱을 설치할 권한을 요청하세요.

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

    1. 작업공간 ID: Slack 문서의 데이터 스토어의 Slack 소스 지정에 나온 안내에 따라 워크스페이스 ID를 가져옵니다.

    2. 액세스 토큰: 클라이언트 앱을 만들고 필요한 범위를 정의합니다. 자세한 내용은 Slack 문서의 빠른 시작 및 Slack API 토큰을 빠르게 가져와 사용하는 방법을 참고하세요.

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

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

Slack 앱 구성

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

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

    1. Slack API 앱에 로그인합니다.
    2. 새 앱 만들기를 클릭합니다.
    3. 처음부터를 선택합니다.
    4. 앱 이름을 입력하고 통합할 워크스페이스를 선택합니다.
    5. 앱 만들기를 클릭합니다.
    6. OAuth 및 권한을 클릭합니다.
    7. Bot token scopes(봇 토큰 범위)에서 다음과 같은 필수 범위를 추가합니다.

    기본적으로 봇은 #general 및 #random 채널에서 읽습니다.

    1. 크롤링을 사용 설정하려면 다음 단계를 따르세요.

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

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

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

  2. 사용자 토큰을 생성하여 먼저 채널에 가입하지 않고도 모든 공개 채널에 액세스합니다. 사용자에게 액세스 권한이 없는 경우 사용자 토큰은 비공개 채널, 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. 수집 상태를 확인하려면 데이터 스토어 페이지로 이동하여 데이터 스토어 이름을 클릭한 후 데이터 페이지에서 세부정보를 확인합니다. 데이터 동기화를 시작하면 커넥터 상태가 만들기에서 실행 중으로 변경됩니다. 수집이 완료되면 상태가 활성으로 변경되어 데이터 소스 연결이 설정되고 다음으로 예약된 동기화를 기다리고 있음을 나타냅니다.

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

다음 단계

Trello 연결

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

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

시작하기 전에

커넥터를 설정하기 전에 다음 단계를 완료해야 합니다.

  1. Trello 관리자 액세스 권한이 있는지 확인합니다. Trello 관리자가 다음 섹션에서 API 키와 토큰을 생성해야 합니다.
  2. Trello를 사용하려면 프로젝트가 허용 목록에 추가되어 있는지 확인합니다.
  3. 데이터 소스의 액세스 제어를 설정합니다. 액세스 제어 설정에 관한 자세한 내용은 데이터 소스 액세스 제어 사용을 참고하세요.

Trello 관리자가 다음 단계를 수행해야 합니다.

  1. Trello에서 API 키를 생성하려면 다음 단계를 따르세요.

    1. Trello에서 제공된 테스트 사용자 인증 정보를 사용하여 Trello 인스턴스에 로그인합니다.

    2. Trello 강화 관리자 페이지에서 강화 관리자 액세스로 이동합니다.

    3. 새로 만들기를 클릭하여 새 부가기능을 만듭니다.

    4. 다음 필수 세부정보를 입력합니다.

    5. 다음을 클릭하여 계속 진행한 후 API 키를 생성합니다. API 키와 보안 비밀을 복사합니다.

  2. Trello에서 API 토큰을 생성하려면 다음 단계를 따르세요.

    1. 오른쪽의 Generate token(토큰 생성) 링크를 클릭하여 API 토큰을 생성합니다.

      1. 허용을 클릭하여 API 토큰에 대한 액세스 권한을 부여합니다.
      2. 모든 필수 항목에 범위 내에서 올바른 권한이 있는지 확인합니다.

    2. 생성된 API 토큰을 복사합니다. Vertex AI Search의 Trello 커넥터에 이 토큰을 사용합니다.

Trello API에 대한 자세한 내용은 API 소개를 참고하세요.

Trello 커넥터 만들기

콘솔

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

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

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

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

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

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

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

  6. 선택사항: HTTP 트래픽을 라우팅하려면 대상 추가를 클릭하고 프록시 서버의 호스트 이름 또는 IP 주소를 입력합니다. 그런 다음 계속을 클릭합니다.

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

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

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

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

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

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

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

다음 단계

WordPress 연결

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

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

시작하기 전에

연결을 설정하기 전에 다음이 있는지 확인합니다.

  • 사용자 이름 및 비밀번호: WordPress 관리자에게서 사용자 인증 정보를 받습니다.
  • 사이트 URL: 데이터 스토어를 만들 때 이 URL을 사용합니다.

WordPress 사용자 만들기

WordPress 사용자를 만들려면 관리자에게 사용자 이름과 비밀번호를 받습니다. 관리자가 로그인하여 다음 단계에 따라 WordPress 인스턴스에 새 사용자를 만들어야 합니다.

  1. 관리자로 로그인합니다.

    1. 호스팅 플랫폼으로 이동하여 관리자 사용자 인증 정보로 로그인하여 WordPress 웹사이트에 액세스합니다.
    2. 웹사이트 아이콘을 클릭합니다.
    3. 사이트의 WordPress 관리자를 클릭합니다.

  2. 새 사용자를 만듭니다.

    1. WordPress 관리자 페이지에서 사용자 탭으로 이동합니다.
    2. 새로 추가를 클릭합니다.
    3. 다음을 포함한 모든 필수 세부정보를 입력합니다.
      • 사용자 이름
      • 이메일 주소
      • 선택사항: 이름 및 성
      • 역할
      • 비밀번호 (메시지가 표시되는 경우)
    4. Add new user(새 사용자 추가)를 클릭하여 변경사항을 저장합니다.

WordPress 커넥터 만들기

콘솔

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

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

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

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

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

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

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

  6. URL 입력란에 WordPress 사이트 URL을 입력하고 계속을 클릭합니다.

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

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

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

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

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

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

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

다음 단계

Workday 연결

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

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

시작하기 전에

Workday 커넥터를 만들기 전에 다음을 확인하세요.

  1. Workday 관리자는 Vertex AI Search와 통합하기 위해 다음을 생성하거나 가져와야 합니다.

    1. 클라이언트 ID입니다. Workday의 API 클라이언트 보기 페이지에서 가져옵니다.
    2. 클라이언트 보안 비밀번호 Workday의 API 클라이언트 보기 페이지에서 가져옵니다.
    3. 갱신 토큰 Workday의 API 클라이언트 보기 페이지에서 가져옵니다.
    4. 선택사항: 프록시 서버 HTTP 트래픽을 라우팅할 프록시의 호스트 이름 또는 IP 주소입니다.
    5. 선택사항: 기본 URL Workday 연결의 기본 URL입니다.
    6. 선택사항: API URL SOAP 요청을 보내는 데 사용할 API 엔드포인트의 전체 URL입니다. 예를 들면 다음과 같습니다. https://<var>host</var>.workday.com/ccx/service/<var>tenant</var>/<var>service</var>
    7. Workday 테넌트 계정의 테넌트입니다. 예를 들면 abc_cms1입니다. Workday 인스턴스 구성 세부정보에서 테넌트 이름을 가져올 수 있습니다.

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

Workday 커넥터 만들기

콘솔

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

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

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

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

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

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

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

  6. 선택사항: Workday 대상 정보 입력 후 계속을 클릭합니다.

  7. Workday 테넌트를 입력하고 계속을 클릭합니다.

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

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

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

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

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

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

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

다음 단계

Zendesk 연결

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

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

시작하기 전에

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

  1. 이 커넥터는 서드 파티 커넥터 허용 목록 외에도 프로젝트를 추가 허용 목록에 추가해야 합니다. 이 허용 목록에 추가하려면 Vertex AI Search 계정팀에 문의하세요.

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

  3. Zendesk 관리자는 Vertex AI Search와 통합하기 위해 다음을 생성하거나 가져와야 합니다.

    1. 액세스 토큰. Zendesk 인스턴스의 API 토큰입니다.
    2. 인스턴스 URI

Zendesk 커넥터 만들기

콘솔

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

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

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

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

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

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

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

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

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

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

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

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

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

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

다음 단계