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. O repositório de dados pesquisa seus registros do Salesforce em tempo real e permite que os usuários finais interajam com eles usando linguagem natural.

Antes de começar

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

1. 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 console Google Cloud , acesse a página IAM.

      Acessar IAM

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

2. Peça ao administrador do Salesforce para ativar o servidor MCP SObject All na organização do Salesforce que você está conectando e configurar o método de autenticação escolhido:

   • OAuth 2.0 (gerenciado pelo Google) (padrão): instale o pacote gerenciado Gemini Enterprise - Salesforce Connector do Salesforce AppExchange nessa organização. Não é necessário ter um ID do cliente ou uma chave secreta do cliente.
   • OAuth 2.0 (Traga seu próprio app): crie um app cliente externo nessa organização e receba o token do cliente (ID do cliente) e a chave secreta do cliente (chave secreta do cliente).

   Até que o app OAuth seja configurado, os usuários não poderão autorizar o conector. Até que o servidor MCP SObject All esteja ativo, nenhuma ação estará disponível. Consulte Configuração do Salesforce.

3. Anote o URL do Meu Domínio da sua organização, por exemplo, https://example.my.salesforce.com. Insira-o como o URI da instância. Para uma organização de sandbox, use o Meu domínio do sandbox, por exemplo, https://example--sandbox.sandbox.my.salesforce.com.

Encontrar o URL do Meu Domínio

Para encontrar o URL do Meu Domínio e inseri-lo como o URI da instância:

1. No Salesforce, acesse Configuração.
2. Na caixa Pesquisa rápida, pesquise e selecione Meu domínio.
3. Em URL atual do meu domínio, copie o URL, por exemplo, https://example.my.salesforce.com.

Para uma organização de sandbox, faça isso no sandbox. O URL do Meu domínio é semelhante a https://example--sandbox.sandbox.my.salesforce.com.

Criar o repositório de dados do Salesforce

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

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

   Gemini Enterprise

2. Selecionar ou criar um projeto do 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 Origem, pesquise Salesforce e clique em Selecionar.

6. Na seção Dados:

   1. Em Configurações de autenticação, em Selecione o método de autenticação, escolha uma das seguintes opções:

      • OAuth 2.0 (gerenciado pelo Google) (padrão):
        1. Em URI da instância, insira o URL do Meu Domínio do seu site do Salesforce, por exemplo, https://example.my.salesforce.com. Para uma organização de sandbox, insira o Meu Domínio do sandbox, por exemplo, https://example--sandbox.sandbox.my.salesforce.com.
      • OAuth 2.0 (Traga seu próprio app):
        1. Em URI da instância, insira o URL do Meu Domínio do seu site do Salesforce, por exemplo, https://example.my.salesforce.com. Para uma organização de sandbox, insira o Meu Domínio do sandbox, por exemplo, https://example--sandbox.sandbox.my.salesforce.com.
        2. Em ID do cliente, insira o token do cliente do seu app de cliente externo do Salesforce.
        3. Em Chave secreta do cliente, insira a chave secreta do consumidor do seu app cliente externo do Salesforce.
        4. Clique em Verificar autenticação e conclua o login do Salesforce para verificar suas credenciais do OAuth.

   2. Em Opções avançadas, se você estiver conectando uma organização de sandbox, selecione Usar sandbox. O Salesforce vai exibir ações da sua organização de sandbox.

   3. Clique em Continuar.

   4. Na seção Entidades para pesquisar, selecione as entidades que você quer que o Gemini Enterprise pesquise. Para o Salesforce, selecione Salesforce MCP.

7. Clique em Continuar.

8. Opcional: na seção Ações, selecione as ações de criação, atualização e exclusão que você quer ativar para os usuários ou deixe-as desmarcadas para manter o conector como somente leitura (as ações somente leitura são ativadas por padrão). Também é possível ativar ou desativar essas ações depois de criar o repositório de dados. Consulte Ativar ações.

9. Clique em Continuar.

10. 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.

11. Clique em Continuar.

12. 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.

13. Clique em Criar. O Gemini Enterprise 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 loja para conferir o status. Depois que o estado do repositório de dados mudar de Criando para Ativo, o repositório de dados do Salesforce estará pronto para uso.

Depois de criar o repositório de dados, conecte-o a um app atual ou crie um novo app e conecte-o ao novo app. Em seguida, autorize o Gemini Enterprise a acessar o Salesforce antes de executar qualquer consulta.

Observação: a etapa Autorizar envia cada usuário para a página de login do Salesforce da sua organização para conceder ao app OAuth os escopos mcp_api e refresh_token. Essa etapa falhará se o pacote gerenciado do Gemini Enterprise (para OAuth 2.0 (gerenciado pelo Google)) ou seu app OAuth personalizado (para OAuth 2.0 (Traga seu próprio app)) não estiver configurado nessa organização ou se o perfil do usuário não tiver acesso ao app. A configuração de IP estático por repositório de dados não é compatível. A política de IP de login para autenticação e chamadas de atualização de token é configurada no app no Salesforce, e as chamadas de dados são autorizadas usando o token de acesso válido do usuário. Consulte Definir a política de IP de login para o app.

Ativar ações

Quando você cria um repositório de dados do Salesforce, as ações dele são pré-preenchidas no repositório de dados. As ações somente leitura (Consulta Soql, Localizar, Receber esquema de objeto, Receber registros relacionados, Listar registros Sobject recentes e Receber informações do usuário) são ativadas por padrão e estão sempre disponíveis. As ações que criam, atualizam ou excluem registros (Criar registro de Sobject, Atualizar registro de Sobject, Atualizar registro relacionado, Excluir registro de Sobject e Excluir registro relacionado) são desativadas por padrão.

Se você não tiver ativado as ações de criação, atualização ou exclusão durante a criação do repositório de dados, siga estas etapas para ativá-las a qualquer momento:

1. No console do Google Cloud , acesse o repositório de dados do Salesforce.

2. Selecione a guia Ações.

3. Selecione as ações que você quer ativar (Criar registro de Sobject, Atualizar registro de Sobject, Atualizar registro relacionado, Excluir registro de Sobject ou Excluir registro relacionado). Para manter o conector como somente leitura, não selecione essas ações.

4. Clique em Ativar ações.

Para ver a lista de ações, consulte Ações compatíveis.

Tratamento de dados e execução de consultas

Esta seção descreve como o Gemini Enterprise gerencia sua consulta e as implicações de privacidade do uso do repositório de dados federado.

Execução da consulta

Depois de autorizar o Salesforce e enviar uma consulta de pesquisa para o Gemini Enterprise:

• O Gemini Enterprise envia sua consulta de pesquisa diretamente para o servidor MCP do Salesforce.
• O Gemini Enterprise combina os resultados com os de outras fontes de dados conectadas e mostra um resultado da pesquisa abrangente.

Processamento de dados

Ao usar a pesquisa federada de terceiros, as seguintes regras de tratamento de dados são aplicadas:

• Sua string de consulta é enviada para o back-end de pesquisa de terceiros (servidor MCP do Salesforce).
• Esses terceiros podem associar consultas à sua identidade.
• Se várias fontes de dados de pesquisa federada estiverem ativadas, a consulta poderá ser enviada a todas elas.
• Depois que os dados chegam ao sistema de terceiros, eles são regidos pelos Termos de Serviço e pelas Políticas de Privacidade desse sistema.

Observação : para melhorar a acurácia, um LLM pode reescrever sua consulta antes de enviá-la ao Salesforce. Essa consulta reescrita pode incorporar informações do histórico de consultas da sua sessão. Como resultado, partes do seu histórico de consultas também podem ser incluídas na consulta enviada ao servidor MCP do Salesforce.

A seguir

• Para fornecer uma interface do usuário para consultar seus dados do Salesforce, crie um app e conecte-o ao repositório de dados do Salesforce.
• Para ver como os resultados da pesquisa aparecem depois que o app é configurado, consulte Receber resultados da pesquisa.
• Para ativar alertas para o repositório de dados, consulte Configurar alertas para repositórios de dados de terceiros.