Usar a API Gemini para chamar funções

A chamada de função facilita a geração de saídas de dados estruturados de modelos generativos. Depois, é possível usar essas saídas para chamar outras APIs e retornar os dados de resposta relevantes para o modelo. Em outras palavras, a chamada de função ajuda você conecta modelos generativos a sistemas externos para que o conteúdo gerado inclui as informações mais atualizadas e precisas.

É possível fornecer descrições de funções aos modelos do Gemini. Essas são funções que você escreve na linguagem do seu app, ou seja, elas não são Cloud Functions. O modelo pode pedir que você chame uma função e envie de volta o resultado para ajudar o modelo a processar sua consulta.

Saiba mais sobre chamadas de função na documentação do Google Cloud.

Antes de começar

Conclua as guia para iniciantes para SDKs do Vertex AI in Firebase. Verifique se você fez o seguinte:

1. Configure um projeto do Firebase novo ou existente, incluindo o uso do plano de preços Blaze e a ativação das APIs necessárias.

2. Conecte seu app ao Firebase, incluindo o registro dele e a adição do configuração do Firebase ao seu app.

3. Adicionar o SDK e inicializar o serviço Vertex AI e o modelo generativo no seu app.

Depois de conectar seu aplicativo ao Firebase, adicionar o SDK e inicializar o Vertex AI e o modelo generativo, está tudo pronto para chamar Gemini API.

Configurar uma chamada de função

Neste tutorial, o modelo vai interagir com uma API hipotética de câmbio que oferece suporte aos seguintes parâmetros:

Exemplo de solicitação de API

{
  "currencyFrom": "USD",
  "currencyTo": "SEK"
}

Exemplo de resposta da API

{
  "base": "USD",
  "rates": {"SEK": 10.99}
}

Etapa 1: criar a função que faz a solicitação da API

Se ainda não fez isso, comece criando a função que faz uma solicitação de API.

Para fins de demonstração neste tutorial, em vez de enviar uma API real solicitação, você retornará valores codificados no mesmo formato que um a API retornaria.

Etapa 2: criar uma declaração de função

Crie a declaração de função que você vai transmitir ao modelo generativo (próxima etapa deste tutorial).

Inclua o máximo de detalhes possível nas descrições da função e dos parâmetros. O modelo generativo usa essas informações para determinar qual função selecionar e como fornecer valores para os parâmetros na chamada de função.

Etapa 3: especificar a declaração da função durante a inicialização do modelo

Especifique a declaração da função ao inicializar o modelo generativo definindo o parâmetro tools do modelo:

Aprenda a escolher um modelo do Gemini e, opcionalmente, um local de acordo com seu caso de uso e app.

Etapa 4: gerar uma chamada de função

Agora você pode solicitar o modelo com a função definida.

Recomendamos usar a chamada de função pela interface de chat, já que chamadas de função se encaixam perfeitamente na estrutura de vários turnos do chat.

O que mais você pode fazer?

Teste outros recursos do Gemini API

• Criar conversas de várias interações (chat).
• Gerar texto com base em comandos somente de texto.
• Gerar texto a partir de comandos multimodais (incluindo texto, imagens, PDFs, vídeo e áudio).

Saiba como controlar a geração de conteúdo

• Entender o design de comandos, incluindo práticas recomendadas, estratégias e exemplos de comandos.
• Configure os parâmetros do modelo, como temperatura e máximo de tokens de saída.
• Use as configurações de segurança para ajustar a probabilidade de receber respostas que podem ser consideradas prejudiciais.

Saiba mais sobre os modelos do Gemini

Enviar feedback sobre sua experiência com o Vertex AI in Firebase