Configurar um repositório de dados do Salesforce

Nesta página, descrevemos como criar um repositório de dados e conectar o Salesforce ao Gemini Enterprise.

Antes de começar

Antes de configurar a conexão, faça o seguinte:

  • Conceda o papel de editor do Discovery Engine (roles/discoveryengine.editor). Esse papel é necessário para que o usuário crie o repositório de dados. Para conceder esse papel:

    1. No Google Cloud console, acesse a página IAM.

      Acessar IAM

    2. Localize a conta de usuário e clique em editar Editar.
    3. Conceda o papel Discovery Engine Editor ao usuário. Para mais informações, consulte Papéis e permissões do IAM.

  • Configure sua conta do Salesforce e receba credenciais de autenticação.

Criar um repositório de dados federado do Salesforce

Para criar um repositório de dados do Salesforce, siga estas etapas:

  1. No Google Cloud console, acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. Selecionar ou criar um projeto Google Cloud

  3. No menu de navegação, selecione Repositório de dados.

  4. Clique em Criar repositório de dados.

  5. Na seção Fonte, pesquise Salesforce e clique em Selecionar.

  6. Na seção Dados:

    1. Na seção Configurações de autenticação, configure a autenticação com base no modo de conexão escolhido. Para mais informações sobre como receber credenciais de autenticação, consulte Configuração do Salesforce.

      • URL da instância: o URL de base da sua instância do Salesforce.
      • ID do cliente: o ID do cliente OAuth do seu aplicativo.
      • Chave secreta do cliente: a chave secreta do cliente OAuth do seu aplicativo.
      • Clique em Fazer login e conclua o processo de login do Salesforce.
    2. Clique em Continuar.

    3. Na seção Opções avançadas, se você quiser usar a instância do sandbox do Salesforce, marque a caixa de seleção Usar o sandbox.

    4. Clique em Continuar.

    5. Na seção Entidades para pesquisar, selecione pelo menos uma entidade.

  7. Clique em Continuar.

  8. Se você selecionou Pesquisa federada, navegue até Ações e selecione as ações necessárias para ativar o repositório de dados na lista Selecionar ações do Salesforce para ativar.

    Para conferir e gerenciar a lista de ações, consulte Conferir e gerenciar ações.

    1. Clique em Continuar.
  9. Na seção Configuração:

    1. Na lista Multirregional, selecione o local do conector de dados.
    2. No campo Nome do conector de dados, insira um nome para o conector.
    3. Se você selecionou us ou eu como o local, configure as Configurações de criptografia:
      • Opcional: se você não tiver configurado chaves de região única, clique em Acessar a página de configurações para fazer isso. Para mais informações, consulte Registrar uma chave de região única para conectores de terceiros.
      • Selecione Chave de criptografia gerenciada peloGoogle ou Chave do Cloud KMS.
      • Se você selecionou Chave do Cloud KMS:
        • Na lista Tipo de gerenciamento de chaves, selecione o tipo adequado.
        • Na lista Chave do Cloud KMS, selecione a chave.
      Para mais informações, consulte Chaves de criptografia gerenciadas pelo cliente.

  10. Clique em Continuar.

  11. Na seção Faturamento, selecione Preços gerais ou Preços configuráveis. Para mais informações, consulte Verificar o status de faturamento dos seus projetos e Licenças.

  12. Clique em Continuar.

  13. Clique em Criar. O Gemini Enterpriserise cria e exibe os repositórios de dados na página Repositórios de dados.

Na página Repositórios de dados, clique no nome da repositório de dados para conferir o status. Depois que o estado do repositório de dados mudar de Criando para Ativo, o conector do Salesforce estará pronto para uso.

Depois de criar o repositório de dados, crie um app, conecte-o ao repositório de dados do Salesforce e autorize o aplicativo a acessar o Salesforce antes de executar qualquer consulta.

Para mais informações, consulte A seguir.

Criar um repositório de dados de ingestão de dados do Salesforce

Se você quiser criar um repositório de dados de ingestão de dados, siga estas etapas. Caso contrário, pule esta seção.

Para usar o console e sincronizar dados do Salesforce com o Gemini Enterprise, siga estas etapas:

  1. No console, acesse a página Gemini Enterprise.

    Acesse o console

  2. No menu de navegação, selecione Repositório de dados.
  3. Clique em Criar repositório de dados.
  4. Na página Selecionar uma fonte de dados, role a tela ou pesquise Salesforce V2 para conectar sua fonte de terceiros.
  5. Na seção Autenticações, selecione o método de autenticação e insira as informações necessárias. Para mais informações sobre como receber credenciais de autenticação, consulte Configurar o Salesforce para o repositório de dados de ingestão de dados.
  6. Na seção Destinos, selecione Público ou Particular.
    1. Para o tipo de destino Público, não é necessário criar a configuração para o anexo de serviço. No campo URL de login, insira o URL de login do servidor do Salesforce.
    2. Para o tipo de destino Particular, insira todas as informações necessárias:
      1. Anexo de serviço: insira seu anexo de serviço.
      2. Nome de domínio base: digite seu domínio base.
      3. URL de login: digite o URL de login do servidor do Salesforce.
  7. Clique em Continuar.
  8. Na seção Entidades a serem sincronizadas, faça o seguinte:
    1. Selecione as entidades que você quer sincronizar.
      • Opcional: Nome do campo de URL: insira um nome de coluna para substituir o URL da entidade padrão por um URL personalizado da tabela do Salesforce.
    2. Opcional: para adicionar entidades personalizadas, clique em Adicionar entidades manualmente. O nome da entidade personalizada precisa estar no seguinte formato: <var>custom_object_name</var>__c.
    3. Selecione a Frequência de sincronização para Sincronização completa e a Frequência de sincronização incremental para Sincronização incremental de dados. Para mais informações, consulte Programações de sincronização.
  9. Clique em Continuar.
  10. Na seção Configurar seu conector de dados :
    1. Selecione uma região para o repositório de dados.
    2. Insira um nome para o repositório de dados.
    3. Clique em Criar. O Gemini Enterpriserise cria e exibe os repositórios de dados na página Repositórios de dados.
  11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório de dados. O estado do conector muda de Criação para Execução quando ele começa a sincronizar dados.

Para mais informações, consulte A seguir.

A seguir