Salesforce 데이터 스토어 설정

이 페이지에서는 데이터 스토어를 만들고 Salesforce를 Gemini Enterprise에 연결하는 방법을 설명합니다. 데이터 스토어는 Salesforce 레코드를 실시간으로 검색하고 최종 사용자가 자연어를 사용하여 레코드에 대해 조치를 취할 수 있도록 합니다.

시작하기 전에

Salesforce 연결을 설정하기 전에 다음 단계를 따르세요.

  1. 검색 엔진 편집자 역할(roles/discoveryengine.editor)을 부여합니다. 이 역할은 사용자가 데이터 스토어를 만드는 데 필요합니다. 이 역할을 부여하려면 다음 단계를 따르세요.

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

      IAM으로 이동

    2. 사용자 계정을 찾아 수정 수정을 클릭합니다.
    3. 사용자에게 Discovery Engine Editor 역할을 부여합니다. 자세한 내용은 IAM 역할 및 권한을 참조하세요.

  2. Salesforce 관리자에게 연결 중인 Salesforce 조직에서 SObject All MCP 서버를 사용 설정하고 선택한 인증 방법을 구성하도록 요청합니다.

    • OAuth 2.0 (Google 관리) (기본값): Salesforce AppExchange에서 해당 조직에 Gemini Enterprise - Salesforce 커넥터 관리형 패키지를 설치합니다. 클라이언트 ID 또는 클라이언트 보안 비밀번호가 필요하지 않습니다.
    • OAuth 2.0 (자체 앱 사용): 해당 조직에서 외부 클라이언트 앱을 만들고 고객 키 (클라이언트 ID) 및 고객 보안 비밀번호 (클라이언트 보안 비밀번호)를 가져옵니다.

    OAuth 앱이 구성될 때까지 사용자는 커넥터를 승인할 수 없습니다. SObject All MCP 서버가 활성화될 때까지는 어떤 작업도 수행할 수 없습니다. Salesforce 구성을 참조하세요.

  3. 조직의 내 도메인 URL을 기록합니다(예: https://example.my.salesforce.com). 이 값을 인스턴스 URI로 입력합니다. 샌드박스 조직의 경우 샌드박스 내 도메인(예: https://example--sandbox.sandbox.my.salesforce.com)을 사용합니다.

내 도메인 URL 찾기

인스턴스 URI로 입력할 내 도메인 URL을 찾으려면 다음 안내를 따르세요.

  1. Salesforce에서 설정으로 이동합니다.
  2. 빠른 찾기 상자에서 내 도메인을 검색하고 선택합니다.
  3. 현재 내 도메인 URL에서 URL(예: https://example.my.salesforce.com)을 복사합니다.

샌드박스 조직의 경우 샌드박스에서 이 작업을 수행합니다. 내 도메인 URL은 https://example--sandbox.sandbox.my.salesforce.com와 같습니다.

Salesforce 데이터 스토어 만들기

Salesforce 데이터 스토어를 만들려면 다음 단계를 따르세요.

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

    Gemini Enterprise

  2. Google Cloud 프로젝트를 선택하거나 만듭니다.

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

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

  5. 소스 섹션에서 Salesforce를 검색하고 선택을 클릭합니다.

  6. 데이터 섹션에서 다음을 수행합니다.

    1. 인증 설정의 인증 방법 선택에서 다음 옵션 중 하나를 선택합니다.

      • OAuth 2.0 (Google 관리) (기본값):
        1. 인스턴스 URI에 Salesforce 사이트의 내 도메인 URL을 입력합니다(예: https://example.my.salesforce.com). 샌드박스 조직의 경우 샌드박스 내 도메인(예: https://example--sandbox.sandbox.my.salesforce.com)을 입력합니다.
      • OAuth 2.0 (자체 앱 사용):
        1. 인스턴스 URI에 Salesforce 사이트의 내 도메인 URL을 입력합니다(예: https://example.my.salesforce.com). 샌드박스 조직의 경우 샌드박스 내 도메인(예: https://example--sandbox.sandbox.my.salesforce.com)을 입력합니다.
        2. 클라이언트 ID에 Salesforce 외부 클라이언트 앱의 고객 키를 입력합니다.
        3. 클라이언트 보안 비밀번호에 Salesforce 외부 클라이언트 앱의 고객 보안 비밀번호를 입력합니다.
        4. 인증 확인을 클릭하고 Salesforce 로그인을 완료하여 OAuth 사용자 인증 정보를 확인합니다.

    2. 고급 옵션에서 샌드박스 조직을 연결하는 경우 샌드박스 사용을 선택합니다. 그러면 Salesforce가 샌드박스 조직에서 작업을 제공합니다.

    3. 계속을 클릭합니다.

    4. 검색할 항목 섹션에서 Gemini Enterprise가 검색할 항목을 선택합니다. Salesforce의 경우 Salesforce MCP를 선택합니다.

  7. 계속을 클릭합니다.

  8. 선택사항: 작업 섹션에서 사용자에 대해 사용 설정할 만들기, 업데이트, 삭제 작업을 선택하거나 선택하지 않은 상태로 두어 커넥터를 읽기 전용으로 유지합니다 (읽기 전용 작업은 기본적으로 사용 설정됨). 데이터 스토어를 만든 후에도 이러한 작업을 사용 설정하거나 중지할 수 있습니다. 작업 사용 설정을 참조하세요.

  9. 계속을 클릭합니다.

  10. 구성 섹션에서 다음을 수행합니다.

    1. 멀티 리전 목록에서 데이터 커넥터의 위치를 선택합니다.
    2. 데이터 커넥터 이름 필드에 커넥터 이름을 입력합니다.
    3. us 또는 eu를 위치로 선택한 경우 암호화 설정을 구성합니다.
      • 선택사항: 단일 리전 키를 구성하지 않은 경우 설정 페이지로 이동을 클릭하여 구성합니다. 자세한 내용은 서드 파티 커넥터용 단일 리전 키 등록을 참조하세요.
      • Google관리 암호화 키 또는 Cloud KMS 키를 선택합니다.
      • Cloud KMS 키를 선택한 경우 다음 단계를 따르세요.
        • 키 관리 유형 목록에서 적절한 유형을 선택합니다.
        • Cloud KMS 키 목록에서 키를 선택합니다.
      자세한 내용은 고객 관리 암호화 키를 참조하세요.

  11. 계속을 클릭합니다.

  12. 결제 섹션에서 일반 가격 또는 구성 가능한 가격을 선택합니다. 자세한 내용은 프로젝트의 결제 상태 확인 및 라이선스를 참조하세요.

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

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

데이터 스토어를 만든 후 방금 만든 데이터 스토어를 기존 앱에 연결하거나 새 앱을 만들고 새 앱에 연결한 다음 쿼리를 실행하기 전에 Gemini Enterprise가 Salesforce에 액세스하도록 승인합니다.

작업 사용 설정

Salesforce 데이터 스토어를 만들면 해당 작업이 데이터 스토어에 자동 입력됩니다. 읽기 전용 작업 (Soql 쿼리, 찾기, 객체 스키마 가져오기, 관련 레코드 가져오기, 최근 Sobject 레코드 나열, 사용자 정보 가져오기)은 기본적으로 사용 설정되며 항상 사용할 수 있습니다. 레코드를 만들거나 업데이트하거나 삭제하는 작업 (Sobject 레코드 만들기, Sobject 레코드 업데이트, 관련 레코드 업데이트, Sobject 레코드 삭제, 관련 레코드 삭제)은 기본적으로 사용 중지됩니다.

데이터 스토어를 만드는 동안 만들기, 업데이트 또는 삭제 작업을 사용 설정하지 않은 경우 다음 단계에 따라 언제든지 사용 설정할 수 있습니다.

  1. Google Cloud 콘솔에서 Salesforce 데이터 스토어로 이동합니다.

  2. 작업 탭을 선택합니다.

  3. 사용 설정할 작업 (Sobject 레코드 만들기, Sobject 레코드 업데이트, 관련 레코드 업데이트, Sobject 레코드 삭제 또는 관련 레코드 삭제)을 선택합니다. 커넥터를 읽기 전용으로 유지하려면 이러한 작업을 선택하지 않은 상태로 둡니다.

  4. 작업 사용 설정을 클릭합니다.

작업 목록은 지원되는 작업을 참조하세요.

데이터 처리 및 쿼리 실행

이 섹션에서는 Gemini Enterprise가 쿼리를 관리하는 방법과 제휴 데이터 스토어 사용의 개인 정보 보호 영향을 설명합니다.

쿼리 실행

Salesforce를 승인하고 Gemini Enterprise에 검색어를 전송하면 다음과 같은 결과가 표시됩니다.

  • Gemini Enterprise는 검색어를 Salesforce MCP 서버로 직접 전송합니다.
  • Gemini Enterprise는 결과를 연결된 다른 데이터 소스의 결과와 혼합하여 종합적인 검색 결과를 표시합니다.

데이터 처리

서드 파티 제휴 검색을 사용할 때는 다음 데이터 처리 규칙이 적용됩니다.

  • 쿼리 문자열이 서드 파티 검색 백엔드(Salesforce MCP 서버)로 전송됩니다.
  • 이러한 서드 파티는 쿼리를 사용자의 ID와 연결할 수 있습니다.
  • 여러 제휴 검색 데이터 소스가 사용 설정된 경우 쿼리가 모든 데이터 소스로 전송될 수 있습니다.
  • 데이터가 서드 파티 시스템에 도달하면 해당 시스템의 서비스 약관 및 개인정보처리방침이 적용됩니다.

다음 단계