Fundamentación con la búsqueda web de Parallel

Vista previa

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Parallel Web Systems ofrece una API de búsqueda que proporciona acceso a datos web disponibles públicamente y optimizados para el uso de modelos de lenguaje grandes para la fundamentación. En esta página, se explica cómo fundamentar las respuestas de Gemini con Parallel.

La fundamentación con Parallel en Gemini Enterprise Agent Platform es una Oferta Independiente (según se define en tu Google Cloud Acuerdo) que conecta los modelos de Gemini con los datos web públicos proporcionados por la API de búsqueda de Parallel Web Systems. Este servicio le da acceso a Gemini a información en tiempo real de miles de millones de páginas web para garantizar respuestas más actualizadas y fácticas.

Nota: En el caso de los publicadores web, la fundamentación con Parallel en Gemini Enterprise Agent Platform no usa páginas web para la fundamentación en las que no se permitió ShapBot. Los publicadores web pueden administrar sus exclusiones con un archivo robots.txt.

Casos de uso

La fundamentación con Parallel es adecuada para casos de uso como los siguientes:

• Usamos datos de la Web para completar o enriquecer la información.
• Agentes de múltiples saltos que requieren búsquedas en la Web más profundas para preguntas más complejas
• Crear una API que integre datos de la búsqueda web
• Asistentes para empleados que permiten a los usuarios finales hacer preguntas y crear informes complejos con la información web más reciente.
• Aplicaciones orientadas al consumidor, como las de comercio minorista y viajes, que permiten al usuario tomar decisiones de compra fundamentadas
• Agentes automatizados que se ejecutan de forma autónoma para realizar tareas automatizadas, como el análisis de noticias y las verificaciones de KYC
• Agentes verticales (agentes de ventas, agentes de programación, agentes financieros) que obtienen el contexto más actualizado de la Web.

Ejemplo

¿Quién ganó el Gran Premio de F1 de Las Vegas 2025?

Sin fundamentación	Con conexión a tierra
El Gran Premio de Las Vegas 2025 aún no se llevó a cabo. La carrera está programada para el fin de semana del 20 al 22 de noviembre de 2025. Por lo tanto, se desconoce al ganador.	El ganador del Gran Premio de F1 de Las Vegas 2025 fue Max Verstappen de Red Bull Racing. La carrera se llevó a cabo el 22 de noviembre de 2025. Fuentes: dominio1.com, dominio2.com, …

Modelos compatibles

Los siguientes modelos admiten la fundamentación con la búsqueda web de Parallel:

• Gemini 2.5 Flash (gemini-2.5-flash)
• Gemini 2.5 Flash-Lite (gemini-2.5-flash-lite)
• Gemini 2.5 Pro (gemini-2.5-pro)
• Gemini 3.1 Pro (gemini-3.1-pro-preview)
• Gemini 3.1 Flash Lite (gemini-3.1-flash-lite)
• Gemini 3.5 Flash (gemini-3.5-flash)

Antes de comenzar

Para usar la fundamentación con la búsqueda web de Parallel, debes configurar tu acceso. Tienes dos opciones:

• Suscríbete directamente a Grounding with Parallel Web Search en Google Cloud Marketplace (versión preliminar) para obtener una integración optimizada en tu entorno de nube existente. También hay disponible una oferta de retención de datos cero para cargas de trabajo sensibles. Para usar ZDR, debes suscribirte a la oferta de ZDR y establecer la marca enable_zero_data_retention correspondiente en tus solicitudes a la API.

• Usa una clave de API de Parallel existente.

Suscríbete en Google Cloud Marketplace (recomendado)

Vista previa

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

La integración a través de Google Cloud Marketplace te permite administrar tu servicio de fundamentación con la búsqueda web paralela directamente en Google Cloud. Para comenzar, suscríbete al servicio de fundamentación con la Búsqueda web paralela en Google Cloud Marketplace, acepta las condiciones del servicio y revisa los precios.

Nota: Cuando te suscribes a Grounding with Parallel Web Search en Google Cloud Marketplace, Google Cloud debe enviar ciertos datos, como las búsquedas derivadas y reescritas a partir de la instrucción original del usuario, a Parallel Web Search para su procesamiento. El uso que hagas del servicio de Búsqueda web paralela se rige por las condiciones de uso de Google Cloud Marketplace para la Búsqueda web paralela.

Usa tu propia clave de API

Si prefieres administrar la facturación paralela y el acceso a la API por separado, puedes proporcionar tu propia clave de API. Para usar este método, debes obtener una clave de API de la plataforma para desarrolladores de Parallel. Esta clave de API se usa directamente en tus solicitudes a la API de REST de Gemini.

Nota: Cuando usas tu propia clave de API,se requiere Google Cloud para enviar ciertos datos, como las búsquedas derivadas y reescritas a partir de la instrucción original del usuario, a la Búsqueda web paralela para su procesamiento. El uso que hagas del servicio de Búsqueda Web Paralela está regido por las condiciones de uso y la política de uso aceptable de Parallel.

Fundamenta las respuestas de Gemini con Parallel

Para solicitar respuestas fundamentadas de Gemini, usa la API de REST de la siguiente manera. Para obtener el mejor rendimiento, te recomendamos que utilices la configuración predeterminada para los parámetros opcionales, a menos que necesites valores no predeterminados.

Si te suscribiste a Grounding with Parallel Web Search en Google Cloud Marketplace (versión preliminar), verifica que la cuenta de facturación que usaste para la suscripción esté activa en tu proyecto deGoogle Cloud .

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• 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 como "global".
• PROJECT_ID: Es el ID del proyecto de Google Cloud .
• MODEL_ID: Es el ID del modelo que se usará.
• TEXT: Es la instrucción de texto que se enviará al modelo.
• API_KEY: Es tu clave de API para la Búsqueda web paralela. Si especificas una clave de API y también te suscribiste a Grounding with Parallel Web Search en Google Cloud Marketplace (versión preliminar), la clave de API tendrá prioridad.
• ENABLE_ZERO_DATA_RETENTION: Opcional: Cambia a la versión de ZDR de la Búsqueda web paralela para habilitar la retención de datos cero en cargas de trabajo sensibles. Se establece en true para usar la oferta de ZDR para tu solicitud. Debes suscribirte a la oferta específica de ZDR para que estas solicitudes se realicen correctamente. Si no se especifica, se usa la versión estándar de forma predeterminada. La versión de ZDR solo está disponible a través de Google Cloud Marketplace.
• EXCLUDE_DOMAINS: Opcional: Es la lista de dominios que se excluirán de las fuentes de fundamentación. Si se especifica, se excluyen las fuentes de estos dominios. Los valores aceptables son dominios (www.example.com) o extensiones de dominio que comienzan con un punto (.gov, .edu, .co.uk). Puedes especificar hasta 200 dominios.
• INCLUDE_DOMAINS: Opcional: Lista de dominios para incluir en las fuentes de fundamentación. Si se especifica, se incluyen las fuentes de estos dominios. Los valores aceptables son dominios (www.example.com) o extensiones de dominio que comienzan con un punto (.gov, .edu, .co.uk). Puedes especificar hasta 200 dominios.
• MAX_CHARS_PER_RESULT: Opcional: Es la cantidad máxima de caracteres que se incluirán en cada fragmento de resultado de la búsqueda. Si no se especifica, el valor predeterminado es 30000. El rango permitido es [1000, 100000].
• MAX_CHARS_TOTAL: Opcional: Es la cantidad máxima total de caracteres de todos los fragmentos de los resultados de la búsqueda. Si no se especifica, el valor predeterminado es 100000. El rango permitido es [1000, 1000000].
• MAX_RESULTS: Opcional: Es la cantidad máxima de resultados de la búsqueda que se usarán para la fundamentación. Si no se especifica, el valor predeterminado es 10. El rango permitido es [1, 20].
• MODE: Opcional: Modo que se usará para la solicitud, ya sea basic o advanced. El valor predeterminado es basic. Considera el modo advanced si deseas obtener resultados de la búsqueda más exhaustivos a costa de una mayor latencia.
• SEARCH_LOCATION: Opcional: código de país ISO 3166-1 alpha-2 para los resultados de la búsqueda segmentados geográficamente. Ejemplo: "us".

Método HTTP y URL:

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent

Cuerpo JSON de la solicitud:

{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "TEXT"
    }]
  }],
  "tools": [{
    "parallelAiSearch": {
        "api_key": "API_KEY",
        "enable_zero_data_retention": ENABLE_ZERO_DATA_RETENTION,
        "customConfigs": {
            "mode": "MODE",
            "location": "SEARCH_LOCATION",
            "max_results": MAX_RESULTS,
            "source_policy": {
                "exclude_domains": ["EXCLUDE_DOMAINS"],
                "include_domains": ["INCLUDE_DOMAINS"]
            },
            "excerpts": {
                "max_chars_per_result": MAX_CHARS_PER_RESULT,
                "max_chars_total": MAX_CHARS_TOTAL
            }
        }
    }
}],
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

Respuesta

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "The most recent Super Bowl was Super Bowl LIX (59), which was played in 2025. The winner of Super Bowl LIX was the **Philadelphia Eagles**, who defeated the Kansas City Chiefs with a score of 40-22."
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "webSearchQueries": [
          "who won the last super bowl"
        ],
        "groundingChunks": [
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LIX",
              "domain": "domain.com"
            }
          },
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LIX Results",
              "domain": "domain.com"
            }
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "endIndex": 77,
              "text": "The most recent Super Bowl was Super Bowl LIX (59), which was played in 2025."
            },
            "groundingChunkIndices": [
              0,
              1
            ]
          },
          {
            "segment": {
              "startIndex": 78,
              "endIndex": 198,
              "text": "The winner of Super Bowl LIX was the **Philadelphia Eagles**, who defeated the Kansas City Chiefs with a score of 40-22."
            },
            "groundingChunkIndices": [
              0
            ]
          },
        ]
      }
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 33,
    "candidatesTokenCount": 106,
    "totalTokenCount": 284,
    "billablePromptUsage": {
      "textCount": 142
    },
    "trafficType": "ON_DEMAND",
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 33
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 106
      }
    ],
    "toolUsePromptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 39
      }
    ],
    "toolUsePromptTokenCount": 39,
    "thoughtsTokenCount": 106
  },
  "modelVersion": "MODEL_VERSION",
  "createTime": "CREATE_TIME",
  "responseId": "RESPONSE_ID"
}

Cuota

La cuota predeterminada es de 200 instrucciones por minuto. Para solicitar un aumento en tus límites de frecuencia, proporciona tu caso de uso y requisitos al contacto correspondiente:

• Si te suscribiste a Grounding with Parallel Web Search en Google Cloud Marketplace (vista previa), comunícate con tu equipo de cuentas de Google.

• Si proporcionas tu propia clave de API: Comunícate con [e-mail] y con tu equipo de Cuentas de Google.

Facturación

El uso de la Fundamentación con la búsqueda web de Parallel genera los siguientes cargos:

• Consumo de tokens de Gemini: Se te puede facturar por lo siguiente:

  • Tokens de instrucciones
  • Tokens de pensamiento
  • Tokens de salida

  Para obtener más información, consulta Precios.

• Fundamentación de Gemini con tus datos: Para obtener más información, consulta Precios.

• Precios por el uso de la API de Parallel Web Search:

  • Si te suscribiste a Grounding with Parallel Web Search en Google Cloud Marketplace (versión preliminar), consulta la sección Precios de Parallel en Google Cloud Marketplace para obtener más información.

  • Si proporcionas tu propia clave de API, consulta el sitio web paralelo para obtener más información.