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. 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 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.
Inizia a utilizzare l'esecuzione del codice
Questa sezione presuppone che tu abbia installato un SDK Gemini e configurato una chiave API, come mostrato 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, è preferibile utilizzare l'esecuzione del codice, se è in grado di gestire l'utilizzo
per verificare se è così. 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, è 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 sulla fatturazione per l'esecuzione di 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.
- 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 ad esempio 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 variazioni nella capacità dei diversi modelli di utilizzare il codice esecuzione corretta. Gemini 1.5 Pro è il modello con il rendimento migliore, in base ai nostri test.