Fundamentación con la búsqueda web de Parallel

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 brinda a Gemini acceso a información en tiempo real de miles de millones de páginas web para garantizar respuestas más actualizadas y fácticas.

Casos de uso

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

  • Usar datos web para completar o enriquecer información
  • Agentes de varios saltos que requieren búsquedas 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.
  • Son aplicaciones para el consumidor, como las de venta 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 codificació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 el 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: domain1.com, domain2.com, ...

Modelos compatibles

En esta sección, se enumeran los modelos que admiten la fundamentación con la búsqueda web de Parallel.

Haz clic para expandir los modelos compatibles

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 la fundamentación con la búsqueda web de Parallel en Google Cloud Marketplace para obtener una integración optimizada en tu entorno de nube existente. También está disponible una oferta de retención de datos cero para cargas de trabajo sensibles. Para usar la ZDR, debes suscribirte a la oferta de ZDR y establecer el parámetro 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)

La integración a través de Google Cloud Marketplace te permite administrar tu servicio de fundamentación con Parallel Web Search directamente en Google Cloud. Para comenzar, suscríbete al servicio de fundamentación con Parallel Web Search en Google Cloud Marketplace, acepta las Condiciones del Servicio y revisa los precios.

Usa tu propia clave de API

Si prefieres administrar la facturación y el acceso a la API de Parallel 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.

Fundamenta las respuestas de Gemini con Parallel

Solicita respuestas fundamentadas de Gemini con Agent Studio en la consola de Google Cloud , el SDK de IA generativa de Google o la API de REST. Para obtener el mejor rendimiento, te recomendamos que uses la configuración predeterminada para los parámetros opcionales, a menos que necesites estrictamente valores no predeterminados.

Si te suscribiste a la fundamentación con la búsqueda web paralela en Google Cloud Marketplace, verifica que la cuenta de facturación que usaste para la suscripción esté activa en tu proyecto deGoogle Cloud .

Antes de ejecutar las muestras, completa los requisitos previos, incluida la suscripción en Google Cloud Marketplace o la provisión de una clave de API de Parallel.

Console

Para fundamentar las respuestas de Gemini con la búsqueda web paralela usando Agent Studio en Gemini Enterprise Agent Platform, sigue estos pasos:

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

    Ir a Agent Studio

  2. En el panel lateral, en Configuración del modelo, en la sección Fundamentación, activa el botón de activación Socios (Resultados de la búsqueda de socios de fundamentación).

  3. Selecciona Búsqueda web paralela como socio de fundamentación y, luego, haz clic en Aplicar. Para usar la Búsqueda web paralela, primero debes suscribirte a ella en Google Cloud Marketplace.

  4. Ingresa tu instrucción en el cuadro de texto y envíala.

Tus respuestas a las instrucciones ahora usan la fundamentación con la búsqueda web de Parallel.

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 de Google 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_ENTERPRISE=True

Antes de ejecutar la muestra, realiza los siguientes reemplazos:

  • MODEL_ID: Es el ID de un modelo compatible que se usará, como gemini-2.5-flash.
  • TEXT: Es la instrucción de texto que se enviará al modelo.
  • API_KEY: Es tu clave de API para Parallel Web Search. Omite este parámetro si te suscribiste en Google Cloud Marketplace. Si se proporcionan ambos, la clave de API tiene prioridad.
  • EXCLUDE_DOMAINS: Opcional: Es una 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: Es opcional y se refiere a la lista de dominios que se incluirán 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: Es la cantidad máxima de caracteres que se incluirán en cada extracto de los resultados de la búsqueda (opcional). Si no se especifica, el valor predeterminado es 30000. El rango permitido es [1000, 100000].
  • MAX_CHARS_TOTAL: Es opcional y se refiere a la cantidad máxima total de caracteres de todos los extractos 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: Es opcional. Es el modo que se usará para la solicitud, ya sea basic o advanced. El valor predeterminado es basic. Considera el modo advanced si quieres obtener resultados de la búsqueda más exhaustivos a expensas de una latencia más alta.
  • SEARCH_LOCATION: Opcional: Es el código de país ISO 3166-1 alfa-2 para los resultados de la búsqueda con segmentación geográfica. Ejemplo: "us".

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="MODEL_ID",
    contents="TEXT",
    config=types.GenerateContentConfig(
        tools=[
            types.Tool(
                parallel_ai_search=types.ToolParallelAiSearch(
                    # Optional. Omit api_key if you subscribed to Grounding with
                    # Parallel Web Search on Google Cloud Marketplace.
                    api_key="API_KEY",
                    # Optional. Set to True to use Zero Data Retention (ZDR) for
                    # sensitive workloads. Requires a separate ZDR Marketplace
                    # subscription; defaults to the standard subscription.
                    enable_zero_data_retention=True,
                    # Optional. Customize the search. Click a placeholder to
                    # enter a value, or remove the line to accept the default.
                    custom_configs={
                        "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,
                        },
                    },
                )
            )
        ],
    ),
)

print(response.text)
# Example response:
# Max Verstappen won the 2025 Las Vegas F1 Grand Prix ...

# The grounding metadata contains the web sources used to ground the response.
print(response.candidates[0].grounding_metadata.grounding_chunks)

Java

Obtén información para instalar o actualizar el Java.

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 de Google 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_ENTERPRISE=True

Antes de ejecutar la muestra, realiza los siguientes reemplazos:

  • MODEL_ID: Es el ID de un modelo compatible que se usará, como gemini-2.5-flash.
  • TEXT: Es la instrucción de texto que se enviará al modelo.
  • API_KEY: Es tu clave de API para Parallel Web Search. Omite este parámetro si te suscribiste en Google Cloud Marketplace. Si se proporcionan ambos, la clave de API tiene prioridad.
  • EXCLUDE_DOMAINS: Opcional: Es una 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: Es opcional y se refiere a la lista de dominios que se incluirán 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: Es la cantidad máxima de caracteres que se incluirán en cada extracto de los resultados de la búsqueda (opcional). Si no se especifica, el valor predeterminado es 30000. El rango permitido es [1000, 100000].
  • MAX_CHARS_TOTAL: Es opcional y se refiere a la cantidad máxima total de caracteres de todos los extractos 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 quieres obtener resultados de la búsqueda más exhaustivos a expensas de una latencia más alta.
  • 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".

import com.google.genai.Client;
import com.google.genai.types.GenerateContentConfig;
import com.google.genai.types.GenerateContentResponse;
import com.google.genai.types.Tool;
import com.google.genai.types.ToolParallelAiSearch;
import java.util.List;
import java.util.Map;

public class ParallelGroundingSample {
  public static void main(String[] args) {
    try (Client client = Client.builder().build()) {

      GenerateContentConfig config =
          GenerateContentConfig.builder()
              .tools(
                  Tool.builder()
                      .parallelAiSearch(
                          ToolParallelAiSearch.builder()
                              // Optional. Omit apiKey if you subscribed to
                              // Grounding with Parallel Web Search on Google
                              // Cloud Marketplace.
                              .apiKey("API_KEY")
                              // Optional. Set to true to use Zero Data
                              // Retention (ZDR) for sensitive workloads.
                              // Requires a separate ZDR Marketplace
                              // subscription; defaults to the standard
                              // subscription.
                              .enableZeroDataRetention(true)
                              // Optional. Customize the search. Click a
                              // placeholder to enter a value, or remove the
                              // entry to accept the default.
                              .customConfigs(
                                  Map.of(
                                      "mode", "MODE",
                                      "location", "SEARCH_LOCATION",
                                      "max_results", MAX_RESULTS,
                                      "source_policy",
                                      Map.of(
                                          "exclude_domains",
                                          List.of("EXCLUDE_DOMAINS"),
                                          "include_domains",
                                          List.of("INCLUDE_DOMAINS")),
                                      "excerpts",
                                      Map.of(
                                          "max_chars_per_result",
                                          MAX_CHARS_PER_RESULT,
                                          "max_chars_total",
                                          MAX_CHARS_TOTAL)))
                              .build())
                      .build())
              .build();

      GenerateContentResponse response =
          client.models.generateContent(
              "MODEL_ID", "TEXT", config);

      System.out.println(response.text());
    }
  }
}

Node.js

Instalar

npm install @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 de Google 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_ENTERPRISE=True

Antes de ejecutar la muestra, realiza los siguientes reemplazos:

  • MODEL_ID: Es el ID de un modelo compatible que se usará, como gemini-2.5-flash.
  • TEXT: Es la instrucción de texto que se enviará al modelo.
  • API_KEY: Es tu clave de API para Parallel Web Search. Omite este parámetro si te suscribiste en Google Cloud Marketplace. Si se proporcionan ambos, la clave de API tiene prioridad.
  • EXCLUDE_DOMAINS: Opcional: Es una 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: Es opcional y se refiere a la lista de dominios que se incluirán 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: Es la cantidad máxima de caracteres que se incluirán en cada extracto de los resultados de la búsqueda (opcional). Si no se especifica, el valor predeterminado es 30000. El rango permitido es [1000, 100000].
  • MAX_CHARS_TOTAL: Es opcional y se refiere a la cantidad máxima total de caracteres de todos los extractos 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: Es opcional. Es el modo que se usará para la solicitud, ya sea basic o advanced. El valor predeterminado es basic. Considera el modo advanced si quieres obtener resultados de la búsqueda más exhaustivos a expensas de una latencia más alta.
  • SEARCH_LOCATION: Opcional: Es el código de país ISO 3166-1 alfa-2 para los resultados de la búsqueda con segmentación geográfica. Ejemplo: "us".

import {GoogleGenAI} from '@google/genai';

const ai = new GoogleGenAI({});

const response = await ai.models.generateContent({
  model: 'MODEL_ID',
  contents: 'TEXT',
  config: {
    tools: [
      {
        parallelAiSearch: {
          // Optional. Omit apiKey if you subscribed to Grounding with Parallel
          // Web Search on Google Cloud Marketplace.
          apiKey: 'API_KEY',
          // Optional. Set to true to use Zero Data Retention (ZDR) for
          // sensitive workloads. Requires a separate ZDR Marketplace
          // subscription; defaults to the standard subscription.
          enableZeroDataRetention: true,
          // Optional. Customize the search. Click a placeholder to enter a
          // value, or remove the line to accept the default.
          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,
            },
          },
        },
      },
    ],
  },
});

console.log(response.text);

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 de un modelo compatible que se usará, como gemini-2.5-flash.
  • TEXT: Es la instrucción de texto que se enviará al modelo.
  • API_KEY: Es tu clave de API para Parallel Web Search. Omite este parámetro si te suscribiste en Google Cloud Marketplace. Si se proporcionan ambos, la clave de API tiene prioridad.
  • EXCLUDE_DOMAINS: Opcional: Es una 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: Es opcional y se refiere a la lista de dominios que se incluirán 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: Es la cantidad máxima de caracteres que se incluirán en cada extracto de los resultados de la búsqueda (opcional). Si no se especifica, el valor predeterminado es 30000. El rango permitido es [1000, 100000].
  • MAX_CHARS_TOTAL: Es opcional y se refiere a la cantidad máxima total de caracteres de todos los extractos 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: Es opcional. Es el modo que se usará para la solicitud, ya sea basic o advanced. El valor predeterminado es basic. Considera el modo advanced si quieres obtener resultados de la búsqueda más exhaustivos a expensas de una latencia más alta.
  • SEARCH_LOCATION: Opcional: Es el código de país ISO 3166-1 alfa-2 para los resultados de la búsqueda con segmentación geográfica. Ejemplo: "us".
  • 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. Establécelo en true para usar la oferta de ZDR en 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.

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:

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

Cuota

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

  • Si te suscribiste a la fundamentación con la búsqueda web paralela en Google Cloud Marketplace, comunícate con tu equipo de cuentas de Google.

  • Si proporcionas tu propia clave de API: Comunícate con support@parallel.ai 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 razonamiento
    • 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 con la búsqueda web paralela en Google Cloud Marketplace, 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.