Parallel Web Systems ofrece una API de búsqueda que proporciona acceso a datos web disponibles públicamente y optimizados para su uso por 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 (como se define en tu Google Cloud acuerdo) que conecta los modelos de Gemini con los datos web públicos que proporciona la API de búsqueda de Parallel Web Systems'. Este servicio le da a Gemini acceso a información en vivo de miles de millones de páginas web para garantizar respuestas más actualizadas y basadas en hechos.
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 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 para el consumidor, como el comercio minorista y los 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 de finanzas) 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 fundamentación |
|---|---|
| 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
La fundamentación con la búsqueda web de Parallel es compatible con los siguientes modelos:
- 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 la fundamentación con la búsqueda web de Parallel en Google Cloud Marketplace para 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 ZDR, debes suscribirte a la oferta de ZDR y establecer la marca
enable_zero_data_retentioncorrespondiente 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 la búsqueda web de Parallel directamente en Google Cloud. Para comenzar, suscríbete al servicio de fundamentación con la búsqueda web de Parallel en Google Cloud Marketplace, acepta las Condiciones del Servicio y revisa los precios.
Trae tu propia clave de API
Si prefieres administrar tu facturación de Parallel 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 para Gemini.
Fundamenta las respuestas de Gemini con Parallel
Solicita respuestas fundamentadas de Gemini con Agent Studio en la Google Cloud consola, 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 valores no predeterminados.
Si te suscribiste a la fundamentación con la búsqueda web de Parallel en Google Cloud Marketplace , verifica que la cuenta de facturación que se usó para tu suscripción esté activa en tu Google Cloud proyecto.
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.
Cada muestra del SDK lee tu proyecto y ubicación de las variables de entorno que se muestran en su pestaña. En el código de muestra, reemplaza MODEL_ID por un ID de
modelo compatible, como gemini-2.5-flash.
Console
Para fundamentar las respuestas de Gemini con la búsqueda web de Parallel mediante Agent Studio en Gemini Enterprise Agent Platform, sigue estos pasos:
En la Google Cloud consola, ve a la página Agent Studio.
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).
Selecciona Búsqueda web de Parallel como socio de fundamentación y, luego, haz clic en Aplicar. Para usar la búsqueda web de Parallel, primero debes suscribirte a ella en Google Cloud Marketplace.
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
from google import genai
from google.genai import types
client = genai.Client()
response = client.models.generate_content(
model="MODEL_ID",
contents="Who won the 2025 Las Vegas F1 Grand Prix?",
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. Otherwise,
# provide your Parallel API key.
# api_key="API_KEY",
# Optional. Customize the search. See the REST tab for the
# full list of supported parameters. Keys inside custom_configs
# are Parallel.ai Search API params (snake_case).
custom_configs={
"mode": "basic",
"max_results": 10,
"source_policy": {"include_domains": ["wikipedia.org"]},
},
)
)
],
),
)
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)
Para personalizar la búsqueda, establece el campo custom_configs de ToolParallelAiSearch. Este campo acepta los mismos parámetros opcionales que se describen en la pestaña REST , como source_policy, excerpts, max_results y mode.
Java
Obtén información para instalar o actualizar 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
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(
// Omit apiKey if you subscribed to Grounding with Parallel Web
// Search on Google Cloud Marketplace. Otherwise, set apiKey to
// your Parallel API key.
Tool.builder()
.parallelAiSearch(
ToolParallelAiSearch.builder()
// Optional. Customize the search. See the REST tab
// for the full list of supported parameters. Keys
// inside customConfigs are Parallel.ai Search API
// params (snake_case).
.customConfigs(
Map.of(
"mode", "basic",
"max_results", 10,
"source_policy",
Map.of(
"include_domains",
List.of("wikipedia.org"))))
.build())
.build())
.build();
GenerateContentResponse response =
client.models.generateContent(
"MODEL_ID", "Who won the 2025 Las Vegas F1 Grand Prix?", config);
System.out.println(response.text());
}
}
}
Para personalizar la búsqueda, establece el campo customConfigs de ToolParallelAiSearch. Este campo acepta los mismos parámetros opcionales que se describen en la pestaña REST , como source_policy, excerpts, max_results y mode.
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
import {GoogleGenAI} from '@google/genai';
const ai = new GoogleGenAI({});
const response = await ai.models.generateContent({
model: 'MODEL_ID',
contents: 'Who won the 2025 Las Vegas F1 Grand Prix?',
config: {
tools: [
// Omit apiKey if you subscribed to Grounding with Parallel Web Search on
// Google Cloud Marketplace. Otherwise, set apiKey to your Parallel API key.
{
parallelAiSearch: {
// Optional. Customize the search. See the REST tab for the full
// list of supported parameters. Keys inside customConfigs are
// Parallel.ai Search API params (snake_case).
customConfigs: {
mode: 'basic',
max_results: 10,
source_policy: {include_domains: ['wikipedia.org']},
},
},
},
],
},
});
console.log(response.text);
Para personalizar la búsqueda, establece el campo customConfigs de la herramienta parallelAiSearch. Este campo acepta los mismos parámetros opcionales que se describen en la pestaña REST , como source_policy, excerpts, max_results y mode.
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 Google Cloud proyecto de.
- 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 de Parallel. Si especificas una clave de API y también te suscribes a la fundamentación con la búsqueda web de Parallel en Google Cloud Marketplace, la clave de API tiene prioridad.
- ENABLE_ZERO_DATA_RETENTION: Opcional: Cambia a la versión ZDR de la búsqueda web de Parallel para habilitar la retención de datos cero en cargas de trabajo sensibles. Establece
truepara 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 establece de forma predeterminada en la versión estándar. La versión 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: Es 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: Opcional: Es la
cantidad máxima de caracteres que se incluirán en cada extracto 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
caracteres de todos los extractos de 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: Es el modo que se usará para la solicitud, ya sea
basicoadvanced. El valor predeterminado esbasic. Considera el modoadvancedsi deseas obtener resultados de la búsqueda más exhaustivos a costa de una latencia más alta. - SEARCH_LOCATION: Opcional: Es el 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:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Quota
La cuota predeterminada es de 200 instrucciones por minuto. Para solicitar un aumento en los límites de frecuencia, proporciona tu caso de uso y requisitos al contacto adecuado:
Si te suscribiste a la fundamentación con la búsqueda web de Parallel 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 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 búsqueda web de Parallel:
Si te suscribiste a la fundamentación con la búsqueda web de Parallel en Google Cloud Marketplace, consulta la sección de precios de Parallel en Google Cloud Marketplace para obtener más información.
Si proporcionas tu propia clave de API, consulta el sitio web de Parallel para obtener más información.