Crea tu primer agente AI con acceso seguro a API
Agente funcional en 7 minutos sin servicios pagos - solo código local y APIs gratuitas
- 1.Instala Node.js (si no lo tienes). Abre la terminal y ejecuta: node --version. Si no ves salida - descárgalo de nodejs.org e instálalo.
Node.js es gratuito. Elige la versión LTS.
Node.js ↗ - 2.Crea una carpeta para el proyecto. En la terminal ejecuta: mkdir ai-agent && cd ai-agent && npm init -y
Los comandos funcionan igual en Windows (PowerShell), macOS y Linux.
- 3.Instala los paquetes necesarios: npm install axios dotenv. Esto permite que el agente haga solicitudes a APIs y almacene claves de forma segura.
Todos los paquetes son gratuitos. Se descargan del repositorio npm.
npm ↗ - 4.Crea un archivo .env en la raíz de la carpeta ai-agent y añade una de las APIs gratuitas. Opción 1 (recomendada para principiantes): usa Open-Meteo (API meteorológica gratuita, sin registro). Opción 2: obtén una clave API gratuita de OpenWeather (requiere registro, pero tiene versión gratuita). Contenido de .env para Open-Meteo: WEATHER_API=https://api.open-meteo.com/v1/forecast
⚠️ Nunca publiques el archivo .env en git o internet. Open-Meteo no requiere clave y es ideal para tu primer agente.
Text Editor (VS Code) ↗ - 5.Crea un archivo agent.js en la carpeta ai-agent y copia el código de abajo. Este agente consultará el clima según coordenadas y mostrará el resultado en la terminal.
Usa el mismo editor de texto.
Text Editor (VS Code) ↗Promptrequire('dotenv').config(); const axios = require('axios'); async function weatherAgent(latitude, longitude) { try { const apiUrl = `${process.env.WEATHER_API}?latitude=${latitude}&longitude=${longitude}¤t_weather=true`; const response = await axios.get(apiUrl); const weather = response.data.current_weather; console.log(`Temperatura: ${weather.temperature}°C`); console.log(`Velocidad del viento: ${weather.windspeed} km/h`); return weather; } catch (error) { console.error('Error en la solicitud:', error.message); } } weatherAgent(55.7558, 37.6173);Qué hace este promptEl código crea un agente que toma latitud [latitude] y longitud [longitude], envía una solicitud a la API meteorológica y muestra la temperatura y el viento. En el ejemplo usa coordenadas de Moscú (55.7558, 37.6173) - reemplázalas con las tuyas o déjalas para hacer una prueba. - 6.Ejecuta el agente en la terminal: node agent.js. Verás la temperatura y el viento actual para las coordenadas indicadas.
Si hay error sobre 'require' - asegúrate de estar en la carpeta ai-agent (usa pwd para ver la carpeta actual).
- 7.Añade seguridad: crea un archivo security.js que valide los datos antes de enviarlos a la API. Copia la línea de abajo en el agente antes de la solicitud para validar las coordenadas:
Este paso evita enviar datos incorrectos y protege contra posibles inyecciones.
Text Editor (VS Code) ↗Promptif (latitude < -90 || latitude > 90 || longitude < -180 || longitude > 180) { throw new Error('Coordenadas fuera del rango permitido'); }Qué hace este promptAñade esta comprobación al inicio de la función weatherAgent() antes de la solicitud a la API. Verifica que la latitud esté entre -90 y 90, y la longitud entre -180 y 180, lo que protege al agente contra datos de entrada incorrectos.
💰 Cuánto cuesta seguirloprecios a 2026-07
- gratisNode.jsCompletamente gratuito, con código abierto.
- gratisPaquetes npm (axios, dotenv)Todos los paquetes son gratuitos y tienen código abierto.
- gratisAPI Open-MeteoAPI gratuita sin límite de solicitudes para uso personal, sin registro requerido.
- gratisToda la recetaEl camino completo es gratuito - no requiere tarjeta de crédito, suscripciones pagadas ni créditos de API.
Pruébalo y sé el primero en marcarlo
Por qué hoy
La receta de la semana en tu correo
Los servicios de IA cambian rápido - las interfaces y los límites gratuitos pueden diferir de lo descrito.