Conexión a tierra web para empresas

En esta página, se describen los controles de cumplimiento de Web Grounding for Enterprise y cómo usar la API de Web Grounding for Enterprise para generar respuestas basadas en la Web. El contenido indexado es un subconjunto del que está disponible en la Búsqueda de Google y es adecuado para los clientes de sectores altamente regulados, como el financiero, el de la salud y el público.

Si no necesitas los controles de cumplimiento adicionales, usa Fundamentar con la Búsqueda de Google, ya que ofrece acceso a un índice web más amplio y actualizado.

Descripción general

La fundamentación web para empresas usa un índice web que se utiliza para generar respuestas fundamentadas. El servicio no registra los datos del cliente y admite los Controles del servicio de VPC. Para obtener más información, consulta Controles de seguridad para la IA generativa. Como no se conservan datos del cliente, no se aplican las claves de encriptación administradas por el cliente (CMEK) ni la Transparencia de acceso (AxT).

Actualización y selección de índices

El índice web de Web Grounding para Enterprise se selecciona automáticamente para satisfacer las necesidades esperadas de los clientes en las verticales de atención médica, finanzas y sector público. Si bien los programas de actualización específicos pueden variar, el contenido que cambia rápidamente se actualiza cada 6 horas, y todo el índice se actualiza cada 24 horas.

Elija un producto

Elegir la herramienta de fundamentación adecuada depende de las necesidades específicas de tu organización en relación con los controles de cumplimiento y la actualización de la información requerida.

  • Fundamentación con la Búsqueda de Google: Esta es la opción recomendada para los clientes que buscan la mayor calidad y actualidad en sus respuestas fundamentadas. La actualidad se relaciona con qué tan reciente es la información web que se usa para generar la respuesta. Es fundamental para los casos de uso en los que es importante acceder a la información más actualizada y completa de la Web. La Fundamentación con la Búsqueda de Google almacena registros de confiabilidad durante un máximo de 30 días, según los Términos Específicos del Servicio. Google no se entrena con los datos del cliente que procesa la Fundamentación con la Búsqueda de Google.

  • Web Grounding for Enterprise: Esta solución está diseñada específicamente para clientes empresariales que tienen requisitos de cumplimiento estrictos, como "no registrar datos de los clientes". La fundamentación web para empresas es la opción preferida para las organizaciones de industrias altamente reguladas que requieren los controles de cumplimiento adicionales. Web Grounding for Enterprise no almacena datos del cliente.

Modelos compatibles

En esta sección, se enumeran los modelos que admiten la fundamentación web para empresas.

Usa la API

En esta sección, se proporcionan ejemplos de solicitudes para usar la API de IA generativa Gemini 2 en Vertex AI para crear respuestas fundamentadas con Gemini. Para usar la API, debes establecer los siguientes campos:

  • Contents.parts.text: Es la búsqueda de texto que los usuarios desean enviar a la API.
  • tools.enterpriseWebSearch: Cuando se proporciona esta herramienta, Gemini puede usar la fundamentación web para empresas.

Python

Instalar

pip install --upgrade google-genai

Para obtener más información, consulta la documentación de referencia del SDK.

Establece variables de entorno para usar el SDK de IA generativa con Vertex AI: 

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_VERTEXAI=True
 

from google import genai
from google.genai.types import (
    EnterpriseWebSearch,
    GenerateContentConfig,
    HttpOptions,
    Tool,
)

client = genai.Client(http_options=HttpOptions(api_version="v1"))

response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="When is the next total solar eclipse in the United States?",
    config=GenerateContentConfig(
        tools=[
            # Use Enterprise Web Search Tool
            Tool(enterprise_web_search=EnterpriseWebSearch())
        ],
    ),
)

print(response.text)
# Example response:
# 'The next total solar eclipse in the United States will occur on ...'

REST

Reemplaza las siguientes variables por valores:

  • PROJECT_NUMBER: Es el número de tu proyecto.
  • LOCATION: La región para procesar la solicitud. Para usar el extremo global, excluye la ubicación del nombre del extremo y configura la ubicación del recurso en global.
  • PROMPT: Es tu instrucción.
  curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -H "x-server-timeout: 60" https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/publishers/google/models/gemini-2.0-flash:generateContent -d '
  {
    "contents": [{
      "role": "user",
      "parts": [{
        "text": PROMPT
      }]
    }],
    "tools": [{
      "enterpriseWebSearch": {
      }
    }]
  }
  '

Cómo usar las sugerencias de la Búsqueda de Google

Cuando usas Web Grounding para empresas y recibes sugerencias de búsqueda en tu respuesta, debes mostrarlas en producción y en tus aplicaciones.

Específicamente, debes mostrar las búsquedas que se incluyen en los metadatos de la respuesta fundamentada. En la respuesta, se incluye :

  • "content": Es la respuesta generada por el LLM.
  • "webSearchQueries": Son las búsquedas que se usarán para las sugerencias de búsqueda.

Por ejemplo, en el siguiente fragmento de código, Gemini responde a una instrucción basada en la Búsqueda, que pregunta sobre un tipo de planta tropical.

"predictions": [
  {
    "content": "Monstera is a type of vine that thrives in bright indirect light…",
    "groundingMetadata": {
      "webSearchQueries": ["What's a monstera?"],
    }
  }
]

Puedes tomar este resultado y mostrarlo a través de las Sugerencias de búsqueda.

Requisitos para las sugerencias de búsqueda

Estos son los requisitos para las sugerencias:

Requisito Descripción
Sí
  • Si bien cumple con los requisitos de visualización, la sugerencia de búsqueda se muestra exactamente como se proporciona, sin cambios.
  • Cuando interactúas con la sugerencia de búsqueda, se te dirige directamente a la página de resultados de búsqueda (SRP).
No
  • Incluir pantallas o pasos adicionales entre la selección del usuario y la visualización de la SRP
  • Muestra cualquier otro resultado de la búsqueda o sugerencia junto a la Sugerencia de Búsqueda o la respuesta de LLM fundamentada asociada.

Requisitos de visualización

Estos son los requisitos de visualización:

  • Muestra la sugerencia de búsqueda exactamente como se proporciona y no modifiques los colores, las fuentes ni la apariencia. Asegúrate de que la sugerencia de búsqueda se renderice como se especifica en las siguientes simulaciones, lo que incluye el modo claro y el oscuro:

  • Cada vez que se muestre una respuesta fundamentada, la sugerencia de la Búsqueda correspondiente debería permanecer visible.
  • Para el desarrollo de la marca, debes seguir estrictamente los lineamientos de Google para el uso de terceros de los recursos de la marca de Google que se encuentran en el Centro de recursos de la marca.
  • Cuando usas la Fundamentación web para empresas, se muestran chips de sugerencias de búsqueda. El campo que contiene los chips de sugerencias debe tener el mismo ancho que la respuesta fundamentada del LLM.

Comportamiento al presionar

Cuando un usuario presiona el chip, se lo dirige directamente a una página de resultados de la Búsqueda (SRP) correspondiente al término de búsqueda que se muestra en el chip. La SRP puede abrirse dentro del navegador integrado en la aplicación o en una aplicación del navegador independiente. Es importante no minimizar, quitar ni obstruir la pantalla de la SRP de ninguna manera. En la siguiente simulación animada, se ilustra la interacción de presionar para acceder a la SRP.

ejemplo de app/computadora de escritorio

Código para implementar una sugerencia de búsqueda

Cuando usas la API para fundamentar una respuesta a una búsqueda, la respuesta del modelo proporciona un estilo HTML y CSS compatible en el campo renderedContent, que implementas para mostrar sugerencias de búsqueda en tu aplicación.

¿Qué sigue?

  • Para obtener más información sobre cómo fundamentar los modelos de Gemini en tus datos, consulta Fundamentación con Vertex AI Search.
  • Para obtener más información sobre las prácticas recomendadas de IA responsable y los filtros de seguridad de Vertex AI, consulta IA responsable.