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:
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.
Conecte seu app ao Firebase, incluindo o registro dele e a adição do configuração do Firebase ao seu app.
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:
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
currencyFrom |
string | sim | Moeda de origem |
currencyTo |
string | sim | Moeda para a conversão |
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
Saiba mais sobre o modelos disponíveis para diversos casos de uso e as cotas e preços.Enviar feedback sobre sua experiência com o Vertex AI in Firebase