Comment activer le mode recherche dans l’API Answers de Brave ?

Définition : L’API Answers de Brave produit des réponses fondées sur la recherche web. Au 17 octobre 2026, le mode recherche permet des recherches itératives avec enable_research: true et nécessite stream: true.

Points clés

• La documentation Answers de Brave décrit le mode recherche comme une succession de recherches au cours desquelles le modèle affine sa stratégie ; le temps de réponse peut atteindre plusieurs minutes.
• La référence de l’API Answers définit enable_research comme un booléen dont la valeur par défaut est false.
• Le guide d’intégration Answers de Brave décrit les événements de progression et la réponse finale contenant des citations en mode recherche.

Comment activer le mode recherche dans une requête ?

La documentation Answers place l’option de recherche dans extra_body lors de l’utilisation du SDK Python d’OpenAI. Le client utilise une clé d’API Brave Search et l’URL de base de Brave. L’exemple suivant reprend cette configuration documentée et lit le contenu reçu en flux continu (streaming) :

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_BRAVE_SEARCH_API_KEY",
    base_url="https://api.search.brave.com/res/v1",
)

stream = client.chat.completions.create(
    model="brave",
    messages=[{"role": "user", "content": "History of quantum mechanics"}],
    stream=True,
    extra_body={"enable_research": True},
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Dans une requête JSON directe, enable_research se place dans le corps de la requête. Le guide d’intégration de Brave présente cette forme avec stream défini sur true.

Qu’est-ce qui change dans le déroulement de la réponse ?

La documentation Answers de Brave indique qu’une recherche unique constitue le fonctionnement par défaut. Le mode recherche effectue des recherches successives et traite un contexte plus volumineux, ce qui augmente le coût. Brave le recommande pour les tâches en arrière-plan où l’approfondissement prime sur la rapidité.

Le guide d’intégration décrit un flux contenant des messages balisés. La balise <progress> fournit des statistiques telles que les itérations, les requêtes et le temps écoulé. La balise <answer> contient la réponse de synthèse finale ; les versions intermédiaires sont écartées. La balise <usage>, en fin de flux, contient les données de coût et de jetons (tokens). Une application doit donc distinguer les informations de progression de la réponse finale lors de l’affichage.

Quels paramètres limitent le travail de recherche ?

La référence de l’API expose plusieurs limites de recherche. La valeur par défaut de research_maximum_number_of_queries est 20, celle de research_maximum_number_of_iterations est 4 et celle de research_maximum_number_of_seconds est 180. Ces paramètres limitent respectivement le nombre total de recherches, le nombre d’itérations et le temps de recherche.

research_maximum_number_of_results_per_query contrôle le nombre maximal de résultats pris en compte par recherche. Sa valeur par défaut est 30, et les valeurs acceptées vont de 1 à 60. research_allow_thinking est accepté pour des raisons de compatibilité, mais ignoré : le moteur effectue la recherche avec le raisonnement étendu désactivé.

Termes associés

• Brave Answers API
• Comment lire les citations diffusées en continu par l’API Answers de Brave ?
• Brave Search API
• Recherche agentique

Questions fréquentes

Faut-il aussi activer enable_citations ?

La référence de l’API de Brave indique que enable_citations n’est pas pris en charge en mode recherche. Vous pouvez utiliser les citations intégrées aux réponses du mode recherche, décrites dans le guide d’intégration, sans activer cette option distincte.

Peut-on utiliser le mode recherche avec stream: false ?

Vous devez définir stream: true. La même référence de l’API impose explicitement le streaming pour enable_research.

Sources

1. Brave, « Answers », consulté le 17 octobre 2026
2. Brave, « Answers API reference », consulté le 17 octobre 2026
3. Brave, « Answers integration guide (skills/answers/SKILL.md) », consulté le 17 octobre 2026

---

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO