Quickstart: 5 Minutos para sua Primeira Tarefa

Este guia rápido vai levar você do zero à execução da sua primeira tarefa agendada com IA em apenas 5 minutos.

O que você vai conseguir fazer

Ao final deste quickstart, você terá:

• ✅ Tarefa AI rodando localmente
• ✅ Uma conta criada
• ✅ Sua primeira tarefa agendada
• ✅ Execução automática funcionando
• ✅ Notificações configuradas (opcional)

Passo 1: Instalação Relâmpago

Execute estes comandos no terminal:

# Clone o repositório
git clone https://github.com/your-username/tarefa-ai.git
cd tarefa-ai
 
# Instale dependências
npm install
 
# Configure variáveis de ambiente
cp .env.example .env.local
 
# Gere uma chave de criptografia
openssl rand -hex 32

Copie a saída do último comando e cole no .env.local:

ENCRYPTION_KEY="sua-chave-gerada-aqui"

Passo 2: Inicie o Banco e a Aplicação

# Inicie o PostgreSQL
docker-compose up -d
 
# Aplique as migrações
npm run db:push
npx tsx scripts/apply-admin-migration.ts
 
# Inicie a aplicação + scheduler
npm run dev:full

Passo 3: Criar Conta

1. Acesse http://localhost:3000
2. Clique em "Começar Agora" ou "Sign Up"
3. Preencha seus dados:
   • Nome completo
   • Email
   • Senha forte (mínimo 8 caracteres)
4. Clique em "Criar Conta"

Passo 4: Configurar OpenRouter API Key

Antes de criar tarefas, você precisa de uma chave de API do OpenRouter:

1. Acesse https://openrouter.ai/
2. Crie uma conta (se não tiver)
3. Vá em Settings → API Keys
4. Clique em "Create New Key"
5. Copie a chave (começa com sk-or-v1-...)

Agora, no Tarefa AI:

1. Vá para Dashboard → Settings (ícone de engrenagem)
2. Clique na aba "API Keys"
3. Cole sua chave OpenRouter
4. Clique em "Salvar API Key"

Passo 5: Criar Sua Primeira Tarefa

Agora vem a parte divertida! Vamos criar uma tarefa que gera um resumo diário de notícias.

5.1. Acesse a Tela de Nova Tarefa

No Dashboard, clique em "+ Nova Tarefa" ou "Create Task".

5.2. Preencha os Dados Básicos

Nome da Tarefa: Resumo Diário de Notícias Tech
Descrição: Gera um resumo das principais notícias de tecnologia do dia

5.3. Escolha o Modelo de IA

Clique no dropdown "AI Model" e selecione:

Google: Gemini 2.5 Pro (Experimental)

5.4. Escreva o Prompt

No campo "System Prompt", cole:

Você é um assistente especializado em resumir notícias de tecnologia.
Gere um resumo das principais notícias tech das últimas 24 horas.
Organize em 5 tópicos com título e descrição curta.
Use um tom profissional mas acessível.

No campo "User Message" (opcional), você pode adicionar:

Foque em: IA, Startups, Criptomoedas e Web3

5.5. Configure o Agendamento

Na seção "Scheduling":

1. Tipo: Selecione "Recorrente"
2. Intervalo: Selecione "Diário"
3. Horário: Escolha "09:00"
4. Timezone: Selecione seu fuso horário (ex: America/Sao_Paulo)

5.6. Configure Notificações (Opcional)

Na seção "Notifications", marque:

• ✅ Email (você receberá o resultado por email)

5.7. Salve e Ative

1. Clique em "Criar Tarefa"
2. Na tela de confirmação, toggle o switch "Active" para ON (verde)

Passo 6: Executar Agora (Teste Imediato)

Não quer esperar até amanhã às 9h? Execute agora:

1. Na lista de tarefas, encontre "Resumo Diário de Notícias Tech"
2. Clique no botão "Run Now" (ícone de play ▶️)
3. Aguarde 5-15 segundos

Visualizar o Resultado

1. Clique no card da tarefa para abrir os detalhes
2. Vá para a aba "Executions"
3. Clique na execução mais recente (status: "completed" ✅)
4. Visualize:
   • ✅ Output: O resumo gerado pela IA
   • ✅ Metadata: Tokens usados, tempo de execução, modelo
   • ✅ Logs: Processo completo de execução

Passo 7: Explorar Features Avançadas

Agora que você dominou o básico, explore:

Multimodalidade (Imagens)

Crie uma tarefa que analisa imagens:

1. Nova tarefa → Modelo: "Google: Gemini 2.5 Flash"
2. Na seção "Files", faça upload de uma imagem
3. Prompt: "Descreva esta imagem em detalhes"
4. Execute e veja a mágica! 🖼️✨

Integrações

Configure notificações avançadas:

• WhatsApp: Receba resultados via WhatsApp
• Notion: Salve outputs automaticamente em páginas Notion
• Webhook: Envie resultados para qualquer API

Templates

Use templates prontos:

1. Dashboard → "Templates"
2. Escolha: "Daily Content Generator", "Code Review Assistant", etc.
3. Personalize e salve

Comandos Úteis

Verificar Status do Sistema

# Ver logs em tempo real
npm run dev:full
 
# Ver execuções do scheduler
# (o output mostrará quando tasks forem executadas)

Gerenciar Banco de Dados

# Abrir Drizzle Studio (GUI do banco)
npm run db:studio
 
# Limpar e resetar banco (cuidado!)
docker-compose down -v && docker-compose up -d
npm run db:push

Troubleshooting

# Verificar saúde da API
curl http://localhost:3000/api/health
 
# Ver logs do scheduler
npm run scheduler
 
# Reiniciar tudo
docker-compose restart

Próximos Passos

Você completou o quickstart! Agora aprofunde seu conhecimento:

Checklist de Conclusão

Marque o que você já conseguiu fazer:

• Instalei e rodei Tarefa AI localmente
• Criei uma conta no sistema
• Configurei minha OpenRouter API Key
• Criei minha primeira tarefa agendada
• Executei a tarefa manualmente (Run Now)
• Vi o resultado na aba Executions
• (Bonus) Configurei notificações por email
• (Bonus) Testei upload de imagem com Gemini

Dúvidas Frequentes

Por que preciso do OpenRouter?

OpenRouter é um agregador que dá acesso a 200+ modelos de IA (Claude, GPT, Gemini, etc.) com uma única API key. É mais simples e barato do que gerenciar múltiplas APIs.

Posso usar outros provedores de IA?

Atualmente, Tarefa AI é otimizado para OpenRouter. Suporte para Anthropic Direct e OpenAI direto está no roadmap.

Quanto custa usar?

• Tarefa AI: Gratuito (open-source)
• OpenRouter: Você paga apenas o que usar (alguns modelos são gratuitos)
• Hospedagem: Grátis na Vercel (plano hobby)

Como funciona o agendamento?

Usamos node-cron para executar tarefas nos horários configurados. O scheduler roda em background e checa a cada minuto quais tarefas devem ser executadas.

Posso executar tarefas em paralelo?

Sim! Crie múltiplas tarefas e elas serão executadas simultaneamente (respeitando os limites de rate da API).

Ajuda e Suporte

Precisa de ajuda?

• 📚 Documentação: Navegue pelos guias completos
• 💬 Community: Discord ou GitHub Discussions
• 🐛 Bug Report: Abra uma issue no GitHub
• 📧 Email: suporte@tarefaai.com