Fonction -> schéma d'outil (introspection)
L'appel d'outils (aussi appelé appel de fonctions) permet à un modèle de demander à ton programme d'exécuter une fonction : tu annonces un ensemble d'outils, le modèle répond avec un nom d'outil et des arguments, et tu l'exécutes. Mais le modèle ne voit pas ton Python -> il ne voit qu'un schéma : une description JSON du nom et des paramètres de chaque outil. Écrire ces schémas à la main pour chaque fonction est fastidieux et se désynchronise dès que tu changes une signature. La solution est l'introspection : générer le schéma directement à partir de la fonction.
Le module inspect de Python lit la signature d'une fonction à l'exécution. Le schéma qu'attendent les API d'appel d'outils ressemble à ceci :
{
"name": "get_weather",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}, "days": {"type": "integer"}},
"required": ["city"]
}
}Tu construis tool_schema(func) qui produit exactement ça. Deux idées font tout le travail :
- Associer les types Python aux types JSON Schema. Lis l'annotation de chaque paramètre et traduis :
int->"integer",float->"number",str->"string",bool->"boolean". Tout le reste donne"string"par défaut. - Déduire required des valeurs par défaut. Un paramètre sans valeur par défaut est exigé ; un paramètre avec une valeur par défaut est facultatif.
inspect.Parameter.emptyest la sentinelle de « pas de valeur par défaut ».
import inspect
sig = inspect.signature(func)
for name, param in sig.parameters.items():
is_required = param.default is inspect.Parameter.empty
json_type = ... # from param.annotationUtilise func.__name__ comme nom d'outil. Construis-la pour que deux fonctions annotées différemment produisent deux schémas clairement différents, qu'un paramètre int apparaisse comme "integer" et un str comme "string", qu'un paramètre avec valeur par défaut soit absent de required et qu'un paramètre sans valeur par défaut y figure. C'est le contrat sur lequel repose toute intégration d'appel d'outils.
Écris tool_schema(func) qui examine une fonction avec inspect.signature et renvoie {"name": func.__name__, "parameters": {"type": "object", "properties": {param: {"type": json_type}}, "required": [...]}}. Associe int->"integer", float->"number", str->"string", bool->"boolean" (par défaut "string"), et ne mets un paramètre dans required que s'il n'a pas de valeur par défaut.
Tu as repéré un problème dans cette leçon ? Signale-le · Pose une question sur cette leçon
Cet exercice s'ouvre bientôt
Termine la leçon précédente pour débloquer celle-ci. Tout le cours est gratuit, aucun compte n'est requis, et tu peux lire cette leçon dès maintenant.
Ce navigateur bloque les cookies pour learn.floati.life, donc les leçons que tu as terminées ici ne peuvent pas s'ouvrir dans l'ordre. Autorise les cookies pour ce site et recharge la page.