Execução de código

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.