La funzionalità di esecuzione del codice dell'API Gemini consente al modello di generare ed eseguire il codice Python e impara in modo iterativo dai risultati fino a quando non arriva l'output finale. Puoi utilizzare questa funzionalità di esecuzione del codice per creare applicazioni che traggono vantaggio da un ragionamento basato su codice e producono output di testo. Per Ad esempio, potresti utilizzare l'esecuzione del codice in un'applicazione che risolve equazioni o elabora il testo.
L'esecuzione del codice è disponibile sia in AI Studio sia nell'API Gemini. In AI Studio, puoi abilitare l'esecuzione del codice in Impostazioni avanzate. L'API Gemini offre l'esecuzione di codice come strumento, come chiamata di funzione. Dopo l'aggiunta dell'esecuzione del codice come strumento, il modello decide quando utilizzarlo.
Inizia a utilizzare l'esecuzione del codice
 Visualizza su ai.google.dev
|
 Esegui in Google Colab
|
 Visualizza il codice sorgente su GitHub
|
Questa sezione presuppone che tu abbia installato un SDK Gemini e configurato un'API come mostrato nella guida rapida.
Esecuzione di codice e chiamata di funzione a confronto
L'esecuzione del codice e le chiamate di funzione sono funzioni simili:
- L'esecuzione del codice consente al modello di eseguire il codice nel backend dell'API in un ambiente fisso e isolato completamente gestito di Google Cloud.
- La chiamata di funzione consente di eseguire le funzioni richieste dal modello, dell'ambiente desiderato.
In generale, è preferibile utilizzare l'esecuzione del codice, se è in grado di gestire l'utilizzo
per verificare se è così. L'esecuzione del codice è più semplice da usare (devi solo abilitarla) e si risolve in
singola richiesta GenerateContent (che comporta quindi un unico addebito). Funzione
la chiamata richiede un'ulteriore richiesta GenerateContent per restituire l'output
da ogni chiamata di funzione (comportando quindi più addebiti).
Nella maggior parte dei casi, è consigliabile utilizzare la chiamata di funzione se si hanno funzioni proprie eseguire localmente. Se vuoi usare l'esecuzione del codice, l'API per scrivere ed eseguire il codice Python per te e restituire il risultato.
Fatturazione
Non sono previsti costi aggiuntivi per l'abilitazione dell'esecuzione del codice dal dell'API Gemini. Ti verrà addebitata la tariffa attuale di input e output .
Di seguito sono riportate altre informazioni importanti sulla fatturazione per l'esecuzione del codice:
- Ti verranno addebitati solo una volta i token di input che passi al modello e ti vengono addebitati i token per i token di output finali che ti vengono restituiti dal modello.
- I token che rappresentano il codice generato vengono conteggiati come token di output.
- I risultati dell'esecuzione del codice vengono conteggiati anche come token di output.
Limitazioni
- Il modello può solo generare ed eseguire codice. Non può restituire altri artefatti ad esempio i file multimediali.
- La funzionalità non supporta l'I/O dei file o i casi d'uso che coinvolgono l'output non testuale (come grafici di dati o caricamento di un file CSV).
- L'esecuzione del codice può essere eseguita per un massimo di 30 secondi prima del timeout.
- In alcuni casi, l'abilitazione dell'esecuzione del codice può portare a regressioni in altre aree dell'output del modello (ad esempio, la scrittura di una storia).
- Esistono alcune variazioni nella capacità dei diversi modelli di utilizzare il codice esecuzione corretta. Gemini 1.5 Pro è la versione modello basato sui nostri test.