← Receitas de IA do diaTrabalho✓ Verificado 22 de jul. de 2026

Crie seu primeiro agente de IA com acesso seguro a API

Agente funcional em 7 minutos sem serviços pagos - apenas código local e APIs gratuitas

  1. 1.Instale Node.js (se não tiver). Abra o terminal e execute: node --version. Se não aparecer nada - baixe em nodejs.org e instale.

    Node.js é gratuito. Escolha a versão LTS.

    Node.js ↗
  2. 2.Crie uma pasta do projeto. No terminal, execute: mkdir ai-agent && cd ai-agent && npm init -y

    Os comandos funcionam no Windows (PowerShell), macOS e Linux igualmente.

  3. 3.Instale os pacotes necessários: npm install axios dotenv. Isso permitirá que o agente faça requisições a APIs e armazene chaves com segurança.

    Todos os pacotes são gratuitos. São baixados do repositório npm.

    npm ↗
  4. 4.Crie um arquivo .env na raiz da pasta ai-agent e adicione uma das chaves de API gratuitas. Opção 1 (recomendada para iniciantes): use Open-Meteo (API de previsão do tempo gratuita, não requer registro). Opção 2: obtenha uma chave de API gratuita do OpenWeather (requer registro, mas tem plano gratuito). Conteúdo do .env para Open-Meteo: WEATHER_API=https://api.open-meteo.com/v1/forecast

    ⚠️ Nunca publique o arquivo .env no git ou na internet. Open-Meteo não requer chave e é ideal para o primeiro agente.

    Text Editor (VS Code) ↗
  5. 5.Crie um arquivo agent.js na pasta ai-agent e copie o código abaixo. Este agente fará solicitações de previsão do tempo pelas coordenadas e exibirá o resultado no terminal.

    Use o mesmo editor de texto.

    Text Editor (VS Code) ↗
    Prompt
    require('dotenv').config();
const axios = require('axios');

async function weatherAgent(latitude, longitude) {
  try {
    const apiUrl = `${process.env.WEATHER_API}?latitude=${latitude}&longitude=${longitude}&current_weather=true`;
    const response = await axios.get(apiUrl);
    const weather = response.data.current_weather;
    console.log(`Temperatura: ${weather.temperature}°C`);
    console.log(`Velocidade do vento: ${weather.windspeed} km/h`);
    return weather;
  } catch (error) {
    console.error('Erro na requisição:', error.message);
  }
}

weatherAgent(-23.5505, -46.6333);
    O que este prompt fazO código cria um agente que recebe latitude e longitude, envia uma requisição à API de previsão do tempo e exibe a temperatura e o vento. No exemplo, as coordenadas de São Paulo (-23.5505, -46.6333) - substitua pelas suas, ou deixe como está para testar.
  6. 6.Execute o agente no terminal: node agent.js. Você verá a temperatura e o vento atuais para as coordenadas informadas.

    Se der erro sobre 'require' - verifique que está na pasta ai-agent (o comando pwd mostra a pasta atual).

  7. 7.Adicione segurança: crie um arquivo security.js com validação de dados de entrada antes de enviar à API. Copie a linha abaixo no agente antes da requisição para validar as coordenadas:

    Este passo evita o envio de dados incorretos e protege contra possíveis injeções.

    Text Editor (VS Code) ↗
    Prompt
    if (latitude < -90 || latitude > 90 || longitude < -180 || longitude > 180) {
  throw new Error('Coordenadas fora do intervalo permitido');
}
    O que este prompt fazAdicione esta validação no início da função weatherAgent() antes da requisição à API. Isso garante que a latitude esteja entre -90 e 90, e a longitude entre -180 e 180, protegendo o agente contra dados de entrada inválidos.
💰 Quanto custa acompanharpreços em 2026-07
  • grátisNode.jsTotalmente gratuito, com código-fonte aberto.
  • grátisPacotes npm (axios, dotenv)Todos os pacotes são gratuitos e com código-fonte aberto.
  • grátisOpen-Meteo APIAPI gratuita sem limite de requisições para uso pessoal, registro não é necessário.
  • grátisReceita completaToda a receita é gratuita - não requer cartão de crédito, assinaturas pagas ou créditos de API.
Experimente e seja o primeiro a marcar

Por que hoje

Open-Meteo Documentationweb
Node.js Officialweb
npm Documentationweb

Serviços de IA mudam rápido - interfaces e limites gratuitos podem diferir do descrito.