Configura un almacén de datos de Salesforce

En esta página, se describe cómo crear un almacén de datos y conectar Salesforce a Gemini Enterprise. El almacén de datos busca en tus registros de Salesforce en tiempo real y permite que los usuarios finales actúen sobre ellos con lenguaje natural.

Antes de comenzar

Antes de configurar tu conexión de Salesforce, haz lo siguiente:

1. Otorga el rol de Editor de Discovery Engine (roles/discoveryengine.editor). Este rol es necesario para que el usuario cree el almacén de datos. Para otorgar este rol, haz lo siguiente:

   1. En la consola de Google Cloud , ve a la página IAM.

      Ir a IAM

   2. Ubica la cuenta de usuario y haz clic en editar Editar.
   3. Otorga el rol Discovery Engine Editor al usuario. Para obtener más información, consulta Roles y permisos de IAM.

2. Pídele a tu administrador de Salesforce que habilite el servidor de MCP SObject All en la organización de Salesforce que estás conectando y que configure el método de autenticación que elijas:

   • OAuth 2.0 (administrado por Google) (predeterminado): Instala el paquete administrado Gemini Enterprise - Salesforce Connector de Salesforce AppExchange en esa organización. No necesitas un ID de cliente ni un secreto del cliente.
   • OAuth 2.0 (Bring Your Own App): Crea una app cliente externa en esa organización y obtén su clave de consumidor (ID de cliente) y su secreto de consumidor (Secreto del cliente).

   Hasta que se configure la app de OAuth, los usuarios no podrán autorizar el conector. Hasta que el servidor de MCP SObject All esté activo, no habrá acciones disponibles. Consulta Configuración de Salesforce.

3. Anota la URL de Mi dominio de tu organización, por ejemplo, https://example.my.salesforce.com. Ingresa este valor como el URI de la instancia. Para una organización de zona de pruebas, usa Mi dominio de la zona de pruebas, por ejemplo, https://example--sandbox.sandbox.my.salesforce.com.

Cómo encontrar la URL de Mi dominio

Para encontrar la URL de Mi dominio que debes ingresar como el URI de la instancia, sigue estos pasos:

1. En Salesforce, ve a Configuración.
2. En el cuadro Búsqueda rápida, busca y selecciona Mi dominio.
3. En URL actual de Mi dominio, copia la URL, por ejemplo, https://example.my.salesforce.com.

En el caso de una organización de zona de pruebas, hazlo en la zona de pruebas. La URL de Mi dominio se ve como https://example--sandbox.sandbox.my.salesforce.com.

Crea el almacén de datos de Salesforce

Para crear el almacén de datos de Salesforce, sigue estos pasos:

1. En la consola de Google Cloud , ve a la página Gemini Enterprise.

   Gemini Enterprise

2. Selecciona o crea un proyecto de Google Cloud .

3. En el menú de navegación, haz clic en Almacenes de datos.

4. Haz clic en Crear almacén de datos.

5. En la sección Fuente, busca Salesforce y haz clic en Seleccionar.

6. En la sección Datos, haz lo siguiente:

   1. En Configuración de autenticación, en Selecciona tu método de autenticación, elige una de las siguientes opciones:

      • OAuth 2.0 (administrado por Google) (predeterminado):
        1. En URI de la instancia, ingresa la URL de Mi dominio de tu sitio de Salesforce, por ejemplo, https://example.my.salesforce.com. Para una organización de zona de pruebas, ingresa tu Mi dominio de zona de pruebas, por ejemplo, https://example--sandbox.sandbox.my.salesforce.com.
      • OAuth 2.0 (Trae tu propia app):
        1. En URI de la instancia, ingresa la URL de Mi dominio de tu sitio de Salesforce, por ejemplo, https://example.my.salesforce.com. Para una organización de zona de pruebas, ingresa tu Mi dominio de zona de pruebas, por ejemplo, https://example--sandbox.sandbox.my.salesforce.com.
        2. En ID de cliente, ingresa la clave de consumidor de tu app cliente externa de Salesforce.
        3. En Secreto del cliente, ingresa el secreto del consumidor de tu app cliente externa de Salesforce.
        4. Haz clic en Verificar autenticación y completa el acceso a Salesforce para verificar tus credenciales de OAuth.

   2. En Opciones avanzadas, si conectas una organización de zona de pruebas, selecciona Usar zona de pruebas. Luego, Salesforce entrega acciones desde tu organización de zona de pruebas.

   3. Haz clic en Continuar.

   4. En la sección Entidades para buscar, selecciona las entidades que deseas que Gemini Enterprise busque. Para Salesforce, selecciona Salesforce MCP.

7. Haz clic en Continuar.

8. Opcional: En la sección Acciones, selecciona las acciones de creación, actualización y eliminación que deseas habilitar para tus usuarios, o déjalas sin seleccionar para mantener el conector de solo lectura (las acciones de solo lectura están habilitadas de forma predeterminada). También puedes habilitar o inhabilitar estas acciones después de crear el almacén de datos. Consulta Habilita acciones.

9. Haz clic en Continuar.

10. En la sección Configuración, haz lo siguiente:

    1. En la lista Multirregional, selecciona la ubicación de tu conector de datos.
    2. En el campo Nombre de tu conector de datos, ingresa un nombre para tu conector.
    3. Si seleccionaste us o eu como ubicación, configura los parámetros de configuración de encriptación:
       • Opcional: Si no configuraste claves de una sola región, haz clic en Ir a la página de configuración para hacerlo. Para obtener más información, consulta Cómo registrar una clave de una sola región para conectores de terceros.
       • Selecciona Clave de encriptación administrada porGoogle o Clave de Cloud KMS.
       • Si seleccionaste Clave de Cloud KMS, haz lo siguiente:
         • En la lista Tipo de administración de claves, selecciona el tipo adecuado.
         • En la lista Clave de Cloud KMS, selecciona la clave.
       Para obtener más información, consulta Claves de encriptación administradas por el cliente.

11. Haz clic en Continuar.

12. En la sección Facturación, selecciona Precios generales o Precios configurables. Para obtener más información, consulta Verifica el estado de facturación de tus proyectos y Licencias.

13. Haz clic en Crear. Gemini Enterprise crea tu almacén de datos y lo muestra en la página Almacenes de datos.

En la página Almacenes de datos, haz clic en el nombre del almacén de datos para ver el estado. Después de que el estado del almacén de datos cambie de Creando a Activo, el almacén de datos de Salesforce estará listo para usarse.

Después de crear el almacén de datos, conéctalo a una app existente o crea una app nueva y conéctalo a la app nueva, y autoriza a Gemini Enterprise para que acceda a Salesforce antes de ejecutar cualquier consulta.

Nota: El paso Autorizar envía a cada usuario a la página de acceso de Salesforce de tu organización para otorgar a la app de OAuth los permisos mcp_api y refresh_token. Este paso falla si el paquete administrado de Gemini Enterprise (para OAuth 2.0 (administrado por Google)) o tu app de OAuth personalizada (para OAuth 2.0 (Trae tu propia app)) no está configurado en esa organización, o si el perfil del usuario no tiene acceso a la app. No se admite la configuración de IP estática por almacén de datos. La política de IP de acceso para las llamadas de autenticación y actualización de tokens se configura en la app en Salesforce, y las llamadas de datos se autorizan con el token de acceso válido del usuario. Consulta Establece la política de IP de acceso para la app.

Habilitar acciones

Cuando creas un almacén de datos de Salesforce, sus acciones se completan previamente en el almacén de datos. Las acciones de solo lectura (Consulta de Soql, Buscar, Obtener esquema de objeto, Obtener registros relacionados, Enumerar registros de Sobject recientes y Obtener información del usuario) están habilitadas de forma predeterminada y siempre disponibles. Las acciones que crean, actualizan o borran registros (Crear registro de Sobject, Actualizar registro de Sobject, Actualizar registro relacionado, Borrar registro de Sobject y Borrar registro relacionado) están desactivadas de forma predeterminada.

Si no habilitaste las acciones de creación, actualización o eliminación durante la creación del almacén de datos, puedes habilitarlas en cualquier momento siguiendo estos pasos:

1. En la consola de Google Cloud , ve a tu almacén de datos de Salesforce.

2. Selecciona la pestaña Acciones.

3. Selecciona las acciones que deseas habilitar (Crear registro de Sobject, Actualizar registro de Sobject, Actualizar registro relacionado, Borrar registro de Sobject o Borrar registro relacionado). Para que el conector sea de solo lectura, deja estas acciones sin seleccionar.

4. Haz clic en Habilitar acciones.

Para obtener la lista de acciones, consulta Acciones admitidas.

Control de datos y ejecución de consultas

En esta sección, se describe cómo Gemini Enterprise administra tu búsqueda y las implicaciones de privacidad del uso del almacén de datos federado.

Ejecución de las consultas

Después de autorizar Salesforce y enviar una búsqueda a Gemini Enterprise, ocurrirá lo siguiente:

• Gemini Enterprise envía tu búsqueda directamente al servidor de MCP de Salesforce.
• Gemini Enterprise combina los resultados con los de otras fuentes de datos conectadas y muestra un resultado de búsqueda integral.

Manejo de datos

Cuando se usa la búsqueda federada de terceros, se aplican las siguientes reglas de tratamiento de datos:

• Tu cadena de consulta se envía al backend de búsqueda de terceros (servidor de MCP de Salesforce).
• Estos terceros pueden asociar las búsquedas con tu identidad.
• Si hay varias fuentes de datos de búsqueda federada habilitadas, es posible que la consulta se envíe a todas ellas.
• Después de que los datos llegan al sistema de terceros, se rigen por las condiciones del servicio y las políticas de privacidad de ese sistema.

Nota: Para mejorar la exactitud, es posible que un LLM reescriba tu búsqueda antes de que se envíe a Salesforce. Esta consulta reescrita puede incorporar información del historial de consultas de tu sesión. Como resultado, es posible que partes de tu historial de consultas también se incluyan en la consulta que se envía al servidor de MCP de Salesforce.

¿Qué sigue?

• Para proporcionar una interfaz de usuario para consultar tus datos de Salesforce, crea una app y conéctala al almacén de datos de Salesforce.
• Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar tu app, consulta Cómo obtener resultados de la búsqueda.
• Para habilitar las alertas del almacén de datos, consulta Configura alertas para almacenes de datos de terceros.