<ph type="x-smartling-placeholder">
La fonctionnalité d'exécution de code de l'API Gemini permet au modèle de générer et d'exécuter code Python et apprendre de manière itérative à partir des résultats jusqu'à le résultat final. Vous pouvez utiliser cette fonctionnalité d'exécution de code pour créer des applications qui bénéficient d'un raisonnement basé sur du code et qui produisent une sortie textuelle. Pour vous pouvez utiliser l'exécution de code dans une application qui résout des équations ou traite le texte.
L'exécution de code est disponible à la fois dans AI Studio et dans l'API Gemini. Dans AI Studio, vous pouvez activer l'exécution du code sous Paramètres avancés. L'API Gemini fournit l'exécution de code en tant qu'outil, semblable à appel de fonction. Après avoir ajouté l'exécution du code en tant qu'outil, le modèle décide quand l'utiliser.
Commencer à exécuter du code
 Afficher sur ai.google.dev
|
 Exécuter dans Google Colab
|
 Consulter le code source sur GitHub
|
Dans cette section, nous partons du principe que vous avez installé un SDK Gemini et configuré une API comme indiqué dans le guide de démarrage rapide.
Exécution de code et appel de fonction
L'exécution de code et l'appel de fonction sont caractéristiques similaires:
- L'exécution de code permet au modèle d'exécuter du code dans le backend de l'API de façon fixe et isolée environnement.
- L'appel de fonction vous permet d'exécuter les fonctions demandées par le modèle, dans dans l'environnement de votre choix.
En général, il est préférable d'utiliser l'exécution de code si elle peut gérer votre utilisation.
. L'exécution du code est plus simple à utiliser (il vous suffit de l'activer) et se résout dans un
une seule requête GenerateContent (une seule charge est alors facturée). Fonction
l'appel prend une requête GenerateContent supplémentaire pour renvoyer la sortie
de chaque appel de fonction (ce qui entraîne plusieurs frais).
Dans la plupart des cas, vous devez utiliser l'appel de fonction si vous disposez de vos propres fonctions. que vous voulez exécuter localement, et utilisez l'exécution de code si vous voulez l'API pour écrire et exécuter du code Python à votre place, puis renvoyer le résultat.
Facturation
L'activation de l'exécution de code depuis le l'API Gemini. Vous serez facturé au tarif actuel d'entrée et de sortie jetons.
Voici quelques autres points à connaître sur la facturation pour l'exécution du code:
- Les jetons d'entrée que vous transmettez au modèle ne vous sont facturés qu'une seule fois, et vous êtes facturé pour les jetons de sortie finaux qui vous sont renvoyés par le modèle.
- Les jetons représentant du code généré sont comptabilisés comme des jetons de sortie.
- Les résultats d'exécution de code sont également comptabilisés en tant que jetons de sortie.
Limites
- Le modèle peut uniquement générer et exécuter du code. Elle ne peut pas renvoyer d'autres artefacts. comme les fichiers multimédias.
- La fonctionnalité n'est pas compatible avec les E/S de fichiers ni avec les cas d'utilisation impliquant une sortie non textuelle. (par exemple, des tracés de données ou l'importation d'un fichier CSV).
- L'exécution du code peut durer 30 secondes au maximum avant d'expirer.
- Dans certains cas, l'activation de l'exécution de code peut entraîner des régressions dans d'autres domaines. de sortie du modèle (par exemple, l'écriture d'une histoire).
- La capacité des différents modèles à utiliser du code varie exécution réussie. Gemini 1.5 Pro est le plus performant sur la base de nos tests.