Lo que vas a construir
Vas a crear tu primer chatbot con inteligencia artificial usando la API de Gemini de Google, que es completamente gratis. Lo interesante: la IA va a escribir el codigo por ti. Tu solo copias, pegas y ejecutas. Al terminar tendras un chatbot funcionando en tu terminal que responde a cualquier pregunta. Es el primer paso para entender como funcionan las APIs de IA y crear tus propias aplicaciones inteligentes.
Paso 1: Abre Google AI Studio
Ve a aistudio.google.com e inicia sesión con tu cuenta de Google.
Esto es un chat con Gemini, la IA de Google. Gratis.
Paso 2: Pídele que escriba el código
Copia y pega este prompt:
Necesito un chatbot simple en Node.js que:
- Use la API de Gemini
- Funcione en la terminal
- Mantenga el historial de la conversación
- La API key la leo de la variable de entorno GEMINI_API_KEY
Dame el código completo y los comandos para instalarlo.
Dale Enter y espera.
Gemini va a escribir todo el código por ti. También te dirá qué comandos ejecutar.
Paso 3: Obtén tu API Key
- Abre aistudio.google.com/apikey
- Click en "Create API Key"
- Copia la key
Paso 4: Configura la key en tu sistema
| Sistema | Comando |
|---|---|
| macOS/Linux | export GEMINI_API_KEY="tu-key-aqui" |
| Windows PowerShell | $env:GEMINI_API_KEY="tu-key-aqui" |
Ejecuta esto en la misma terminal donde vas a correr el chatbot.
Paso 5: Sigue las instrucciones de Gemini
Gemini te dio:
- Comandos para crear el proyecto (mkdir, npm install, etc.)
- Código para pegar en un archivo
- El nombre del archivo (algo como
chatbot.jsoindex.mjs) - El comando para ejecutarlo (algo como
node chatbot.js)
Sigue sus instrucciones paso a paso.
💡 ¿Cómo creo un archivo? Abre tu editor de código (VS Code, Cursor, etc.), crea un nuevo archivo, pega el código, y guárdalo con el nombre que Gemini indicó.
¿Funcionó?
Si ves algo como esto, lo lograste:
Tú: Hola
Gemini: ¡Hola! ¿En qué puedo ayudarte?
Si algo falló
| Error | Causa | Solución |
|---|---|---|
API key not valid | Key mal copiada o expirada | Verifica en aistudio.google.com/apikey |
Cannot find module | Falta la dependencia | Ejecuta npm install @google/genai |
node: command not found | Node.js no instalado | Instala desde nodejs.org |
npm: command not found | npm no está en PATH | Reinstala Node.js o reinicia la terminal |
GEMINI_API_KEY undefined | Variable no configurada | Ejecuta el export en la misma terminal |
SyntaxError | Código mal copiado | Copia todo el código de nuevo, sin cortar |
429 Too Many Requests | Límite de API alcanzado | Espera 1 minuto o usa otro proyecto |
| Gemini da código en Python | No especificaste Node.js | Pide de nuevo: "en Node.js, no Python" |
💡 Tip importante: Si cerraste la terminal, debes ejecutar el
exportde nuevo. La variable solo existe en esa sesión.
¿Qué acaba de pasar?
- Le pediste a una IA que escriba código
- La IA lo escribió
- Tú lo ejecutaste
- Funciona
Podrías haberle pedido lo mismo a ChatGPT, Claude, o cualquier otro chat de IA. El resultado sería similar.
Experimenta
Vuelve a Google AI Studio y prueba variaciones:
- "...que responda como pirata"
- "...que me ayude a practicar inglés"
- "...que sea un tutor de matemáticas"
El código cambia. El proceso es el mismo.
💼 Caso Real: Chatbot para Fintech
Si quieres adaptar este chatbot para servicios financieros, hay consideraciones importantes de seguridad y compliance.
System Prompt Seguro
Agrega restricciones claras al comportamiento del bot:
const systemPrompt = `Eres un asistente financiero. Reglas estrictas:
- NUNCA des consejos de inversión específicos ("compra X acción")
- NUNCA solicites datos sensibles (números de tarjeta, contraseñas, CVV)
- Siempre recomienda consultar con un asesor financiero certificado
- Si detectas intención de fraude o phishing, responde: "No puedo ayudar con eso"
- Incluye disclaimer: "Esto es información general, no asesoría financiera"`;
// Usar en la llamada a la API
const response = await ai.generateContent({
systemInstruction: systemPrompt,
contents: [{ role: "user", parts: [{ text: userMessage }] }]
});
Consideraciones de Compliance
| Requisito | Por qué | Cómo implementarlo |
|---|---|---|
| Logging | Auditoría regulatoria | Guarda todas las conversaciones con timestamp |
| Rate limiting | Prevenir abuso | Máx 10 mensajes/minuto por usuario |
| Disclaimer visible | Protección legal | Footer: "No es asesoría financiera" |
| No guardar datos sensibles | PCI DSS / GDPR | Filtrar antes de guardar en logs |
Ejemplo de Logging para Auditoría
const logConversation = async (userId, message, response) => {
await db.insert('chat_logs', {
user_id: userId,
timestamp: new Date().toISOString(),
user_message: sanitize(message), // Remover datos sensibles
bot_response: response,
session_id: sessionId
});
};
📖 Aprende más sobre seguridad en Autenticación y APIs Seguras
Próximo paso
→ Chatbot con Claude — Mismo proceso, diferente IA
¿Quieres entender más?
Si te interesa saber qué es una API, qué es un LLM, o cómo funciona esto por dentro: