Atelier

Lesson 4 — Orchestrer les appels

Les modes AUTO, ANY et NONE

4 min read

This content is not translated yet. Showing the original version.

Les modes AUTO, ANY et NONE

Le réglage function_calling_config

Par défaut, le modèle décide seul s'il appelle un outil ou s'il répond en texte. Vous pouvez le contraindre :

files/assistant.py (extrait)
tool_config=types.ToolConfig(function_calling_config=types.FunctionCallingConfig(
    mode=mode if tour == 0 else "AUTO")),
ModeComportementUsage typique
AUTO (défaut)le modèle choisit : appel(s) ou texteconversation normale
ANYle modèle doit appeler au moins une fonctionforcer une extraction, un routage, un premier appel
NONEappels interdits, texte seulementquestion générale, résumé final, outils temporairement coupés
VALIDATEDle modèle peut répondre en texte, mais ses appels respectent strictement le schémaquand le respect du schéma prime

Avec ANY, on peut aussi restreindre la liste : allowed_function_names=["consulter_solde"].

flowchart LR
  T1["Tour 1"] -- "mode ANY" --> AP["Appel de fonction obligatoire"]
  T1 -- "mode NONE" --> TX["Texte obligatoire"]
  T1 -- "mode AUTO" --> CH{"Le modèle choisit"}
  CH --> AP
  CH --> TX
  AP --> TS["Tours suivants : retour en AUTO"]
  TS --> CH
  TX --> FIN["Réponse à l'utilisateur"]

Le piège du mode ANY

En mode ANY, le modèle ne peut pas répondre en texte. Si vous laissez ANY à tous les tours, il appellera des fonctions indéfiniment et votre boucle ne s'arrêtera qu'à MAX_TOURS. C'est pourquoi le lab applique le mode demandé au premier tour seulement, puis repasse en AUTO. Un test sans clé le vérifie :

files/test_assistant.py (extrait)
def test_mode_any_seulement_au_premier_tour_et_limite_de_tours():
    faux = FauxModele([[("consulter_solde", {"employe_id": "E001"})]] * assistant.MAX_TOURS)
    rep = assistant.repondre(faux, [], "Boucle", "E001", lambda *a: True, mode="ANY", afficher=lambda *_: None)
    modes = [c.tool_config.function_calling_config.mode for c in faux.configs]
    assert modes[0] == "ANY" and set(modes[1:]) == {"AUTO"}
    assert "humain" in rep and len(faux.configs) == assistant.MAX_TOURS

Vous voulez qu'un « Bonjour » déclenche quand même la lecture du solde, pour afficher un tableau de bord. Quel réglage ?

Que se passe-t-il si l'on garde le mode ANY à tous les tours de la boucle ?

Exercice : un routeur avec ANY

Vous ajoutez un outil transmettre_rh(sujet: str) qui ouvre un ticket pour un humain. Écrivez la configuration qui oblige le modèle, au premier tour, à choisir entre consulter_solde et transmettre_rh, et rien d'autre.

Voir la solution 
types.ToolConfig(function_calling_config=types.FunctionCallingConfig(
    mode="ANY",
    allowed_function_names=["consulter_solde", "transmettre_rh"]))

Les autres outils restent déclarés (le modèle les connaît) mais ne peuvent pas être appelés à ce tour. C'est un routeur : le premier appel indique la branche à suivre. Au tour suivant, mode="AUTO".

Résultat obtenu

Exécutions réelles du 2026-10-15 avec gemini-3.5-flash.

Mode NONE (scénario 6 de e2e.py) : aucune fonction appelée, réponse directe.

[E001] Explique-moi en une phrase ce qu'est un RTT.   (mode NONE)
  → Un RTT (Réduction du Temps de Travail) est un jour de repos accordé aux salariés travaillant plus de 35 heures par semaine pour compenser leurs heures supplémentaires.

Mode ANY sur un simple « Bonjour ! » : le modèle est forcé d'appeler un outil au tour 1, puis, repassé en AUTO, il conclut en texte.

[E001] Bonjour ! (mode ANY)
  [tour 1] 1 appel(s) : consulter_solde({"employe_id": "E001"})
  → Bonjour ! Comment puis-je vous aider aujourd'hui concernant vos congés ou vos RTT ?

Je sais faire

  • Régler FunctionCallingConfig en AUTO, ANY ou NONE
  • Restreindre les outils appelables avec allowed_function_names
  • Éviter la boucle infinie en ne gardant ANY qu'au premier tour
  • Expliquer pourquoi un mode n'est pas une protection de sécurité
Next