Este guia mostra como começar a fazer chamadas para o API Gemini da Vertex AI diretamente do seu app usando o SDKs da Vertex AI para Firebase.
Pré-requisitos
Este guia pressupõe que você esteja familiarizado com o uso do Xcode para desenvolver aplicativos para Plataformas da Apple (como iOS).
Verifique se o ambiente de desenvolvimento e o app das plataformas da Apple atendem aos requisitos requisitos a seguir:
- Xcode 15.0 ou mais recente
- Seu app precisa ser direcionado ao iOS 15 ou mais recente ou ao macOS 12 ou mais recente.
(Opcional) Confira o aplicativo de exemplo.
Fazer o download do app de exemplo
É possível testar o SDK rapidamente, ver uma implementação completa de vários recursos casos ou use o aplicativo de exemplo se você não tiver seu próprio aplicativo de plataformas da Apple. Para usar o app de exemplo, você precisará conectá-lo a um projeto do Firebase.
Etapa 1: configurar um projeto do Firebase e conectar seu app ao Firebase
Se você já tem um projeto do Firebase e um app conectado a ele
No console do Firebase, acesse Página Crie com o Gemini, e clique no segundo card para iniciar um fluxo de trabalho que ajuda a fazer próximas tarefas. Se houver uma guia da Vertex AI no console, essas tarefas sejam concluídas.
Faça upgrade do seu projeto para usar o Plano de preços Blaze de pagamento por uso.
Ative as duas APIs a seguir para seu projeto:
aiplatform.googleapis.com
efirebaseml.googleapis.com
Siga para a próxima etapa deste guia para adicionar o SDK ao seu app.
Se você ainda não tiver um projeto do Firebase e um app conectado a ele
Etapa 2: adicionar o SDK
Com o projeto do Firebase configurado e o app conectado a ele (consulte a etapa anterior), agora é possível adicionar o SDK da Vertex AI para Firebase ao seu app.
A biblioteca Vertex AI para Firebase dá acesso aos
a API Gemini da Vertex AI e está incluída como parte do SDK do Firebase para
Plataformas da Apple (firebase-ios-sdk
). Para a biblioteca da Vertex AI para Firebase,
use o Gerenciador de pacotes do Swift para instalar e gerenciar o Firebase
dependências. Outros gerenciadores de pacotes, como o CocoaPods, não estão disponíveis no momento.
suporte.
No Xcode, com seu projeto do app aberto, navegue até File > Add Packages.
Quando solicitado, adicione o repositório do SDK do Firebase para as plataformas Apple:
https://github.com/firebase/firebase-ios-sdk
Selecione a versão mais recente do SDK.
Selecione a biblioteca
FirebaseVertexAI-Preview
.Quando terminar, o Xcode vai começar a resolver e fazer o download das dependências em segundo plano automaticamente.
Etapa 3: inicializar o serviço da Vertex AI e o modelo generativo
Antes de fazer chamadas de API, você precisa inicializar a Vertex AI e o modelo generativo.
Importe o módulo
FirebaseVertexAI
:import FirebaseVertexAI
Inicialize o serviço da Vertex AI e o modelo generativo:
import FirebaseVertexAI // Initialize the Vertex AI service let vertex = VertexAI.vertexAI() // Initialize the generative model with a model that supports your use case // Gemini 1.5 models are versatile and can be used with all API capabilities let model = vertex.generativeModel(modelName: "gemini-1.5-flash")
Quando terminar o Guia explicativo, aprenda a escolher um modelo Gemini e, opcionalmente, um o local apropriado para seu caso de uso e app.
Etapa 4: chamar a API Gemini da Vertex AI
Agora que você conectou seu aplicativo ao Firebase, adicionou o SDK e inicializou o serviço da Vertex AI e o modelo generativo, já pode chamar a API Gemini da Vertex AI.
Você pode usar generateContent()
para gerar texto com base em um comando somente de texto.
solicitação:
import FirebaseVertexAI
// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()
// Initialize the generative model with a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
let model = vertex.generativeModel(modelName: "gemini-1.5-flash")
// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."
// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
if let text = response.text {
print(text)
}
.
.
O que mais você pode fazer?
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.
Teste outros recursos da API Gemini
- Saiba mais sobre como gerar texto com comandos somente de texto, incluindo instruções transmitir a resposta.
- Gerar texto com base comandos multimodais (incluindo texto, imagens, PDFs, vídeo e áudio).
- Criar conversas de várias interações (chat).
- Use chamadas de função para se conectar modelos generativos a sistemas e informações externos.
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 o probabilidade de receber respostas que podem ser consideradas prejudiciais.
Envie feedback sobre sua experiência com a Vertex AI para Firebase