Exa fournit une API de recherche qui donne accès à des données Web accessibles au public, optimisées pour l'ancrage des réponses des grands modèles de langage. Cette page explique comment ancrer les réponses de Gemini à l'aide d'Exa.
L'ancrage avec la recherche sur le Web Exa sur Gemini Enterprise Agent Platform est une Offre distincte (telle que définie dans votre Contrat Google Cloud ) qui connecte les modèles Gemini aux données Web publiques fournies par l'API de recherche d'Exa.
Cas d'utilisation
L'ancrage avec Exa améliore la précision et réduit les hallucinations en donnant aux modèles l'accès à des données Web récentes et pertinentes. Vous trouverez ci-dessous des cas d'utilisation courants :
- Agents généraux et chatbots : récupérez des informations à jour pour produire des réponses plus fiables.
- Agents de recherche : effectuez des recherches approfondies sur le Web à partir de plusieurs sources.
- Agents de codage : récupérez les derniers extraits de code, documents et références techniques.
- Agents vocaux : récupération sur le Web pour prendre en charge les interactions vocales en temps réel et à faible latence.
- Agents spécifiques à un secteur : récupèrent des informations à jour et spécifiques à un domaine, adaptées à un secteur ou à un domaine de connaissances particulier.
- Enrichissement des données : enrichissez les ensembles de données internes avec le contexte et les métadonnées Web actuels.
- Workflows automatisés : collectez régulièrement des données sur l'actualité, les personnes, les entreprises ou d'autres données fréquemment mises à jour pour les workflows internes ou de production.
Exemple
Qui a gagné le Super Bowl 2026 ?
| Sans ancrage | Avec ancrage |
|---|---|
| Je ne peux pas vous dire qui a remporté le Super Bowl 2026, car cet événement n'a pas encore eu lieu. | Les Seahawks de Seattle ont remporté le Super Bowl LX le 8 février 2026 en battant les Patriots de la Nouvelle-Angleterre sur un score final de 29-13. Sources : domain1.com, domain2.com, ... |
Modèles compatibles
Cette section liste les modèles compatibles avec l'ancrage avec la recherche sur le Web Exa.
Cliquez pour développer la liste des modèles compatibles
- Gemini 4 Neon
- Gemini 4 Hydrogen
- Gemini 4 Carbon pour la cybersécurité
- 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
Avant de commencer
Pour utiliser l'ancrage avec Exa, vous devez obtenir une clé API sur le site Web d'Exa. Cette clé API est utilisée dans votre requête adressée à Gemini.
Ancrer les réponses de Gemini avec Exa
Demandez des réponses ancrées à Gemini à l'aide du SDK Google Gen AI ou de l'API REST. Pour des performances optimales, nous vous recommandons d'utiliser les paramètres par défaut pour les paramètres facultatifs, sauf si vous avez absolument besoin de valeurs autres que celles par défaut.
Avant d'exécuter les exemples, remplissez les conditions préalables, y compris l'obtention d'une clé API Exa.
Python
Installer
pip install --upgrade google-genai
Pour en savoir plus, consultez la documentation de référence du SDK.
Définissez des variables d'environnement pour utiliser le SDK Google Gen AI avec 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
Avant d'exécuter l'exemple, effectuez les remplacements suivants :
- MODEL_ID : ID d'un modèle compatible à utiliser, tel que
gemini-2.5-flash. - TEXT : prompt textuel à envoyer au modèle.
- API_KEY : votre clé API pour la recherche sur le Web Exa.
- SEARCH_TYPE (facultatif) : type de recherche Exa à exécuter. Les valeurs acceptées sont
fastetinstant. La valeur par défaut estfast, qui fournit des résultats complets avec une latence réduite et convient aux workflows de recherche et interactifs visibles par l'utilisateur. Utilisezinstantpour les expériences nécessitant la latence la plus faible, telles que le chat, les agents vocaux et la saisie semi-automatique. Il minimise le temps de réponse en privilégiant la vitesse à l'étendue de la recherche. - EXCLUDE_DOMAINS (facultatif) : liste des domaines à exclure des résultats de recherche. Si ce paramètre est spécifié, aucun résultat n'est renvoyé pour ces domaines. Pour exclure plusieurs domaines, ajoutez chaque domaine sous forme de chaîne entre guillemets distincte dans la liste (par exemple,
["example.com", "example.net"]). Vous pouvez spécifier jusqu'à 1 200 domaines. - INCLUDE_DOMAINS (facultatif) : liste des domaines à inclure dans la recherche. Si cette option est spécifiée, les résultats proviennent uniquement de ces domaines. Pour inclure plusieurs domaines, ajoutez chaque domaine sous la forme d'une chaîne entre guillemets distincte dans la liste (par exemple,
["example.com", "example.net"]). Vous pouvez spécifier jusqu'à 1 200 domaines. - MAX_CHARACTERS (facultatif) : nombre maximal de caractères à renvoyer pour les éléments mis en évidence. Contrôle la longueur totale du texte mis en surbrillance renvoyé par URL.
- NUM_RESULTS (facultatif) : nombre maximal de résultats de recherche à utiliser pour l'ancrage. Si aucune valeur n'est spécifiée, la valeur par défaut est
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
Découvrez comment installer ou mettre à jour le Java.
Pour en savoir plus, consultez la documentation de référence du SDK.
Définissez des variables d'environnement pour utiliser le SDK Google Gen AI avec 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
Avant d'exécuter l'exemple, effectuez les remplacements suivants :
- MODEL_ID : ID d'un modèle compatible à utiliser, tel que
gemini-2.5-flash. - TEXT : prompt textuel à envoyer au modèle.
- API_KEY : votre clé API pour la recherche sur le Web Exa.
- SEARCH_TYPE (facultatif) : type de recherche Exa à exécuter. Les valeurs acceptées sont
fastetinstant. La valeur par défaut estfast, qui fournit des résultats complets avec une latence réduite et convient aux workflows de recherche et interactifs visibles par l'utilisateur. Utilisezinstantpour les expériences nécessitant la latence la plus faible, telles que le chat, les agents vocaux et la saisie semi-automatique. Il minimise le temps de réponse en privilégiant la vitesse à l'étendue de la recherche. - EXCLUDE_DOMAINS (facultatif) : liste des domaines à exclure des résultats de recherche. Si ce paramètre est spécifié, aucun résultat n'est renvoyé pour ces domaines. Pour exclure plusieurs domaines, ajoutez chaque domaine sous forme de chaîne entre guillemets distincte dans la liste (par exemple,
["example.com", "example.net"]). Vous pouvez spécifier jusqu'à 1 200 domaines. - INCLUDE_DOMAINS (facultatif) : liste des domaines à inclure dans la recherche. Si cette option est spécifiée, les résultats proviennent uniquement de ces domaines. Pour inclure plusieurs domaines, ajoutez chaque domaine sous la forme d'une chaîne entre guillemets distincte dans la liste (par exemple,
["example.com", "example.net"]). Vous pouvez spécifier jusqu'à 1 200 domaines. - MAX_CHARACTERS (facultatif) : nombre maximal de caractères à renvoyer pour les éléments mis en évidence. Contrôle la longueur totale du texte mis en surbrillance renvoyé par URL.
- NUM_RESULTS (facultatif) : nombre maximal de résultats de recherche à utiliser pour l'ancrage. Si aucune valeur n'est spécifiée, la valeur par défaut est
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
Installer
npm install @google/genai
Pour en savoir plus, consultez la documentation de référence du SDK.
Définissez des variables d'environnement pour utiliser le SDK Google Gen AI avec 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
Avant d'exécuter l'exemple, effectuez les remplacements suivants :
- MODEL_ID : ID d'un modèle compatible à utiliser, tel que
gemini-2.5-flash. - TEXT : prompt textuel à envoyer au modèle.
- API_KEY : votre clé API pour la recherche sur le Web Exa.
- SEARCH_TYPE (facultatif) : type de recherche Exa à exécuter. Les valeurs acceptées sont
fastetinstant. La valeur par défaut estfast, qui fournit des résultats complets avec une latence réduite et convient aux workflows de recherche et interactifs visibles par l'utilisateur. Utilisezinstantpour les expériences nécessitant la latence la plus faible, telles que le chat, les agents vocaux et la saisie semi-automatique. Il minimise le temps de réponse en privilégiant la vitesse à l'étendue de la recherche. - EXCLUDE_DOMAINS (facultatif) : liste des domaines à exclure des résultats de recherche. Si ce paramètre est spécifié, aucun résultat n'est renvoyé pour ces domaines. Pour exclure plusieurs domaines, ajoutez chaque domaine sous forme de chaîne entre guillemets distincte dans la liste (par exemple,
["example.com", "example.net"]). Vous pouvez spécifier jusqu'à 1 200 domaines. - INCLUDE_DOMAINS (facultatif) : liste des domaines à inclure dans la recherche. Si cette option est spécifiée, les résultats proviennent uniquement de ces domaines. Pour inclure plusieurs domaines, ajoutez chaque domaine sous la forme d'une chaîne entre guillemets distincte dans la liste (par exemple,
["example.com", "example.net"]). Vous pouvez spécifier jusqu'à 1 200 domaines. - MAX_CHARACTERS (facultatif) : nombre maximal de caractères à renvoyer pour les éléments mis en évidence. Contrôle la longueur totale du texte mis en surbrillance renvoyé par URL.
- NUM_RESULTS (facultatif) : nombre maximal de résultats de recherche à utiliser pour l'ancrage. Si aucune valeur n'est spécifiée, la valeur par défaut est
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
Avant d'utiliser des données de requête, effectuez les remplacements suivants :
- LOCATION : région dans laquelle traiter la requête. Pour utiliser le point de terminaison global, excluez l'emplacement du nom du point de terminaison et configurez l'emplacement de la ressource sur "global".
- PROJECT_ID : ID de votre projet Google Cloud .
- MODEL_ID : ID du modèle à utiliser.
- TEXT : prompt textuel à envoyer au modèle.
- API_KEY : votre clé API pour la recherche sur le Web Exa.
- SEARCH_TYPE (facultatif) : type de recherche Exa à exécuter. Les valeurs acceptées sont
fastetinstant. La valeur par défaut estfast, qui fournit des résultats complets avec une latence réduite et convient parfaitement aux recherches visibles par l'utilisateur et aux workflows interactifs. Utilisezinstantpour les expériences nécessitant la latence la plus faible, telles que le chat, les agents vocaux et la saisie semi-automatique. Il minimise le temps de réponse en privilégiant la vitesse par rapport à l'étendue de la recherche. - EXCLUDE_DOMAINS (facultatif) : liste des domaines à exclure des résultats de recherche. Si vous spécifiez des domaines, aucun résultat ne sera renvoyé pour ceux-ci. Vous pouvez spécifier jusqu'à 1 200 domaines.
- INCLUDE_DOMAINS (facultatif) : liste des domaines à inclure dans la recherche. Si cette option est spécifiée, les résultats ne proviendront que de ces domaines. Vous pouvez spécifier jusqu'à 1 200 domaines.
- MAX_CHARACTERS (facultatif) : nombre maximal de caractères à renvoyer pour les éléments mis en évidence. Contrôle la longueur totale du texte mis en surbrillance renvoyé par URL.
- NUM_RESULTS (facultatif) : nombre maximal de résultats de recherche à utiliser pour l'ancrage. Si aucune valeur n'est spécifiée, la valeur par défaut est
5.
Méthode HTTP et URL :
POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent
Corps JSON de la requête :
{
"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"
}
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON semblable à la suivante.
Quota
Le quota par défaut est de 200 requêtes par minute. Si vous devez augmenter vos limites de débit, contactez support@exa.ai et l'équipe de votre compte Google en indiquant votre cas d'utilisation et vos exigences.
Facturation
L'utilisation de l'ancrage avec Exa entraîne les frais suivants :
- Consommation de jetons Gemini : jetons de prompt, jetons de raisonnement, jetons de sortie. Pour en savoir plus, reportez-vous à la page Tarifs.
- Ancrage de Gemini avec vos données : pour en savoir plus, consultez la page Tarifs.
- Tarifs d'utilisation de l'API de recherche d'Exa : pour en savoir plus, consultez la page des tarifs d'Exa.