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, puoi utilizzare l'esecuzione di codice in un'applicazione che risolve equazioni o elabora il testo.
L'esecuzione di codice è disponibile sia in AI Studio sia 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 installazione e configurazione illustrati nella guida rapida.
Esecuzione del codice e chiamata di funzione
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 di codice è più semplice da utilizzare (basta attivarla) e si risolve in una singola richiesta GenerateContent (con un solo 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. Ti verrà addebitato l'importo 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 token di input che passi al modello e ti vengono addebitati 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 elementi 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 il caricamento di un file CSV).
- L'esecuzione del codice può durare al massimo 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. Gemini 1.5 Pro è il modello con il rendimento migliore, in base ai nostri test.