Exa proporciona una API de búsqueda que brinda acceso a datos web disponibles públicamente optimizados para fundamentar las respuestas de modelos de lenguaje grandes. En esta página, se explica cómo fundamentar las respuestas de Gemini con Exa.
La fundamentación con la búsqueda web de Exa 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 Exa.
Casos de uso
La fundamentación con Exa mejora la precisión y reduce las alucinaciones, ya que les brinda a los modelos acceso a datos web actualizados y pertinentes. Los casos de uso comunes incluyen los siguientes:
- Agentes generales y chatbots: Recupera información actualizada para producir respuestas más confiables.
- Agentes de investigación: Realizan investigaciones profundas en la Web con varias fuentes.
- Agentes de programación: Extraen los fragmentos de código, los documentos y las referencias técnicas más recientes.
- Agentes de voz: Recuperación web para admitir interacciones de voz en tiempo real y de baja latencia.
- Agentes específicos de verticales: Recuperan información actualizada y específica de un dominio, adaptada a una industria o vertical de conocimiento en particular.
- Enriquecimiento de datos: Aumenta los conjuntos de datos internos con el contexto y los metadatos web actuales.
- Flujos de trabajo automatizados: Recopila periódicamente noticias, personas, empresas o cualquier otro dato que se actualice con frecuencia para los flujos de trabajo internos o de producción.
Ejemplo
¿Quién ganó el Super Bowl de 2026?
| Sin fundamentación | Con fundamentación |
|---|---|
| No puedo decirte quién ganó el Super Bowl 2026, ya que ese evento aún no se llevó a cabo. | Los Seattle Seahawks ganaron el Super Bowl LX el 8 de febrero de 2026, tras derrotar a los New England Patriots con un resultado final de 29-13. 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 Exa.
Haz clic para expandir los modelos compatibles
- Gemini 4 Neon
- Gemini 4 Hydrogen
- Gemini 4 Carbon para la seguridad cibernética
- Gemini 4 Carbon
- Gemini 4 Argon Cyber Permissive
- Gemini 4 Argon
- Gemini 3.8 Flash
- Gemini 3.7 Flash
- Gemini 3.6 Flash
- Gemini 3.5 Flash-Lite
- Gemini 3.5 Flash
- Gemini 3.1 Pro
- Gemini 3.1 Flash-Lite
- Gemini 2.5 Pro
- Gemini 2.5 Flash-Lite
- Gemini 2.5 Flash
Antes de comenzar
Para usar la fundamentación con Exa, debes obtener una clave de API del sitio web de Exa. Esta clave de API se usa en tu solicitud a Gemini.
Fundamenta las respuestas de Gemini con Exa
Solicita respuestas fundamentadas de Gemini con 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.
Antes de ejecutar las muestras, completa los requisitos previos, lo que incluye obtener una clave de API de Exa.
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 la búsqueda web de Exa.
- SEARCH_TYPE: Es opcional y se refiere al tipo de búsqueda de Exa
que se ejecutará. Los valores admitidos son
fastyinstant. El valor predeterminado esfast, que proporciona resultados completos con una latencia reducida y es una buena opción para la búsqueda para el usuario y los flujos de trabajo interactivos. Usainstantpara experiencias que requieran la latencia más baja, como chat, agentes de voz y autocompletado, ya que minimiza el tiempo de respuesta priorizando la velocidad sobre la promedio de páginas vistas por búsqueda. - EXCLUDE_DOMAINS: Es una lista de dominios que se excluirán de los resultados de la búsqueda (opcional). Si se especifica, no se devuelven resultados de estos dominios. Para
excluir más de un dominio, agrega cada uno como una cadena entre comillas separada en la lista (por
ejemplo,
["example.com", "example.net"]). Puedes especificar hasta 1,200 dominios. - INCLUDE_DOMAINS: Es opcional y se refiere a la lista de dominios que se incluirán en la búsqueda. Si se especifica, los resultados provienen solo de estos dominios. Para incluir más
de un dominio, agrega cada uno como una cadena entre comillas independiente en la lista (por ejemplo,
["example.com", "example.net"]). Puedes especificar hasta 1,200 dominios. - MAX_CHARACTERS: Es opcional y se refiere a la cantidad máxima de caracteres que se mostrarán en los aspectos destacados. Controla la longitud total del texto destacado que se devuelve por URL.
- NUM_RESULTS: Es opcional y se refiere a la cantidad máxima de resultados de la búsqueda
que se usarán para fundamentar la respuesta.
Si no se especifica, el valor predeterminado es
5.
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(
exa_ai_search=types.ToolExaAiSearch(
# Required. Your API key for Exa web search.
api_key="API_KEY",
# Optional. Customize the search. Click a placeholder to
# enter a value, or remove the line to accept the default.
custom_configs={
"type": "SEARCH_TYPE",
"excludeDomains": ["EXCLUDE_DOMAINS"],
"includeDomains": ["INCLUDE_DOMAINS"],
"contents": {
"highlights": {
"maxCharacters": MAX_CHARACTERS,
},
},
"numResults": NUM_RESULTS,
},
)
)
],
),
)
print(response.text)
# 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 la búsqueda web de Exa.
- SEARCH_TYPE: Es opcional y se refiere al tipo de búsqueda de Exa
que se ejecutará. Los valores admitidos son
fastyinstant. El valor predeterminado esfast, que proporciona resultados completos con una latencia reducida y es una buena opción para la búsqueda para el usuario y los flujos de trabajo interactivos. Usainstantpara experiencias que requieran la latencia más baja, como chat, agentes de voz y autocompletado, ya que minimiza el tiempo de respuesta priorizando la velocidad sobre la promedio de páginas vistas por búsqueda. - EXCLUDE_DOMAINS: Es una lista de dominios que se excluirán de los resultados de la búsqueda (opcional). Si se especifica, no se devuelven resultados de estos dominios. Para
excluir más de un dominio, agrega cada uno como una cadena entre comillas separada en la lista (por
ejemplo,
["example.com", "example.net"]). Puedes especificar hasta 1,200 dominios. - INCLUDE_DOMAINS: Es opcional y se refiere a la lista de dominios que se incluirán en la búsqueda. Si se especifica, los resultados provienen solo de estos dominios. Para incluir más
de un dominio, agrega cada uno como una cadena entre comillas independiente en la lista (por ejemplo,
["example.com", "example.net"]). Puedes especificar hasta 1,200 dominios. - MAX_CHARACTERS: Es opcional y se refiere a la cantidad máxima de caracteres que se mostrarán en los aspectos destacados. Controla la longitud total del texto destacado que se devuelve por URL.
- NUM_RESULTS: Es opcional y se refiere a la cantidad máxima de resultados de la búsqueda
que se usarán para fundamentar la respuesta.
Si no se especifica, el valor predeterminado es
5.
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.ToolExaAiSearch;
import java.util.List;
import java.util.Map;
public class ExaGroundingSample {
public static void main(String[] args) {
try (Client client = Client.builder().build()) {
GenerateContentConfig config =
GenerateContentConfig.builder()
.tools(
Tool.builder()
.exaAiSearch(
ToolExaAiSearch.builder()
// Required. Your API key for Exa web search.
.apiKey("API_KEY")
// Optional. Customize the search. Click a
// placeholder to enter a value, or remove the
// entry to accept the default.
.customConfigs(
Map.of(
"type", "SEARCH_TYPE",
"excludeDomains",
List.of("EXCLUDE_DOMAINS"),
"includeDomains",
List.of("INCLUDE_DOMAINS"),
"contents",
Map.of(
"highlights",
Map.of(
"maxCharacters",
MAX_CHARACTERS)),
"numResults", NUM_RESULTS))
.build())
.build())
.build();
GenerateContentResponse response =
client.models.generateContent(
"MODEL_ID", "TEXT", config);
System.out.println(response.text());
// The grounding metadata contains the web sources used to ground the response.
System.out.println(
response.candidates().get().get(0).groundingMetadata().get().groundingChunks().get());
}
}
}
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 la búsqueda web de Exa.
- SEARCH_TYPE: Es opcional y se refiere al tipo de búsqueda de Exa
que se ejecutará. Los valores admitidos son
fastyinstant. El valor predeterminado esfast, que proporciona resultados completos con una latencia reducida y es una buena opción para la búsqueda para el usuario y los flujos de trabajo interactivos. Usainstantpara experiencias que requieran la latencia más baja, como chat, agentes de voz y autocompletado, ya que minimiza el tiempo de respuesta priorizando la velocidad sobre la promedio de páginas vistas por búsqueda. - EXCLUDE_DOMAINS: Es una lista de dominios que se excluirán de los resultados de la búsqueda (opcional). Si se especifica, no se devuelven resultados de estos dominios. Para
excluir más de un dominio, agrega cada uno como una cadena entre comillas separada en la lista (por
ejemplo,
["example.com", "example.net"]). Puedes especificar hasta 1,200 dominios. - INCLUDE_DOMAINS: Es opcional y se refiere a la lista de dominios que se incluirán en la búsqueda. Si se especifica, los resultados provienen solo de estos dominios. Para incluir más
de un dominio, agrega cada uno como una cadena entre comillas independiente en la lista (por ejemplo,
["example.com", "example.net"]). Puedes especificar hasta 1,200 dominios. - MAX_CHARACTERS: Es opcional y se refiere a la cantidad máxima de caracteres que se mostrarán en los aspectos destacados. Controla la longitud total del texto destacado que se devuelve por URL.
- NUM_RESULTS: Es opcional y se refiere a la cantidad máxima de resultados de la búsqueda
que se usarán para fundamentar la respuesta.
Si no se especifica, el valor predeterminado es
5.
import {GoogleGenAI} from '@google/genai';
const ai = new GoogleGenAI({});
const response = await ai.models.generateContent({
model: 'MODEL_ID',
contents: 'TEXT',
config: {
tools: [
{
exaAiSearch: {
// Required. Your API key for Exa web search.
apiKey: 'API_KEY',
// Optional. Customize the search. Click a placeholder to enter a
// value, or remove the line to accept the default.
customConfigs: {
type: 'SEARCH_TYPE',
excludeDomains: ['EXCLUDE_DOMAINS'],
includeDomains: ['INCLUDE_DOMAINS'],
contents: {
highlights: {
maxCharacters: MAX_CHARACTERS,
},
},
numResults: NUM_RESULTS,
},
},
},
],
},
});
console.log(response.text);
// The grounding metadata contains the web sources used to ground the response.
console.log(response.candidates[0].groundingMetadata.groundingChunks);
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 de Exa.
- SEARCH_TYPE: Es opcional y se refiere al tipo de búsqueda de Exa
que se ejecutará. Los valores admitidos son
fastyinstant. El valor predeterminado esfast, que proporciona resultados completos con latencia reducida y es una buena opción para la búsqueda para el usuario y los flujos de trabajo interactivos. Usainstantpara experiencias que requieran la latencia más baja, como chat, agentes de voz y autocompletado, ya que minimiza el tiempo de respuesta priorizando la velocidad sobre la promedio de páginas vistas por búsqueda. - EXCLUDE_DOMAINS: Es una lista de dominios que se excluirán de los resultados de la búsqueda (opcional). Si se especifica, no se mostrarán resultados de estos dominios. Puedes especificar hasta 1,200 dominios.
- INCLUDE_DOMAINS: Es opcional y se refiere a la lista de dominios que se incluirán en la búsqueda. Si se especifica, los resultados solo provendrán de estos dominios. Puedes especificar hasta 1,200 dominios.
- MAX_CHARACTERS: Es la cantidad máxima de caracteres que se mostrarán para los aspectos destacados (opcional). Controla la longitud total del texto destacado que se devuelve por URL.
- NUM_RESULTS: Es opcional y se refiere a 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
5.
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": [{
"exaAiSearch": {
"api_key": "API_KEY",
"customConfigs": {
"type": "SEARCH_TYPE",
"excludeDomains": ["EXCLUDE_DOMAINS"],
"includeDomains": ["INCLUDE_DOMAINS"],
"contents": {
"highlights": {
"maxCharacters": MAX_CHARACTERS
}
},
"numResults": NUM_RESULTS
}
}
}],
"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. Si necesitas aumentar tus límites de frecuencia, comunícate con support@exa.ai y con el equipo de cuentas de Google para indicarles tu caso de uso y tus requisitos.
Facturación
El uso de la Fundamentación con Exa genera los siguientes cargos:
- Consumo de tokens de Gemini: Tokens de instrucción, tokens de razonamiento y 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 de Exa: Para obtener más información, consulta la página de precios de Exa.