Dans Brave LLM Context, en quoi le nombre de résultats candidats diffère-t-il de la limite d’URL renvoyées ?

Définition : Dans Brave LLM Context, count limite le nombre de résultats de recherche examinés lors de la sélection du contexte, tandis que maximum_number_of_urls limite le nombre d’URL distinctes incluses dans le contexte renvoyé. Les deux paramètres ont une valeur par défaut de 20 et acceptent des valeurs de 1 à 50.

Points clés

• Brave définit count comme le nombre maximal de résultats de recherche examinés pour sélectionner les données de contexte destinées au LLM dans sa référence de l’API.
• Brave définit maximum_number_of_urls comme le nombre maximal d’URL distinctes à inclure dans le contexte du LLM dans la même référence de l’API.
• La documentation de LLM Context indique pour les deux paramètres une valeur par défaut de 20 et une plage de 1 à 50.
• Le service renvoie des fragments extraits des pages et des métadonnées sur les sources, plutôt que les seuls titres et courts extraits utilisés par le service Web Search classique, selon la documentation de LLM Context de Brave.

Que limite chaque paramètre ?

count fixe le budget de résultats candidats en amont. La référence de l’API Brave le décrit comme le nombre maximal de résultats de recherche examinés pour sélectionner les données de contexte du LLM. Les candidats sont des résultats de recherche : ce paramètre détermine donc l’étendue de l’ensemble que l’étape de sélection peut examiner.

maximum_number_of_urls fixe le budget d’URL du contexte renvoyé. Brave le décrit comme le nombre maximal d’URL distinctes à inclure dans le contexte du LLM. L’unité est une URL distincte, tandis que count s’exprime en résultats de recherche examinés. Une requête peut donc associer un nombre plus élevé de résultats candidats à une limite d’URL plus basse lorsqu’une application souhaite que la sélection porte sur davantage de résultats, mais que le contexte contienne moins de pages sources.

Le point de terminaison documenté accepte les requêtes GET et POST. Une requête GET peut exprimer ces deux budgets sous forme de paramètres de requête :

curl -G "https://api.search.brave.com/res/v1/llm/context" \
  -H "X-Subscription-Token: <YOUR_API_KEY>" \
  --data-urlencode "q=web accessibility requirements" \
  --data-urlencode "count=50" \
  --data-urlencode "maximum_number_of_urls=5"

Pourquoi la réponse peut-elle contenir moins d’URL ?

La limite d’URL est un plafond parmi plusieurs. Brave documente aussi maximum_number_of_tokens, avec une valeur par défaut de 8192 et une plage de 1024 à 32768, ainsi que maximum_number_of_tokens_per_url, avec une valeur par défaut de 4096 et une plage de 512 à 8192. Ces budgets de jetons (tokens) influent sur la quantité de contenu extrait qui peut tenir dans le contexte.

Le filtrage par pertinence influe également sur l’inclusion du contenu. La documentation énumère strict, balanced, lenient et disabled parmi les options de context_threshold_mode et précise que ce paramètre règle le degré de sélectivité du filtrage par pertinence de l’API. La référence de l’API décrit chaque élément générique renvoyé comme comprenant une URL source, un titre de page et des fragments de texte extraits, sélectionnés pour leur pertinence par rapport à la requête.

La référence de l’API décrit le paramètre du nombre total de jetons comme un maximum approximatif de jetons à inclure dans le contexte, et le paramètre par URL comme un nombre maximal de jetons à inclure pour chaque URL. Ces budgets de jetons sont distincts du plafond d’URL distinctes.

Comment une intégration doit-elle examiner le résultat ?

Le schéma de réponse sépare le contenu des métadonnées sur les URL. Brave décrit grounding.generic comme un tableau d’éléments de contexte destinés au LLM contenant du contenu web extrait, et sources comme les métadonnées de toutes les URL référencées, indexées par URL. L’examen des URL dans grounding.generic permet de compter les éléments génériques de contexte renvoyés ; l’objet sources fournit ensuite les métadonnées associées à ces URL.

Les deux paramètres ne décrivent pas un nombre de citations. Ils décrivent des réglages de recherche et d’assemblage du contexte dans une API dont la sortie annoncée est du contenu préalablement extrait pour un LLM ou un agent d’IA. Le service LLM Context documenté est optimisé pour une seule recherche par requête, tandis que le service distinct Answers est l’interface que Brave documente pour produire des réponses complètes avec citations.

Termes associés

• Brave Search API
• Brave utilise-t-il son propre index pour ses réponses IA ?
• Fenêtre de contexte

Questions fréquentes

Si count vaut 50, la réponse contiendra-t-elle 50 URL ?

Non. count est le nombre maximal de résultats de recherche examinés lors de la sélection du contexte. maximum_number_of_urls plafonne séparément le nombre d’URL distinctes incluses dans le contexte ; la pertinence et les budgets de jetons influent aussi sur la réponse.

Si maximum_number_of_urls vaut 5, Brave examinera-t-il seulement cinq candidats ?

Non. Le paramètre d’URL limite le nombre d’URL distinctes dans le contexte renvoyé. Le budget de résultats candidats reste régi par count, dont le maximum documenté est 50.

Quel paramètre utiliser pour limiter la taille du contexte ?

Utilisez maximum_number_of_urls pour plafonner le nombre d’URL sources, et les paramètres de jetons pour plafonner la taille du contexte. La documentation de Brave recommande de commencer par les valeurs par défaut et d’ajuster les budgets à la tâche.

Sources

1. Brave, « LLM Context: Web search for AI agents and chatbots », sans date
2. Brave, « LLM Context API reference », sans date
3. Brave Search, « LLM Context skill », sans date

---

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