Heritiana Antonio Frond end Designer | Developer

Hello, I am

Heritiana Antonio

Frond end Designer | Developer

L’API Gemini envoie-t-elle encore le schéma de chaque outil ?

1 min de lecture

Tiroir d’un meuble en chêne ouvert sur une tige d’acier lisse, les autres tiroirs fermés.

L’API Gemini envoie-t-elle encore le schéma de chaque outil ?

Depuis le 19 novembre 2026, une requête à l’API Interactions de Gemini peut partir sans le schéma de paramètres de chaque outil. Il faut un outil tool_search, le drapeau defer_loading à vrai, la version v1beta, et un modèle que le guide accepte. Le nom et une courte description restent dans le prompt. Le schéma n’est chargé que si le modèle le demande, dans la même requête. Hors de ce cadre, l’envoi complet continue : generateContent ne connaît pas ce mécanisme, et un outil sans le drapeau part encore avec tous ses paramètres.

Tool Retrieval est le nom de cette préversion. Le billet du 19 novembre, signé Lucia Loher et Nora Kassner, vise les agents branchés sur des dizaines ou des centaines d’outils : chaque schéma renvoyé à chaque appel gonfle l’entrée, la latence, et, selon Google, brouille le choix. Aucun pourcentage n’accompagne ces trois effets. Le guide Tool retrieval, relu le 20 novembre 2026, fixe le mécanisme et les erreurs. Aucune date de disponibilité générale n’est donnée. La surface peut changer.

Ce que le premier prompt contient encore

Un outil en attente n’est pas un outil absent. Le modèle reçoit une ligne : le nom, et soit short_description, soit la première phrase de description si ce champ court manque. Les types et la liste required restent dehors tant que l’outil n’a pas été demandé. En test précoce, le guide mesure environ 26 tokens pour cette ligne. Ce n’est pas un plafond : une longue description, reprise faute de champ court, pèse davantage.

Les outils fréquents restent chargés. Le guide réserve l’envoi de chaque schéma, sans drapeau, à moins d’une vingtaine d’outils stables. Le schéma complet voyage dans la requête HTTP, hors du contexte initial, et n’est pas facturé tant qu’il n’est pas chargé. Réduit à un nom et une courte description, il revient avec un schéma vide, inutilisable. short_description sans le drapeau, un second tool_search, ou un nom posé sur la recherche serveur : trois erreurs 400. Le client du guide fixe api_version à v1beta et appelle gemini-4-hydrogen.

tools = [
    {"type": "tool_search"},
    {
        "type": "function",
        "name": "convert_currency",
        "description": "Convert an amount from one currency to another.",
        "short_description": "Convert an amount between currencies.",
        "defer_loading": True,
        "parameters": {
            "type": "object",
            "properties": {
                "amount": {"type": "number"},
                "to": {"type": "string"},
            },
            "required": ["amount", "to"],
        },
    },
]

Posé sur mcp_server, le drapeau retient d’un coup le schéma de chaque outil du serveur. L’API peut exécuter elle-même cet outil distant. Une fonction de l’application s’arrête sur function_call : c’est le code appelant qui renvoie function_result.

Une recherche serveur, ou la vôtre

Par défaut, Gemini cherche dans les outils déclarés. Le modèle émet tool_search_call, avec une liste de noms. L’API répond par tool_search_result et le schéma. Puis vient le function_call. Les deux premières étapes sont lisibles dans steps, mais l’application n’y répond pas : elles tiennent dans le même appel HTTP. Aucun index n’est à héberger.

Avec execution à client, le modèle appelle votre recherche comme une fonction, et vous renvoyez les déclarations. Un aller-retour s’ajoute. Les outils peuvent apparaître en cours de conversation, par exemple quand un utilisateur branche un connecteur. Nom et description sont obligatoires. Ce mode sert un registre, un filtre de droits, ou un espace de noms. Le mélanger avec la recherche serveur, ou avec defer_loading, renvoie un 400. La recherche serveur évite cet aller-retour HTTP, pas la passe de modèle qui suit.

Ce qui est facturé, passe de recherche comprise

Il n’y a pas de prix séparé. Entrée, cache et sortie suivent le tarif du modèle appelé. Trois postes s’ajoutent au prompt.

  • La liste en attente : environ 26 tokens par outil dans le test précoce, schéma exclu.
  • Les instructions de recherche : un bloc fixe, dont la taille n’est pas publiée.
  • Chaque recherche serveur : une passe de plus, dans la même requête. Son prompt, contexte complet plus schémas juste chargés, est compté dans total_tool_use_tokens et facturé au tarif d’entrée. Une seconde recherche ajoute une autre passe.

Un schéma chargé ne sort plus. Il est facturé ensuite comme un outil déclaré dès le départ. Le guide ne prévoit pas de déchargement. Une recherche client est une requête à part, au tarif habituel.

L’exemple du guide utilise des nombres ronds, sans tokens de sortie ni cache. Deux requêtes, 2 000 tokens de conversation, deux outils de 400 tokens chargés. Deux cents outils de 400 tokens : 164 000 tokens d’entrée en statique, environ 23 650 avec la recherche. Dix outils et 30 000 tokens de contexte : 68 000 deviennent environ 92 830. Le gain veut une grande bibliothèque et peu de recherches. Il s’inverse si presque chaque tour cherche dans un long fil. Il faut mesurer sur son trafic.

Les schémas chargés arrivent au milieu du fil, pas en tête : le préfixe caché peut rester identique d’un tour à l’autre. Un prompt qui ne franchissait le seuil de cache que grâce aux schémas complets peut retomber en dessous. total_cached_tokens est facturé au tarif cache.

Le billet dit tous les Gemini 4, le guide en liste quatre

Le billet et les notes de version du 19 novembre écrivent la même phrase : Tool Retrieval fonctionne avec Gemini 3.6 et les modèles plus récents, y compris tous les Gemini 4, dans l’API Interactions. Le guide, relu le 20 novembre, n’en accepte que quatre :

  • gemini-4-hydrogen ;
  • gemini-4-argon ;
  • gemini-3.8-flash ;
  • gemini-3.6-flash.

Sur un autre modèle, defer_loading renvoie un 400 : deferred loading is not supported for this model. gemini-4-neon, stable depuis le 18 novembre 2026, et gemini-4-carbon, stable depuis le 10 novembre, sont absents de la liste. La fiche de Neon indique l’appel de fonctions. Cette ligne ne l’inscrit pas dans Tool Retrieval. Tant que le guide n’ajoute pas l’identifiant, le code qui le vise avec le drapeau doit traiter ce 400. L’exemple du billet appelle gemini-4-hydrogen, qui est dans les quatre.

Les notes du 19 novembre renvoient au guide. Au 20 novembre, le guide et les notes ne décrivent pas le même ensemble de modèles.

Le deuxième appel est celui qui casse

Les déclarations ne passent pas d’une requête à l’autre, même avec previous_interaction_id. Chaque tour renvoie le tableau entier. S’il en manque, le modèle ne connaît plus que les outils déjà appelés, et des étapes nommées retriever: peuvent apparaître.

Avec l’état côté serveur, les étapes de recherche sont gardées. Sans état, store à faux, il faut les renvoyer intactes, champ signature compris, avant le function_call qui s’en sert. Le premier appel réussit. L’erreur sort au suivant, celui du résultat :

Server side tool call context must be circulated when using deferred loading functions.

Sans le champ signature, le 400 devient Tool call part is missing thought_signature. Pour l’étape qui ramène le schéma, il commence par Tool response part. Un outil nommé dans les instructions, ou dans la sortie d’un autre outil, ne se met pas en attente : le modèle peut l’appeler sans recherche, et le fil s’arrête au résultat. Une recherche sans correspondance répond par du texte, pas par une erreur. L’absence de tool_search_result ne prouve donc rien. Le statut n’est pas toujours requires_action quand un function_call attend : il faut lire les étapes.

Questions fréquentes

generateContent peut-il retenir un schéma ?

Non. Tool Retrieval est réservé à l’API Interactions, en v1beta. generateContent reçoit encore chaque schéma déclaré. Le drapeau, sur cette méthode, n’active pas le mécanisme du 19 novembre.

Gemini 4 Neon accepte-t-il defer_loading ?

Pas selon le guide relu le 20 novembre 2026. gemini-4-neon et gemini-4-carbon n’y figurent pas, alors que le billet parle de tous les Gemini 4. Un modèle hors liste renvoie un 400 si le drapeau est posé. L’appel de fonctions, sur la fiche de Neon, est un autre réglage.

Un schéma déjà chargé peut-il sortir du contexte ?

Non. Il reste jusqu’à la fin de la conversation et continue d’être facturé en entrée. Le guide ne décrit aucune opération pour le retirer.

Faut-il héberger un index d’outils ?

Pas en recherche serveur : Gemini cherche parmi les outils envoyés avec la requête. La recherche client utilise votre registre, votre index ou votre filtre de droits. Dans les deux cas, le tableau tools repart à chaque tour.

La recherche est-elle gratuite, faute de supplément ?

Il n’y a pas de ligne de prix en plus. La passe serveur est facturée en tokens d’entrée, dans total_tool_use_tokens. Le guide l’estime à peu près égale au prompt, une seconde fois, moins les tokens déjà en cache.

Que se passe-t-il si aucun outil ne correspond ?

Côté serveur, la réponse est un texte. Côté client, le guide conseille un court message d’absence, avec la liste de ce qui peut être cherché, pour que le modèle reformule. L’absence d’étape tool_search_result ne tranche pas.

Mesurer avant de tout retenir

Le drapeau sert une bibliothèque large, stable, dont chaque tâche ne touche qu’une petite partie. Il coûte davantage sur une dizaine d’outils, ou si presque chaque tour cherche dans un long fil. Les outils cités par leur nom, et ceux appelés en permanence, restent chargés. Le 20 novembre 2026, une requête vers Neon ou Carbon suit la liste du guide, pas la phrase plus large des notes de version.

Pour faire relire une requête qui mélange encore generateContent et defer_loading, la page Me contacter est ouverte.

Voir Egalement

My Blog

Portefeuille en cuir et cartes vierges à côté d’un téléphone éteint

ChatGPT Wallet peut-il payer un achat depuis la France ?

8 min de lecture Le 13 novembre 2026, ChatGPT Wallet laisse un agent payer après un accord biométrique. Les conditions exigent un compte Pro utilisé aux États-Unis. Depuis la France, ce portefeuille ne s’ouvre pas, et OpenAI ne reçoit pas le numéro complet de la carte. Read more
Ordinateur portable fermé, commutateur réseau et câble Ethernet sur un bureau

Un serveur Vite exposé exécute-t-il du code distant ?

10 min de lecture Depuis le 10 novembre 2026, une requête vers un serveur de développement Vite exposé au réseau peut y exécuter du code. Le dossier produit par vite build n’est pas ce serveur. La version à installer dépend de la branche, et Vite 5 n’a pas de correctif sur la sienne. Read more