Chatbots La rédaction Aikiwi · Publié le · 4 min de lecture

Tool Retrieval dans l’API Gemini : vos agents chargent leurs outils à la demande, en préversion

Visuel de couverture d'Aikiwi, rubrique News, couleurs de la catégorie Chatbots : « Tool Retrieval de l’API Gemini », avec le logo de Google

Google a annoncé le 19 novembre 2026 Tool Retrieval en préversion dans l’API Gemini, pour charger les schémas d’outils seulement lorsqu’ils sont nécessaires. Ce chargement des outils à la demande est réservé à l’Interactions API.

Ce que Google annonce : des schémas d’outils chargés seulement quand il le faut

Avec Tool Retrieval, un agent bâti sur l’API Gemini garde toute sa bibliothèque d’outils en attente et ne charge les schémas de leurs paramètres que lorsque la tâche en cours les réclame.

Selon Google, transmettre le schéma complet de chaque fonction à chaque requête devient coûteux quand un agent dispose d’une grande bibliothèque d’outils. Ces définitions gonflent les tokens d’entrée et ajoutent de la latence. Toujours selon l’entreprise, la justesse du choix d’outil diminue aussi lorsque la liste des candidats s’allonge.

Pour activer le chargement des outils à la demande, la requête doit inclure un outil tool_search et le réglage defer_loading: true sur les outils à mettre en attente. Leurs noms et descriptions restent visibles par le modèle. Lorsqu’il a besoin d’une fonction, le modèle la demande par son nom, puis l’API charge son schéma complet. Il appelle ensuite la fonction dans la même requête.

Gemini exécute la recherche côté serveur, sans index à construire ni à héberger. Pour un serveur MCP distant, le même réglage s’applique à l’outil mcp_server et couvre l’ensemble des outils qu’il expose. Chaque schéma est alors chargé à la demande, sans que vous ayez à déclarer séparément tous les outils de ce serveur dans la requête.

Qui peut s’en servir : une préversion réservée à l’Interactions API

Tool Retrieval est en préversion et exige la version v1beta de l’API ; son interface peut évoluer avant la disponibilité générale. Selon Google, la fonction prend en charge les modèles Gemini 3.6 et suivants, dont tous les modèles Gemini 4. La méthode generateContent n’est pas compatible. Si votre agent utilise cette méthode, le choix d’un modèle compatible ne suffit pas : l’accès à la fonction passe par l’Interactions API.

Pour les développeurs qui maintiennent leur propre registre d’outils, la recherche peut s’exécuter côté client : votre application effectue alors elle-même la recherche, avec un aller-retour supplémentaire à chaque recherche. Les outils n’ont pas besoin d’être déclarés à l’avance dans cette variante. Vous pouvez en exposer de nouveaux pendant la conversation, notamment lorsqu’un utilisateur connecte une intégration, sans devoir tous les déclarer au départ.

Ce que cela change pour la facture et pour votre code

Tool Retrieval n’entraîne pas de frais propres : les tokens d’entrée et de sortie restent facturés au tarif normal du modèle appelé. Activer tool_search ajoute toutefois un petit bloc fixe de tokens d’entrée. Chaque schéma chargé est ensuite facturé en entrée pour le reste de la conversation, comme s’il avait été déclaré dès le départ. Selon la documentation de Google, chaque recherche côté serveur déclenche aussi, dans la requête, un appel de modèle supplémentaire avec tout le contexte et les schémas chargés ; ces tokens sont facturés au tarif d’entrée.

Selon Google, le chargement des outils à la demande économise des tokens lorsque les schémas jamais chargés pèsent davantage que ceux effectivement chargés. Cette condition correspond au cas habituel des grandes bibliothèques, d’après l’entreprise. Pour votre application, Google conseille de mesurer l’économie sur votre propre trafic plutôt que de la tenir pour acquise.

Côté code, Google recommande de garder les outils les plus utilisés chargés d’emblée et de différer les autres. Selon Google, les schémas en attente restent hors du début du prompt et les schémas chargés s’ajoutent plus loin dans la conversation : le préfixe mis en cache reste identique d’un tour à l’autre. Un outil chargé ne se décharge pas. Il reste dans le contexte jusqu’à la fin de la conversation.

Sources et méthode

Informations vérifiées le .

Cet article est préparé par la rédaction d'Aikiwi avec une chaîne automatisée : chaque information est reliée à une source publique et vérifiée avant publication. Il ne rapporte pas de test pratique, sauf mention contraire. Notre méthode