La funzionalità di esecuzione del codice dell'API Gemini consente al modello di generare ed eseguire codice Python e di apprendere in modo iterativo dai risultati fino a ottenere un output finale. Puoi utilizzare questa funzionalità di esecuzione di codice per creare applicazioni che beneficiano del ragionamento basato su codice e che producono output di testo. Ad esempio, potresti utilizzare l'esecuzione di codice in un'applicazione che risolve equazioni o elabora il testo.
L'esecuzione di codice è disponibile sia in AI Studio che nell'API Gemini. In AI Studio, puoi attivare l'esecuzione del codice in Impostazioni avanzate. L'API Gemini fornisce l'esecuzione di codice come strumento, in modo simile alla chiamata di funzione. Dopo aver aggiunto l'esecuzione di codice come strumento, il modello decide quando utilizzarlo.
Iniziare a utilizzare l'esecuzione di codice
In questa sezione si presuppone che tu abbia completato i passaggi di impostazione e configurazione illustrati nella guida rapida.
Esecuzione di codice e chiamata di funzione a confronto
L'esecuzione del codice e la chiamata di funzioni sono funzionalità simili:
- L'esecuzione del codice consente al modello di eseguire il codice nel backend dell'API in un ambiente fisso e isolato.
- La chiamata di funzione ti consente di eseguire le funzioni richieste dal modello in qualsiasi ambiente desideri.
In generale, ti consigliamo di utilizzare l'esecuzione di codice se può gestire il tuo caso d'uso. L'esecuzione del codice è più semplice da usare (devi solo abilitarla) e si risolve in una
singola richiesta GenerateContent (con un unico addebito). La chiamata di funzione richiede un'ulteriore richiesta GenerateContent per inviare nuovamente l'output di ogni chiamata di funzione (con conseguente addebito di più importi).
Nella maggior parte dei casi, devi utilizzare la chiamata di funzione se hai funzioni proprie che vuoi eseguire localmente e devi utilizzare l'esecuzione di codice se vuoi che l'API scriva ed esegua il codice Python per te e restituisca il risultato.
Fatturazione
Non sono previsti costi aggiuntivi per l'abilitazione dell'esecuzione di codice dall'API Gemini. L'importo ti verrà fatturato in base alla tariffa corrente dei token di input e output.
Di seguito sono riportate altre informazioni sulla fatturazione per l'esecuzione di codice:
- Ti viene addebitato un solo importo per i token di input che passi al modello e un altro 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.
- Anche i risultati di esecuzione del codice vengono conteggiati come token di output.
Limitazioni
- Il modello può solo generare ed eseguire codice. Non può restituire altri artefatti come i file multimediali.
- La funzionalità non supporta l'I/O dei file o i casi d'uso che prevedono output non di testo (ad esempio, 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'attivazione dell'esecuzione di codice può portare a regressioni in altre aree dell'output del modello (ad esempio, la scrittura di una storia).
- Esistono alcune differenze nella capacità dei diversi modelli di utilizzare l'esecuzione del codice correttamente. Sulla base dei nostri test, Gemini 1.5 Pro è il modello più performante.