Recherche web

En plus des bases de connaissance, le modèle peut disposer d’outils web : il décide lui-même de chercher sur le web et de lire des pages, enchaîne plusieurs appels si besoin, puis répond — exactement comme le mode agentique du RAG.

Activez-les avec le paramètre tools_enabled :

curl https://api.astrolabe.chat/v1/chat/completions \
  -H "Authorization: Bearer $ASTROLABE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistral-large",
    "messages": [{ "role": "user", "content": "Quelle est la dernière version stable de Next.js ? Cite une source." }],
    "tools_enabled": ["web_search", "web_fetch"],
    "tools_max_steps": 4
  }'

Paramètres

Paramètre	Type	Description
tools_enabled	string[]	Outils à activer : "web_search" (recherche) et/ou "web_fetch" (lecture de page). Vide ou absent = aucun outil web.
tools_max_steps	number	(optionnel, défaut 8, max 15) Nombre maximum de tours d’outils autorisés (borne le coût).

Les deux outils

• web_search — recherche web (type moteur de recherche). Le modèle fournit une requête (query) et reçoit une liste de résultats (titre, url, extrait). Options : top_k (1–10), recency (day/week/month/year).
• web_fetch — lit le contenu texte d’une page (URL http/https) trouvée via web_search. Lecture statique (pas d’exécution JavaScript) ; les pages privées/locales sont bloquées.

Combiner avec les bases de connaissance

tools_enabled et knowledge_base_mode: "agentic" coexistent : dans la même réflexion, l’agent peut interroger vos bases et le web, et choisir lui-même quel outil utiliser pour quelle sous-question.

curl https://api.astrolabe.chat/v1/chat/completions \
  -H "Authorization: Bearer $ASTROLABE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistral-large",
    "messages": [{ "role": "user", "content": "Combien de dossiers en alerte dans notre base, et une actu récente sur notre secteur ?" }],
    "knowledge_base": "suivi-clients",
    "knowledge_base_mode": "agentic",
    "tools_enabled": ["web_search", "web_fetch"]
  }'

À savoir

• Non-streaming : comme le mode agentique, la réponse arrive en une fois (stream: true est ignoré). Idéal pour les automatisations (Make/n8n).
• Coût : deux composantes. (1) Les tokens des appels modèle (un par tour + la réponse) → tools_max_steps borne le nombre de tours. (2) Un forfait de 0,01 € par recherche (web_search) exécutée ; web_fetch (lecture de page) est inclus. Le forfait apparaît dans le coût de la requête au playground et est décompté de vos crédits comme le reste.
• Réflexion : les recherches lancées par l’agent sont renvoyées dans astrolabe_steps (outil + requête), pour la transparence. Les URL sources sont citées directement dans la réponse.
• Souveraineté : la recherche est servie par un méta-moteur auto-hébergé (aucune requête vers une API tierce) ; le badge cloud du modèle s’applique comme d’habitude si vous routez vers un modèle cloud.
• Sécurité : le contenu web est traité comme une donnée, jamais comme une instruction — les éventuelles consignes cachées dans une page ne sont pas exécutées.