Comment une intégration de Brave LLM Context peut-elle conserver le pipeline de traitement du contenu précédent ?

Définition : Dans Brave LLM Context, le verrouillage de version (version pinning) consiste à envoyer l’en-tête de requête Api-Version avec une valeur datée pour que le point de terminaison utilise un comportement précis de l’API. Brave indique que la valeur Api-Version: 2026-02-06 conserve le pipeline de traitement du contenu utilisé avant le changement de comportement par défaut du 31 juillet 2026.

Points clés

• Brave décrit LLM Context comme un service de recherche web avec du contenu préextrait destiné aux agents d’IA, à l’ancrage (grounding) et aux pipelines de génération augmentée par récupération (retrieval augmented generation) dans sa documentation LLM Context.
• Le journal des modifications de LLM Context indique qu’un nouveau pipeline de traitement du contenu devient le pipeline par défaut le 31 juillet 2026 et précise que Api-Version: 2026-02-06 correspond au pipeline précédent.
• Le guide de gestion des versions de Brave indique que les requêtes sans en-tête de version utilisent la dernière version et que Api-Version verrouille le comportement sur une version précise.
• La référence de l’API LLM Context définit le format de version de l’API comme YYYY-MM-DD et indique que la valeur par défaut correspond à la dernière version disponible.

Quel en-tête conserve le pipeline précédent ?

L’en-tête daté s’ajoute à chaque requête dont le comportement doit rester celui du pipeline de traitement du contenu précédent. Sa valeur est une date au format YYYY-MM-DD. Pour ce changement, Brave indique 2026-02-06, la date de lancement consignée dans le journal des modifications de LLM Context.

Api-Version: 2026-02-06

L’en-tête accompagne le jeton d’abonnement. Le point de terminaison LLM Context accepte les méthodes GET et POST, et la documentation indique l’adresse https://api.search.brave.com/res/v1/llm/context.

Que se passe-t-il en l’absence de cet en-tête ?

Le guide de gestion des versions de Brave précise qu’une requête sans en-tête de version utilise la dernière version de l’API. La référence de l’API indique la même valeur par défaut pour son champ de version. Une intégration qui omet Api-Version suit donc le comportement par défaut choisi par Brave, y compris les changements ultérieurs de ce comportement documentés pour le service.

Brave distingue deux mécanismes de gestion des versions. Une version majeure telle que v1 figure dans l’URL de la requête et est réservée à une refonte majeure de l’API. Un en-tête Api-Version daté sélectionne un comportement au sein de cette version d’URL et permet de passer aux versions qui introduisent des changements incompatibles avec les versions précédentes.

Comment appliquer le verrouillage dans une intégration ?

L’en-tête se configure dans le client HTTP partagé ou dans la couche commune d’envoi des requêtes utilisée pour les deux méthodes. Sa valeur se conserve avec la configuration du point de terminaison de l’intégration, afin que les nouvelles tentatives et les requêtes provenant des différentes parties de l’application envoient la même version. La structure reste celle d’un appel LLM Context habituel, avec sa requête de recherche ou son corps JSON et l’authentification par X-Subscription-Token.

curl -X GET "https://api.search.brave.com/res/v1/llm/context?q=your+query" \
  -H "X-Subscription-Token: <YOUR_API_KEY>" \
  -H "Api-Version: 2026-02-06"

Le guide de gestion des versions décrit l’ajout de paramètres de requête ou d’en-têtes facultatifs et l’ajout de propriétés de réponse comme des changements rétrocompatibles. Il classe la suppression d’un paramètre de requête ou d’un en-tête, la suppression ou le renommage de propriétés de réponse et le changement de type des propriétés parmi les changements incompatibles avec les versions précédentes.

Comment vérifier le verrouillage de version ?

La vérification consiste à inspecter la requête sortante à la sortie du client HTTP et à confirmer la présence de l’en-tête avec la valeur exacte 2026-02-06. La même requête de recherche est ensuite testée via l’intégration déployée après les changements de configuration. L’absence de l’en-tête est visible dans la configuration de la requête et conduit Brave à utiliser la dernière version, conformément au guide de gestion des versions.

La documentation publique nomme le pipeline précédent et la valeur qui le sélectionne, mais ne décrit aucun champ de réponse indiquant quel pipeline de traitement du contenu a traité une requête donnée. La vérification commence donc par l’en-tête sortant et le contexte renvoyé que l’intégration exploite.

Termes associés

• En quoi Brave LLM Context diffère-t-il des résultats web classiques ?
• Comment filtrer les fragments de texte peu pertinents dans Brave LLM Context ?
• Comment obtenir l’heure de la dernière récupération par l’index dans le contexte Brave ?
• Brave Search API

Questions fréquentes

Quelle valeur envoyer pour conserver le pipeline précédent ?

Envoyez Api-Version: 2026-02-06 avec chaque requête LLM Context qui doit utiliser le pipeline précédent indiqué dans le journal des modifications de Brave du 31 juillet 2026.

Api-Version est-il un paramètre de requête ?

Non. La référence de l’API répertorie api-version dans sa section Headers, et le guide de gestion des versions de Brave décrit Api-Version comme un en-tête de requête.

Quelle version le service utilise-t-il sans cet en-tête ?

Il utilise la dernière version disponible de l’API. Fixez la valeur datée de l’en-tête lorsque l’intégration dépend du pipeline précédent.

Sources

1. Brave Search API, « LLM Context: Web search for AI agents and chatbots », journal des modifications du 31 juillet 2026
2. Brave Search API, « Versioning », sans date
3. Brave Search API, « LLM Context: Web search API for AI agents », sans date

---

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