Google AI Studio: crie assistentes de IA personalizados sem código

O problema: assistentes genéricos não resolvem problemas específicos

Você já tentou usar um chatbot de suporte e recebeu uma resposta que não resolveu nada? A maioria dos assistentes de IA tenta abranger tudo e não se aprofunda em nada. Com o Google AI Studio, você pode criar um assistente sob medida que conhece as regras do seu negócio, o tom da sua marca e os limites do que pode responder.

Neste tutorial, você vai construir do zero um assistente de suporte técnico para uma loja virtual chamada TechStore. Cada etapa tem exemplo real e código copiável — incluindo os limites da versão gratuita que o Google não explica na página inicial.

O que você vai aprender

• Criar System Instructions profissionais no AI Studio
• Diferença entre Freeform e Structured Prompt
• Escolher o modelo certo com critérios práticos
• Contornar limites da versão gratuita (quotas, rate limits, safety filters)
• Exportar seu assistente para a API do Gemini

Passo 1 — Crie um Structured Prompt (não use Freeform)

No AI Studio, ao clicar em “Create new prompt”, você vê duas opções. O Freeform prompt é uma caixa de texto única — instrução e pergunta tudo junto. Funciona para testes rápidos, mas não separa o manual do assistente da pergunta do cliente. O Structured prompt tem duas áreas: System Instructions (comportamento fixo) e User Prompt (pergunta de cada cliente). Para um assistente reutilizável, escolha Structured prompt.

Passo 2 — Escreva as System Instructions

Na área “System Instructions”, cole o template abaixo:

Você é um assistente de suporte técnico da loja TechStore.

## REGRAS DE ATENDIMENTO
- Responda em português brasileiro, tom profissional e cordial.
- Nunca peça dados sensíveis (senhas, CPF, número de cartão).
- Se não souber, diga que não sabe — nunca invente.

## PRODUTOS ATENDIDOS
Notebooks, monitores, teclados, mouses, headsets, webcams e cabos.

## PROBLEMAS COMUNS
1. Produto não liga: verificar cabo de alimentação e tomada.
2. Tecla de teclado presa: limpeza com ar comprimido.
3. Mouse sem resposta: trocar pilha ou verificar receptor USB.
4. Headset sem som: verificar conexão do conector P2.

## FORMATO DE RESPOSTA
- Saudação com o nome: "Olá, [nome]".
- Diagnóstico em até 3 etapas numeradas.
- Prazo de garantia: 7 dias úteis.

A seção “REGRAS” evita que o modelo invente respostas ou peça dados protegidos pela LGPD. A seção “PROBLEMAS COMUNS” funciona como banco de conhecimento embutido — sem ela, o Gemini pode sugerir “reinicie o roteador” para resolver um teclado com tecla presa.

Passo 3 — Teste com perguntas reais

No campo “User Prompt”, digite perguntas como se fosse um cliente:

"Comprei um headset e o som só sai do lado esquerdo."
"Meu notebook não liga, mas o carregador acende a luz verde."
"Quero devolver um monitor, qual o prazo?"
"Qual o endereço da loja física mais próxima?"

Na última pergunta, o assistente deve dizer que não atende lojas físicas — porque as regras não incluem isso. Se ele inventar um endereço, adicione: “Você atende apenas suporte online.”

Passo 4 — Ajuste os safety filters

Por padrão, o AI Studio bloqueia conteúdo com probabilidade média ou alta de ser inadequado. Até uma reclamação legítima pode ser cortada. No painel à direita, clique em “Advanced settings” e depois em “Safety settings”. Durante os testes, ajuste cada categoria para Block none. Em produção, mantenha “Block medium and above”.

Escolhendo o modelo ideal

Três critérios práticos definem a escolha:

RPM = requisições por minuto. RPD = requisições por dia. Reset: meia-noite do Pacífico (4h Brasília). As quotas são por projeto, não por API key. Para a TechStore, o Gemini 2.5 Flash é a melhor escolha: velocidade boa para atendimento, raciocínio suficiente para diagnósticos e 250 chamadas/dia de graça.

Passo 5 — Exporte para usar fora do AI Studio

Clique em “Get code” no canto superior direito e exporte em Python, JavaScript, cURL ou REST. O código gerado já inclui suas System Instructions:

import google.generativeai as genai
genai.configure(api_key="SUA_CHAVE_AQUI")

model = genai.GenerativeModel(
    model_name="gemini-2.5-flash",
    system_instruction="Você é um assistente de "
    "suporte técnico da loja TechStore...")

response = model.generate_content("Meu headset não funciona")
print(response.text)

Você testa no AI Studio e leva o mesmo assistente para seu site, WhatsApp ou Slack em minutos. Gere uma API key gratuita em “Get API key” no menu.

Como identificar problemas nos testes

• Seguiu o tom? Se respondeu com “Prezado” em vez de “Olá”, ajuste a regra de saudação.
• Respeitou os limites? Se inventou garantia, adicione: “Nunca cite prazos sem consultar a lista oficial.”
• Manteve o foco? Se o cliente perguntar algo fora do escopo, o assistente deve recusar.
• Safety agressivo? Se bloqueou pergunta legítima, reduza os thresholds.

Repita teste → ajuste → teste ao menos 3 vezes. A primeira versão nunca é a definitiva.

Resumo e pontos-chave

• Use Structured prompt para assistentes reutilizáveis.
• System Instructions com seções claras: persona, regras, conhecimento, formato.
• Para suporte, Gemini 2.5 Flash: 10 RPM, 250 RPD de graça.
• Quotas por projeto, reset às 4h Brasília.
• “Get code” exporta com as instruções embutidas.

Seu template copiável

Cole no campo “System Instructions”, substitua os dados nos colchetes e comece:

Você é um assistente de [área] da empresa [nome].

## REGRAS
- Responda em português brasileiro, tom [profissional/casual].
- Nunca compartilhe informações não verificadas.
- Se não souber, diga que não sabe e transfira.

## ESCOPO
Você atende apenas: [lista de tópicos].

## FORMATO
1. Saudação personalizada.
2. Resposta em até 3 passos.
3. Encerramento com oferta de ajuda.

Acesse aistudio.google.com, crie um Structured Prompt, cole o template e veja seu assistente funcionar. A versão gratuita basta para testar e colocar em produção em baixo volume.