Les extraits de Brave LLM Context peuvent-ils contenir des tableaux sérialisés ou du code ?

L'équipe Citead, mis à jour le

En bref. Brave documente des extraits mêlant texte brut et données structurées sérialisées en JSON, dont le contenu est renvoyé sous grounding.generic.

Définition : Oui. La documentation de l’API LLM Context de Brave décrit des extraits (snippets) pouvant contenir du texte brut ou des données structurées sérialisées en JSON, notamment des tableaux, des schémas et des blocs de code. La réponse place ces extraits dans des éléments de contenu sous grounding.generic.

Points clés

  • Brave indique que LLM Context peut extraire du texte, du Markdown, du JSON, des tableaux de données et du code à destination d’un agent ou d’un modèle. Sa documentation LLM Context les présente comme des cas d’usage.
  • La même documentation précise que les extraits peuvent contenir du texte brut ou des données structurées sérialisées en JSON, notamment des tableaux, des schémas et des blocs de code.
  • La référence de l’API LLM Context de Brave décrit grounding.generic comme un tableau d’éléments de contexte contenant des données extraites du Web.
  • La réponse sépare le contenu de grounding des métadonnées de sources : dans cette structure, un extrait est donc associé à l’URL et au titre d’une source.

Comment les extraits de formats différents sont-ils représentés ?

La documentation LLM Context de Brave décrit un point de terminaison de recherche qui renvoie des fragments extraits des pages et des métadonnées sur les sources à destination d’un LLM. La réponse documentée organise le contenu extrait du Web sous grounding, où grounding.generic contient des objets associés à des URL. Chaque objet possède un champ url, un champ title et un tableau snippets.

Dans l’exemple, les éléments du tableau d’extraits sont des chaînes entre guillemets. Une chaîne peut contenir du texte courant, et ce même champ peut contenir des données structurées sérialisées en JSON lorsque Brave extrait un tableau, un schéma ou un bloc de code. L’avertissement de la documentation concerne donc le post-traitement : l’application qui exploite la réponse doit accepter à la fois le texte brut et les structures sérialisées.

{
  "grounding": {
    "generic": [
      {
        "url": "https://example.com/page",
        "title": "Page Title",
        "snippets": [
          "Relevant text chunk extracted from the page...",
          "Another relevant passage from the same page..."
        ]
      }
    ]
  }
}

Quelles limites l’API impose-t-elle ?

La référence de l’API de Brave définit maximum_number_of_snippets comme le nombre maximal d’extraits distincts, ou fragments de texte, inclus dans le contexte du LLM. Sa valeur par défaut est 50 et son maximum est 256. La même référence définit maximum_number_of_tokens_per_url avec une valeur par défaut de 4096 et un maximum de 8192. Ces paramètres limitent la quantité de contexte récupéré, que l’extrait contienne du texte courant ou une structure sérialisée.

Le journal des modifications de la documentation présente une mise à jour datée du 31 juillet 2026 : maximum_number_of_snippets et maximum_number_of_snippets_per_url ne limitent plus la réponse lorsque le budget de jetons (tokens) permet de renvoyer davantage d’extraits. Dans ce cas documenté, le budget de jetons détermine donc la limite applicable.

Que peut en déduire le propriétaire d’un site ?

La documentation LLM Context établit que l’extracteur de Brave peut renvoyer des tableaux, des schémas et des blocs de code sous forme de données sérialisées en JSON dans les extraits. Elle ne fournit pas de méthode de balisage à appliquer sur la page pour faire apparaître un tableau ou un bloc de code donné dans un extrait précis. L’examen d’un site peut donc porter sur la présence des informations dans la page source sous forme de texte lisible, de tableau, de schéma ou de bloc de code, tandis que l’application qui exploite l’API prévoit de traiter aussi bien du texte brut que des données structurées sérialisées.

Termes connexes

Questions fréquentes

Une même réponse peut-elle contenir du texte brut et des extraits structurés ?

Oui. La documentation LLM Context de Brave décrit explicitement un format mixte et précise que le post-traitement doit prendre en charge aussi bien le texte brut que les données structurées sérialisées en JSON.

Un tableau de données est-il renvoyé sous forme d’objet natif ?

La même documentation décrit le contenu structuré comme des données sérialisées en JSON à l’intérieur d’un extrait. Le schéma de réponse présente par ailleurs snippets comme un tableau de fragments de texte extraits : le format documenté pour l’application qui exploite la réponse prévoit donc un tableau de valeurs d’extraits, sans champ distinct réservé aux tableaux de données.

L’API peut-elle renvoyer du code dans un extrait ?

Oui. La même documentation mentionne l’extraction de code pour répondre à des questions techniques parmi les cas d’usage de LLM Context et inclut les blocs de code parmi les données structurées que les extraits peuvent contenir.

Sources

  1. Brave, « LLM Context: Web search for AI agents and chatbots », sans date
  2. Brave, « 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

Testez une page et voyez quoi corriger en premier

L'analyse prend en général moins de 10 secondes et ne demande pas de compte.

400 000+ pages notées dans le benchmark public