O recurso de execução de código da API Gemini permite que o modelo gere e execute código Python e aprender iterativamente com os resultados até chegar a a saída final. Use esse recurso de execução de código para criar aplicativos que se beneficiam do raciocínio baseado em código e que produzem saída de texto. Por exemplo, você pode usar a execução de código em um aplicativo que resolve equações ou processa texto.
A execução do código está disponível no AI Studio e na API Gemini. No AI Studio, Ative a execução do código em Configurações avançadas. A API Gemini oferece a execução de código como uma ferramenta, semelhante à chamada de função. Depois de adicionar a execução do código como ferramenta, o modelo decide quando usá-lo.
Começar a usar a execução de código
Nesta seção, presumimos que você instalou um SDK do Gemini e configurou uma chave de API, conforme mostrado no guia de início rápido.
Execução de código versus chamada de função
A execução de código e a chamada de função são recursos semelhantes:
- A execução de código permite que o modelo execute o código no back-end da API em um local isolado e fixo de nuvem.
- A chamada de função permite executar as funções solicitadas pelo modelo em qualquer ambiente.
Em geral, prefira usar a execução do código se ela puder lidar com seu uso
caso. A execução do código é mais simples de usar (basta ativá-la) e é resolvida em uma
única solicitação GenerateContent, o que gera uma única cobrança. Função
A chamada requer uma solicitação GenerateContent extra para retornar a saída
de cada chamada de função (gerando várias cobranças).
Na maioria dos casos, use a chamada de função se você tiver funções próprias que quer executar localmente. Use a execução de código se quiser que a API escreva e execute o código Python para você e retorne o resultado.
Faturamento
Não há custo adicional para ativar a execução do código no API Gemini. A cobrança será feita de acordo com a taxa atual de entrada e saída tokens.
Confira outras informações importantes sobre o faturamento da execução de código:
- Você só será cobrado uma vez pelos tokens de entrada que transferir para o modelo. você paga pelos tokens de saída finais retornados pelo modelo.
- Os tokens que representam o código gerado são contados como tokens de saída.
- Os resultados da execução do código também são contados como tokens de saída.
Limitações
- O modelo só pode gerar e executar código. Ele não pode retornar outros artefatos como arquivos de mídia.
- O recurso não oferece suporte a E/S de arquivos ou casos de uso que envolvem saídas que não são de texto, como gráficos de dados ou um upload de arquivo CSV.
- A execução do código pode ser executada por no máximo 30 segundos antes de expirar.
- Em alguns casos, a ativação da execução de código pode levar a regressões em outras áreas da saída do modelo (por exemplo, na escrita de uma história).
- Há alguma variação na capacidade dos diferentes modelos de usar a execução do código com sucesso. O Gemini 1.5 Pro tem o melhor desempenho com base nos nossos testes.