ChatCieloDocs

Gemini (Google)

Configura Gemini 1.5 Flash y Pro en ChatCielo: API Key, ventana de hasta 2M tokens, prompt y límites

Gemini (Google) en ChatCielo

Gemini de Google destaca por su velocidad y ventana de contexto gigante — hasta 2 millones de tokens en Gemini 1.5 Pro. Es ideal cuando necesitas analizar documentos largos, mantener conversaciones extensas sin perder contexto o atender a alto volumen con latencia mínima.

Elige Gemini si manejas documentos largos, catálogos extensos o necesitas la latencia más baja para triaje en tiempo real. Su capa gratuita generosa también lo hace perfecto para pruebas y validación antes de escalar.

1. Cómo obtener tu API Key en Google AI Studio

Accede a Google AI Studio

Ve a aistudio.google.com e inicia sesión con tu cuenta de Google empresarial. Acepta los términos de la API de Gemini.

Genera la API Key

  1. Haz clic en Get API key (o Create API key).
  2. Si es tu primera vez, haz clic en Create API key in new project — Google creará un proyecto automáticamente.
  3. Si ya tienes un proyecto en Google Cloud, selecciona Create API key in existing project y elige el proyecto.
  4. Copia la clave que empieza por AIza... y guárdala de forma segura.

No compartas la clave en chats o capturas. Si sospechas exposición, ve a API Keys en Google Cloud Console y regenérala.

Verifica cuota y facturación

Gemini ofrece una capa gratuita generosa para pruebas (límites por minuto/día). Para producción, vincula un proyecto con facturación en console.cloud.google.com y verifica los límites en APIs y servicios > Enabled APIs > Generative Language API > Quotas.

2. Modelos recomendados

Velocidad y ventana gigante — el mejor equilibrio para atención por WhatsApp.

  • El más rápido de la familia Gemini — latencia <1 segundo.
  • Ventana de 1 millón de tokens — maneja catálogos, FAQs extensas y conversaciones larguísimas sin truncar.
  • Costo muy bajo, ideal para alto volumen, triaje y clasificación.
  • Excelente en español neutro y comprensión de contexto.
Modelo en ChatCielo: gemini-1.5-flash

Úsalo como modelo principal para atención masiva y triaje. Su velocidad lo hace perfecto para primera respuesta.

CaracterísticaGemini 1.5 FlashGemini 1.5 Pro
Velocidad★★★★★ Ultrarrápido (<1 s)★★★★ Rápido (1–2 s)
Costo$ Muy bajo$$ Medio
Ventana1M tokens (~750k palabras)2M tokens (~1.5M palabras)
Razonamiento★★★★ Bueno★★★★★ Excelente
Ideal paraTriaje, FAQ, alto volumenDocumentos largos, análisis, multimodal

3. Configuración en ChatCielo

Ve a Canales > Tu canal > Integración IA > Gemini / Google.

CampoQué ponerRecomendación
API KeyPega la clave AIza... de AI StudioUna clave por tenant.
Modelogemini-1.5-flash o gemini-1.5-proFlash para velocidad; Pro para documentos largos.
Prompt del SistemaInstrucciones de personalidad y reglasVer plantillas abajo. Gemini responde muy bien a prompts estructurados con secciones.
Temperatura0 a 20.3 para soporte; 0.7 para ventas creativas.
Max Tokens150 a 8192300500 para WhatsApp; 1500+ para análisis de documentos.
Palabra clave de derivaciónhablar con asesor, asesor humanoFrases de 2–3 palabras.

Límites en ChatCielo: aunque Gemini soporta 1M–2M tokens, ChatCielo puede limitar el histórico enviado por mensaje para optimizar costos. Configura Histórico: 10–15 mensajes para equilibrar contexto y gasto. Si necesitas más contexto, usa Pro y aumenta el histórico a 20–25.

4. Prompt y límites — plantillas

Gemini responde especialmente bien a prompts estructurados con encabezados y reglas numeradas.

Plantilla 1: Atención general con Gemini

# Rol
Eres el asistente virtual de {{empresa}}.

# Tono
Cordial, profesional y conciso. Español neutro. Frases cortas.

# Objetivo
Resolver dudas frecuentes, orientar al cliente y derivar a humano cuando no tengas el dato.

# Reglas
1. Máximo 4 líneas por mensaje.
2. Usa `{{name}}` cuando lo conozcas, sin repetirlo en cada frase.
3. Nunca inventes precios, stock o plazos. Si no sabes, di: "Te derivo con un asesor para confirmarte ese dato con precisión".
4. Si el cliente escribe "hablar con asesor" o "asesor humano", responde: "Perfecto, te conecto con un asesor humano ahora. Tu protocolo es `{{protocol}}`." y cede la conversación.
5. No menciones que eres una IA.
6. Horario humano: lunes a viernes 9:00–18:00 (GMT-3). Fuera de horario, registra la consulta.

# Información de la empresa
- Empresa: {{empresa}}
- Productos/servicios: [lista breve]
- Políticas: [envíos, devoluciones en 3 líneas]
- Variables: `{{name}}`, `{{phoneNumber}}`, `{{protocol}}`, `{{email}}`

Plantilla 2: Análisis de documentos largos (Pro)

# Rol
Eres analista de documentos de {{empresa}}.

# Tarea
Analiza el contenido proporcionado y responde SOLO con información del documento.
Si la respuesta no está en el documento, di: "Ese dato no está en la información disponible. Te derivo con un asesor."

# Reglas
- Cita la fuente cuando sea posible: "Según [documento/sección]...".
- Máximo 5 líneas por respuesta. Sé preciso.
- Si el cliente dice "hablar con asesor", deriva inmediatamente.

# Contexto adicional
Variables: `{{name}}`, `{{protocol}}`

Parámetros y límites

EscenarioTemperaturaMax TokensHistóricoNotas
Atención rápida (Flash)0.30.430040010 mensajesLatencia mínima, costo bajo.
Ventas (Flash)0.50.740060012 mensajesUn poco más de creatividad.
Documentos largos (Pro)0.20.3800150015–25 mensajesAprovecha la ventana gigante.

Límites de la capa gratuita: en plan gratuito, Gemini limita a ~60 solicitudes por minuto (Flash) y ~2 por minuto (Pro). Para producción con volumen, activa facturación en Google Cloud y solicita aumento de cuota si superas los límites.

5. Palabra clave de derivación humana

En Canales > Tu canal > Integración IA > Derivación humana:

  • Palabras clave: hablar con asesor, asesor humano, hablar con alguien, quiero hablar con persona
  • Mensaje de derivación:
Perfecto `{{name}}`, te conecto con un asesor humano en este momento.
Tu protocolo es `{{protocol}}` — un agente te responderá en breve.
Horario de atención: lunes a viernes 9:00–18:00.

6. Casos de uso donde Gemini destaca

Catálogos de 500+ productos, manuales técnicos, políticas extensas.

Con Pro y 2M de tokens, puedes pegar tu catálogo completo o manual de 300 páginas en el prompt y Gemini responderá citando la información correcta sin necesidad de RAG externo. Ideal para negocios con información muy extensa.

Combínalo con Dify si prefieres RAG con PDFs dinámicos en lugar de prompt gigante.

7. Solución de problemas

ProblemaCausaSolución
API key not validClave mal copiada o proyecto incorrectoVerifica en aistudio.google.com que la clave pertenezca al proyecto correcto. Regenera si persiste.
Quota exceededLímite de capa gratuita superadoActiva facturación en Google Cloud Console y solicita aumento de cuota.
Resource exhaustedDemasiadas solicitudes por minutoReduce la frecuencia o distribuye entre Flash y Pro. Implementa reintento con backoff.
Respuestas en inglésPrompt sin idiomaAgrega al inicio: "Responde siempre en español neutro".
No deriva a humanoPalabra clave muy cortaUsa frases de 2–3 palabras y verifica la configuración.

¿Quieres comparar? Revisa la tabla comparativa general y las guías de DeepSeek (alternativa económica) y Claude (alternativa en calidad de redacción).