Como Criar Sua Primeira Tarefa
Este guia detalhado vai ensinar você a criar tarefas poderosas com IA, desde o básico até exemplos avançados com multimodalidade.
Se você ainda não configurou sua API key do OpenRouter, volte para Configuração.
Pré-requisitos
Antes de começar, certifique-se de ter:
- ✅ Tarefa AI instalado e rodando
- ✅ Conta criada e autenticada
- ✅ OpenRouter API Key configurada em Settings
- ✅ Scheduler rodando (
npm run schedulerounpm run dev:full)
Verifique se o scheduler está ativo olhando os logs no terminal. Você deve ver: [Scheduler] Started - Checking tasks every minute...
Exemplo 1: Tarefa Manual Simples
Vamos começar com o mais básico: uma tarefa que executa apenas quando você clica em "Run Now".
Caso de Uso
Gerador de Headlines de Marketing
Você precisa gerar títulos chamativos para posts de blog sobre tecnologia.
Passo a Passo
1. Acessar Tela de Nova Tarefa
- No Dashboard, clique em "+ Nova Tarefa" (botão azul no canto superior direito)
- Você verá um formulário dividido em seções
2. Preencher Informações Básicas
Nome: Gerador de Headlines de Marketing
Descrição: Gera 5 títulos chamativos para posts de blog techO nome e descrição ajudam você a organizar suas tarefas. Escolha nomes descritivos!
3. Selecionar Modelo de IA
Clique no dropdown "AI Model" e escolha:
Google: Gemini 2.5 Flash (Experimental)
Por que Gemini Flash?
- ⚡ Rápido (resposta em 2-5 segundos)
- 💰 Barato (muito mais em conta que GPT-4)
- ✅ Qualidade excelente para tarefas criativas
- 🆓 Grátis via OpenRouter (com limites)
4. Configurar Prompts
System Prompt (instruções gerais):
Você é um especialista em copywriting e marketing de conteúdo.
Sua missão é criar headlines irresistíveis que:
- Capturam atenção imediatamente
- Prometem valor claro
- Usam gatilhos mentais (curiosidade, urgência, benefício)
- São otimizadas para SEO
Sempre gere exatamente 5 opções numeradas.User Message (input específico):
Tópico: "Como usar IA para automatizar tarefas repetitivas"
Público: Desenvolvedores e product managers
Tom: Profissional mas acessívelSepare System Prompt (comportamento geral) de User Message (input específico). Isso deixa a task mais reutilizável!
5. Configurar Parâmetros
Na seção "Model Parameters":
Temperature: 0.8 // Alta criatividade
Max Tokens: 500 // Suficiente para 5 headlines
Top P: 0.95 // Padrão6. Configurar Agendamento
Como é uma task manual:
Schedule Type: Manual
✅ Deixe desabilitada a opção "Recurring"
7. Configurar Notificações (Opcional)
Email: ✅ Ativado
Assim você receberá os resultados por email também.
8. Salvar e Executar
- Clique em "Criar Tarefa"
- Na lista de tarefas, encontre "Gerador de Headlines de Marketing"
- Clique em "Run Now" (botão play ▶️)
- Aguarde 5-10 segundos
Ver o Resultado
- Clique no card da tarefa
- Vá para a aba "Executions"
- Clique na execução mais recente
- Visualize o Output
Exemplo de resultado:
1. Como IA pode eliminar 80% das suas tarefas repetitivas (em 30 minutos)
2. Desenvolvedores estão economizando 15h/semana com esta automação de IA
3. O guia definitivo para automatizar tarefas chatas usando IA (2025)
4. Pare de perder tempo: Automatize estas 7 tarefas com IA agora mesmo
5. Como product managers estão usando IA para 10x sua produtividade
Parabéns! Você criou e executou sua primeira tarefa! 🎉
Exemplo 2: Tarefa Agendada Recorrente
Agora vamos criar algo mais poderoso: uma tarefa que executa automaticamente todos os dias.
Caso de Uso
Resumo Diário de Notícias de IA
Você quer receber um resumo das principais notícias de IA toda manhã às 8h.
Passo a Passo
1. Informações Básicas
Nome: Resumo Diário de Notícias de IA
Descrição: Resumo automático das principais notícias de IA e Machine Learning2. Selecionar Modelo
Google: Gemini 2.5 Pro (Experimental)
Por que Gemini Pro?
- 🧠 Melhor raciocínio que Flash
- 📚 Contexto maior (1M tokens)
- ✍️ Escrita mais refinada
- 🆓 Ainda gratuito via OpenRouter
3. Configurar Prompts
System Prompt:
Você é um analista especializado em Inteligência Artificial e Machine Learning.
Sua tarefa é criar um resumo diário das principais notícias do setor.
Formato esperado:
# Resumo de IA - [Data]
## Principais Destaques (3-5 itens)
- **[Título]**: Descrição breve (2-3 linhas)
- **[Título]**: Descrição breve (2-3 linhas)
...
## Tecnologias em Alta
- Lista de tecnologias/frameworks mencionados
## Empresas em Destaque
- Principais empresas mencionadas nas notícias
## Links Importantes
- URL1: Título
- URL2: Título
Tom: Profissional, informativo, direto ao ponto.User Message (pode deixar vazio ou adicionar filtros):
Foque em: Modelos de linguagem, ferramentas de AI coding, Computer Vision
Ignore: Notícias de mercado financeiro, blockchain, criptomoedas4. Parâmetros
Temperature: 0.3 // Mais factual, menos criativo
Max Tokens: 2000 // Resumo pode ser longo5. Agendamento Recorrente
Aqui está a parte importante:
Schedule Type: Recurring
Interval: Daily
Time: 08:00
Timezone: America/Sao_Paulo
Cron Expression gerada automaticamente: 0 8 * * *
O scheduler vai verificar esta task todos os dias às 8h da manhã (horário de Brasília) e executá-la automaticamente.
6. Notificações
Email: ✅ Ativado
Você receberá o resumo no seu email todo dia às 8h!
7. Ativar a Task
⚠️ Importante: Após criar a task, certifique-se de:
- Toggle o switch "Active" para ON (verde)
- Verificar se o scheduler está rodando
Tasks inativas não são executadas automaticamente, mesmo com agendamento configurado!
Testar Agora
Não quer esperar até amanhã às 8h? Execute agora:
- Clique em "Run Now"
- Aguarde 10-20 segundos (Gemini Pro é mais lento que Flash)
- Veja o resultado na aba Executions
Exemplo 3: Task com Multimodalidade (Imagens)
Vamos para o nível avançado: processar imagens com IA.
Caso de Uso
Análise de Screenshots de UI
Você quer analisar screenshots de interfaces e receber feedback de UX/UI.
Passo a Passo
1. Informações Básicas
Nome: Análise de UI/UX de Screenshots
Descrição: Analisa screenshots de interfaces e sugere melhorias de design2. Selecionar Modelo Multimodal
⚠️ Crítico: Escolha um modelo que suporte imagens!
Google: Gemini 2.5 Flash (Experimental)
ou
Anthropic: Claude 3.5 Sonnet
Modelos text-only como GPT-3.5 ou Mistral 7B NÃO suportam imagens!
3. Configurar Prompts
System Prompt:
Você é um especialista em UX/UI Design com 10+ anos de experiência.
Ao analisar screenshots de interfaces, você deve avaliar:
1. **Hierarquia Visual**
- Elementos mais importantes estão em destaque?
- Uso de tamanhos, cores e espaçamento
2. **Usabilidade**
- Interface intuitiva?
- CTAs claros?
- Navegação óbvia?
3. **Acessibilidade**
- Contraste adequado?
- Tamanho de fontes legível?
- Cores amigáveis para daltônicos?
4. **Design System**
- Consistência de componentes?
- Espaçamento padronizado?
- Tipografia coesa?
Formato de resposta:
## Análise Geral
[Resumo em 2-3 linhas]
## Pontos Fortes
- [Item 1]
- [Item 2]
...
## Pontos de Melhoria
- [Item 1] → Sugestão: [solução]
- [Item 2] → Sugestão: [solução]
...
## Score Geral
- Hierarquia Visual: X/10
- Usabilidade: X/10
- Acessibilidade: X/10
- Consistência: X/10
**Total**: XX/40User Message:
Contexto: Landing page de SaaS B2B
Público: CTOs e Engineering Managers
Objetivo: Conversão para trial gratuito4. Upload de Imagem
Na seção "Files":
- Clique em "Upload Image"
- Selecione seu screenshot (PNG, JPG, WEBP)
- Aguarde upload (máx 20MB)
- Veja o preview da imagem
Você pode fazer upload de até 5 imagens por task. A IA analisará todas juntas!
5. Parâmetros
Temperature: 0.4 // Balanceado entre criatividade e precisão
Max Tokens: 3000 // Análise pode ser detalhada6. Agendamento
Como é uma análise pontual:
Schedule Type: Manual
7. Executar
- Clique em "Criar Tarefa"
- Clique em "Run Now"
- Aguarde 15-30 segundos (processamento de imagem é mais lento)
Resultado Esperado
## Análise Geral
Landing page bem estruturada com hierarquia visual clara. Hero section forte, mas alguns elementos de conversão podem ser otimizados.
## Pontos Fortes
- Hero section com proposta de valor clara e visível
- CTA principal bem destacado (botão azul com alto contraste)
- Social proof bem posicionado (logos de clientes)
- Espaçamento consistente entre seções
## Pontos de Melhoria
- **Formulário muito longo** → Sugestão: Reduzir para apenas Email + Nome
- **Falta de urgência no CTA** → Sugestão: Adicionar "Trial grátis por 14 dias"
- **Contraste baixo no footer** → Sugestão: Aumentar contraste do texto
- **Falta de mobile preview** → Sugestão: Garantir responsividade
## Score Geral
- Hierarquia Visual: 8/10
- Usabilidade: 7/10
- Acessibilidade: 6/10
- Consistência: 9/10
**Total**: 30/40A IA analisou sua interface visualmente e deu feedback acionável! 🎨
Exemplo 4: Task com Webhook Integration
Vamos integrar o Tarefa AI com outro sistema usando webhooks.
Caso de Uso
Alerta de Preço de Cripto → Slack
Quando Bitcoin atingir um preço específico, enviar notificação para o Slack da equipe.
Passo a Passo
1. Configurar Webhook URL
Primeiro, crie um Incoming Webhook no Slack:
- Vá em Slack → Apps → Incoming Webhooks
- Clique em "Add to Slack"
- Escolha o canal (ex:
#alerts) - Copie a URL:
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXX
2. Criar Task
Nome: Alerta de Preço BTC → Slack
Descrição: Envia alerta quando BTC atinge threshold3. Selecionar Modelo
Google: Gemini 2.5 Flash (Experimental)
4. Configurar Prompts
System Prompt:
Você é um assistente de trading de criptomoedas.
Analise o preço atual do Bitcoin e gere um alerta formatado para Slack.
Formato esperado (JSON):
{
"text": "🚨 *Alerta de Preço - Bitcoin*",
"blocks": [
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "Bitcoin atingiu *$XX,XXX*\n_[Aumento/Queda] de X% nas últimas 24h_"
}
},
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "📊 *Análise*: [Sua análise aqui]"
}
}
]
}
Retorne APENAS o JSON válido, sem markdown ou explicações.User Message:
Preço atual: $67,450
Threshold: $65,000 (atingido!)
Variação 24h: +3.2%5. Agendamento
Schedule Type: Recurring
Interval: Every 15 minutes
Cron: */15 * * * *
A task vai checar o preço a cada 15 minutos.
6. Configurar Webhook
Na seção "Notifications":
Webhook URL: https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXX
Send on: Success
O webhook será acionado toda vez que a task completar com sucesso. O output será enviado para o Slack!
7. Executar
- Salve a task
- Ative (toggle ON)
- Execute manualmente para testar
Resultado
Você verá uma mensagem no Slack:
🚨 Alerta de Preço - Bitcoin
Bitcoin atingiu $67,450
Aumento de 3.2% nas últimas 24h
📊 Análise: Tendência de alta confirmada. Rompeu resistência
de $66,000 com volume forte. Próximo alvo: $70,000.
Exemplo 5: Task com Notion Integration
Vamos salvar outputs automaticamente no Notion.
Caso de Uso
Gerador de Conteúdo para Blog → Notion Database
Gerar ideias de posts para blog e salvar automaticamente em um Notion database.
Passo a Passo
1. Configurar Notion Integration
-
Clique em "+ New integration"
-
Dê um nome: "Tarefa AI Integration"
-
Copie o Internal Integration Token (começa com
secret_...) -
Vá na sua página/database do Notion
-
Clique em "•••" → "Add connections" → Selecione sua integration
2. Adicionar API Key no Tarefa AI
- Dashboard → Settings → "API Keys"
- Adicione:
Notion API Key: secret_xxxxxxxxxxxxxxxxxxxxx Notion Database ID: [ID do seu database]
3. Criar Task
Nome: Gerador de Ideias de Posts → Notion
Descrição: Gera 10 ideias de posts sobre IA e salva no Notion4. Configurar Prompts
System Prompt:
Você é um content strategist especializado em IA e tecnologia.
Gere 10 ideias de posts para blog seguindo este formato:
TÍTULO: [Título chamativo]
DESCRIÇÃO: [Resumo em 2 linhas]
TAGS: [3-5 tags relevantes]
DIFICULDADE: [Iniciante/Intermediário/Avançado]
TEMPO ESTIMADO: [Tempo de leitura]
---
Repita para 10 ideias diferentes.5. Agendamento
Schedule Type: Recurring
Interval: Weekly
Day: Monday
Time: 09:00
Timezone: America/Sao_Paulo
Cron: 0 9 * * 1
Toda segunda às 9h, novas ideias serão geradas!
6. Configurar Notion
Notion Integration: ✅ Ativado
Database: "Blog Post Ideas"
7. Executar
Ao executar, a task vai:
- Gerar 10 ideias de posts
- Parsear o output
- Criar 10 páginas novas no Notion database
- Cada página terá: Título, Descrição, Tags, etc.
Seu pipeline de conteúdo está automatizado! 📝
Boas Práticas
1. Nomeie Tasks Descritivamente
❌ Ruim: "Task 1", "Teste", "Nova task"
✅ Bom: "Resumo Diário de Vendas Q4", "Análise de Sentimento - Reviews"
2. Use System Prompt para Comportamento Geral
System Prompt: Instruções gerais, formato, tom, regras
User Message: Input específico que muda a cada execuçãoIsso permite reutilizar a task com diferentes inputs.
3. Escolha o Modelo Certo
| Caso de Uso | Modelo Recomendado |
|---|---|
| Texto criativo | Gemini 2.5 Flash |
| Análise técnica | Claude 3.5 Sonnet |
| Code generation | Qwen 2.5 Coder |
| Raciocínio complexo | o3-mini |
| Imagens (barato) | Gemini 2.5 Flash |
| Imagens (qualidade) | Claude 3.5 Sonnet |
4. Ajuste Temperature
// Tarefas factuais/técnicas
temperature: 0.0 - 0.3
// Tarefas criativas/marketing
temperature: 0.7 - 1.05. Teste Manualmente Antes de Agendar
Sempre execute "Run Now" primeiro para garantir que:
- O prompt está gerando o output esperado
- O modelo é o adequado
- Os parâmetros estão ajustados
6. Configure Notificações Relevantes
// Para tasks críticas
{
email: true,
webhook: "https://api.seu-sistema.com/alerts"
}
// Para tasks de teste
{
// Sem notificações para não poluir inbox
}7. Use Timezones Corretamente
// ❌ Errado (vai usar UTC)
timezone: undefined
// ✅ Correto
timezone: "America/Sao_Paulo"8. Monitore Custos
Veja os custos acumulados em:
- Dashboard → Analytics → Usage & Costs
Gemini 2.5 é geralmente 10x mais barato que GPT-4 e tem qualidade similar para maioria dos casos de uso!
Troubleshooting
Task não está executando automaticamente
Causas comuns:
- Task não está ativa (toggle OFF)
- Scheduler não está rodando
- Cron expression inválida
- Timezone incorreto
Solução:
# Verificar se scheduler está rodando
ps aux | grep scheduler
# Iniciar scheduler
npm run scheduler
# Ver logs
npm run scheduler -- --verboseExecution falhou com erro 401
Causa: API key inválida ou expirada
Solução:
- Vá em Settings → API Keys
- Atualize sua OpenRouter API key
- Teste novamente
Output está cortado/incompleto
Causa: maxTokens muito baixo
Solução:
- Edite a task
- Aumente
Max Tokens(ex: de 1000 para 4000) - Execute novamente
Imagem não está sendo processada
Causas:
- Modelo não suporta imagens (text-only)
- Arquivo muito grande (> 20MB)
- Formato não suportado
Solução:
- Use Gemini 2.5 ou Claude 3.5 Sonnet
- Comprima a imagem
- Converta para PNG/JPG
Exemplos Prontos para Copiar
1. Gerador de Social Media Posts
{
name: "Gerador de Posts para LinkedIn",
model: "google/gemini-2.5-flash",
systemPrompt: `
Gere posts profissionais para LinkedIn sobre tecnologia.
Formato:
- Gancho na primeira linha
- Desenvolvimento em 3-5 parágrafos curtos
- CTA no final
- 3-5 hashtags relevantes
Tom: Profissional mas conversacional
`,
userMessage: "Tópico: Como IA está mudando o desenvolvimento de software",
scheduleType: "recurring",
cronExpression: "0 10 * * 1,3,5", // Seg, Qua, Sex às 10h
notifications: { email: true }
}2. Monitoramento de Competitors
{
name: "Análise de Competitors - Resumo Semanal",
model: "anthropic/claude-3.5-sonnet",
systemPrompt: `
Analise as atualizações de competitors e gere um relatório executivo.
Estrutura:
1. Principais Lançamentos
2. Mudanças de Pricing
3. Features Novas
4. Posicionamento de Marketing
5. Recomendações para nossa estratégia
`,
userMessage: "Competitors: Notion, ClickUp, Asana, Monday.com",
scheduleType: "recurring",
cronExpression: "0 9 * * 1", // Segunda às 9h
notifications: { email: true, notion: true }
}3. Code Review Automatizado
{
name: "Code Review - Pull Requests",
model: "qwen/qwen-2.5-coder-32b-instruct",
systemPrompt: `
Você é um senior engineer fazendo code review.
Analise o código e forneça:
1. Pontos fortes
2. Issues de segurança
3. Problemas de performance
4. Sugestões de refactoring
5. Score geral (1-10)
`,
scheduleType: "manual", // Executado via webhook do GitHub
notifications: { webhook: "https://api.github.com/repos/..." }
}Próximos Passos
Parabéns! Você agora sabe criar tasks poderosas com o Tarefa AI.
Explorar Features Avançadas
Admin Panel, Analytics, Webhooks e mais
API Reference
Integre Tarefa AI com seus sistemas
Exemplos de Use Cases
30+ exemplos práticos de automações
Deploy para Produção
Coloque sua instância no ar
Templates Prontos
Acesse nossa biblioteca de templates:
- Marketing: Geração de conteúdo, social media, email campaigns
- Desenvolvimento: Code review, bug triage, documentation
- Vendas: Lead scoring, follow-ups, relatórios
- Suporte: Análise de tickets, FAQs, sentiment analysis
- Finanças: Relatórios, análise de investimentos, alertas
🎓 Você é agora um expert em Tarefa AI!
Você aprendeu a criar tasks manuais, agendadas, com multimodalidade e integrações. Hora de automatizar seus workflows e economizar horas toda semana!