[Extensão] Como usar a extensão Google Gemini no Blip

1. Introdução

2. Funcionalidades

3. Instalação e configuração

4. Usar o Gemini no fluxo do Builder

5. Exemplos de uso

6. Suporte

Descrição breve: Conecte os modelos de inteligência artificial do Google Gemini ao seu chatbot na Blip e gere respostas automáticas com base nas suas instruções e na sua própria base de conhecimento.

Introdução

A extensão Google Gemini leva os modelos de IA do Google para dentro dos fluxos do seu chatbot na Blip. Você configura a chave de API, escolhe o modelo e define como o assistente deve se comportar, e o Gemini passa a gerar as respostas dentro do fluxo do Builder.

Por exemplo, um cliente pergunta no WhatsApp sobre o prazo de entrega de um produto. O bloco do Gemini recebe a mensagem, consulta os documentos que você cadastrou na base de conhecimento e devolve uma resposta em linguagem natural, que o fluxo envia de volta ao cliente.

Funcionalidades

• Geração de respostas com IA do Google (Gemini) dentro do fluxo do Builder.

• Escolha entre os modelos Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.5 Flash-Lite, Gemini 3 Flash e Gemini 3 Pro.

• Base de conhecimento: envie documentos (PDF, TXT, CSV, Markdown, HTML, XML, RTF, JavaScript, Python e CSS) para o Gemini responder com base neles.

• Instruções do assistente para definir papel, escopo e tom das respostas.

• Controle de temperatura e limite de tokens por chamada.

• Configuração de segurança por categoria (assédio, discurso de ódio, sexualmente explícito e material perigoso), com quatro níveis de bloqueio.

• Armazenamento da resposta em uma variável para uso no restante do fluxo.

Suportada nos seguintes canais: todos os canais disponíveis na plataforma Blip.

Pré-requisitos

• Acesso ao bot na Blip com permissão para instalar extensões.

• Uma conta Google com acesso ao Google AI Studio.

• Uma chave de API válida do Gemini.

Instalação e configuração

Instalar a extensão no bot

Instale a extensão no bot que contém o fluxo em que o Gemini vai gerar as respostas (o bot de atendimento), e não no Roteador.

1. Acesse o bot desejado na Blip.

2. Abra a Blip Store e localize a extensão Google Gemini, ou pesquise por Google Gemini na busca da loja.

3. Selecione a extensão e clique em Instalar.

4. Escolha o bot em que a extensão será usada.

Depois de instalar, abra a página da extensão para iniciar a configuração. No menu do bot, clique nos três pontos e localize a extensão Google Gemini.

Criar uma chave de API no Google AI Studio

A extensão usa a API do Gemini, então você precisa de uma chave de API do Google. Na página da extensão, abaixo do campo Chave da API, o link em Disponível aqui abre a página de chaves do Google AI Studio.

1. Acesse o Google AI Studio.

2. Abra a área de chaves de API e clique em Create API Key.

3. Selecione ou importe um projeto do Google Cloud e confirme. A chave é gerada.

4. Copie a chave e guarde em um local seguro.

Se você usa uma conta do Google Workspace (conta empresarial), pode ser necessário pedir ao administrador da organização as permissões para acessar o Google AI Studio e criar a chave. O Google mantém um guia específico para habilitar o Gemini na empresa.

Atenção: não compartilhe a chave em documentos, prints, tickets ou canais públicos. Se uma chave for exposta, gere uma nova no Google AI Studio e substitua a antiga.

Configurar o modelo e a segurança

Volte à Blip e abra a extensão Google Gemini, na aba Configurações da IA.

1. Em Modelo, selecione o modelo do Gemini que o assistente vai usar. Cada modelo tem custos e limites próprios, definidos pelo plano da sua conta Google.

2. Cole a chave gerada no Google AI Studio no campo Chave da API.

3. Na seção Segurança, ajuste o nível de bloqueio de cada categoria. Níveis mais altos bloqueiam mais respostas, inclusive algumas inofensivas. Mantenha os valores padrão se não houver uma regra específica para a sua operação.

4. Clique em Salvar. A extensão testa a chave antes de salvar. Se a chave for inválida, ela mostra um aviso de erro em vez de concluir.

Adicionar uma base de conhecimento

A base de conhecimento fornece informações específicas para o Gemini responder com precisão. Abra a aba Base de conhecimento.

1. Em Documentos, arraste ou selecione o arquivo que quer enviar. Os formatos aceitos são PDF, TXT, CSV, Markdown, HTML, XML, RTF, JavaScript, Python e CSS.

2. Clique em Carregar novo arquivo. O arquivo passa a aparecer na lista Arquivos.

3. Para remover um documento, clique no botão de lixeira ao lado dele.

Use documentos objetivos e atualizados. Evite versões duplicadas ou informações contraditórias, porque isso confunde as respostas. A base de conhecimento complementa as instruções do assistente, mas não substitui uma definição clara de comportamento.

Usar o Gemini no fluxo do Builder

Instalar a extensão do Builder no Chrome

Para adicionar o Gemini ao fluxo, você precisa da extensão do Builder no Google Chrome. Abra a aba Integrando ao builder na página da extensão e clique em Instalar extensão para finalizar a instalação na Chrome Web Store.

Adicionar o bloco de integração ao fluxo

1. No Builder, abra o ponto do fluxo em que o Gemini deve gerar a resposta.

2. Clique no ícone de adicionar bloco. Com a extensão do Chrome instalada, aparece a opção de adicionar um bloco de integração.

3. Abra a aba de integração e selecione a integração do Google Gemini.

Configure os campos do bloco:

• Variável de entrada: a variável do fluxo que contém a mensagem do usuário. O padrão é input.content.

• Instruções: o comportamento do assistente (veja a seção seguinte).

• Temperatura: um valor de 0 a 1 que controla a criatividade da resposta.

• Limite de tokens: a quantidade máxima de tokens da resposta, de 1 a 8192 (1 token equivale a cerca de 3 letras). O padrão é baixo, então aumente esse valor se as respostas precisarem ser mais longas.

• Variável de resultado (em Salvar retorno): a variável onde a resposta do Gemini será armazenada.

O modelo e as configurações de segurança vêm da aba Configurações da IA na página da extensão, não do bloco.

Definir as instruções do assistente

As instruções dizem ao Gemini como se comportar. Escreva de forma clara qual é o papel do assistente, quais assuntos ele pode responder, quais deve recusar, qual tom usar e o que fazer quando não encontrar a informação. Evite instruções genéricas como "responda a tudo" e oriente o modelo a não inventar dados. Se a API do Gemini retornar um erro, a extensão devolve uma resposta padrão ("Não sei falar sobre esse assunto.") e registra o erro no log.

Salvar a resposta em uma variável

Defina um nome na Variável de resultado do bloco, por exemplo geminiResponse. Depois de executar a integração, use essa variável em um bloco de conteúdo:

{{geminiResponse}}

Confirme que o nome usado no bloco de conteúdo é exatamente igual ao definido na integração.

Testar o fluxo

Antes de publicar, execute o bot no modo de teste e valide o comportamento:

1. Envie uma pergunta dentro do escopo das instruções e confirme se a resposta foi armazenada na variável.

2. Envie perguntas fora do escopo e verifique se o assistente recusa como você definiu.

3. Faça perguntas cobertas pelos arquivos da base de conhecimento e confira as respostas.

4. Teste o caso em que a informação não existe.

Exemplos de uso

Uma instrução clara define o assistente. Por exemplo:

Você é um assistente virtual responsável por responder dúvidas sobre os produtos e serviços da empresa. Responda somente com base nas informações da base de conhecimento. Use uma linguagem clara, educada e objetiva. Caso não encontre a resposta, informe que não possui dados suficientes e oriente o usuário a falar com um atendente. Não invente informações, preços, prazos ou regras.

A partir dessa base, dá para montar um tira-dúvidas de produtos, um assistente de consulta a manuais internos ou um apoio ao atendimento que responde antes de acionar um atendente humano.

Atenção: os limites de uso e a cobrança dependem do modelo e do plano contratado na sua conta Google, e podem ser medidos por requisições e tokens, por minuto ou por dia. Modelos experimentais costumam ter limites menores e mais instabilidade. Valide custos e limites antes de usar a integração em produção, e evite enviar dados pessoais ou sensíveis sem avaliação prévia.

Suporte

Em caso de dúvida, problema ou sugestão, fale com a gente pelo e-mail support@wiv.com.br.

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃