Criar Primeira Tarefa

tutorial
tasks
exemplos
primeiros-passos

Guia completo passo a passo para criar sua primeira tarefa agendada com IA - Da configuração à execução

Por Tarefa AI Team17/10/2025
Nesta Página

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.


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 scheduler ou npm run dev:full)

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

  1. No Dashboard, clique em "+ Nova Tarefa" (botão azul no canto superior direito)
  2. 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 tech

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í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ão

6. 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

  1. Clique em "Criar Tarefa"
  2. Na lista de tarefas, encontre "Gerador de Headlines de Marketing"
  3. Clique em "Run Now" (botão play ▶️)
  4. Aguarde 5-10 segundos

Ver o Resultado

  1. Clique no card da tarefa
  2. Vá para a aba "Executions"
  3. Clique na execução mais recente
  4. 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

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 Learning

2. 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, criptomoedas

4. Parâmetros

Temperature: 0.3      // Mais factual, menos criativo
Max Tokens: 2000      // Resumo pode ser longo

5. 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 * * *

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:

  1. Toggle o switch "Active" para ON (verde)
  2. Verificar se o scheduler está rodando

Testar Agora

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

  1. Clique em "Run Now"
  2. Aguarde 10-20 segundos (Gemini Pro é mais lento que Flash)
  3. 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 design

2. Selecionar Modelo Multimodal

⚠️ Crítico: Escolha um modelo que suporte imagens!

Google: Gemini 2.5 Flash (Experimental)
ou
Anthropic: Claude 3.5 Sonnet

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/40

User Message:

Contexto: Landing page de SaaS B2B
Público: CTOs e Engineering Managers
Objetivo: Conversão para trial gratuito

4. Upload de Imagem

Na seção "Files":

  1. Clique em "Upload Image"
  2. Selecione seu screenshot (PNG, JPG, WEBP)
  3. Aguarde upload (máx 20MB)
  4. Veja o preview da imagem

5. Parâmetros

Temperature: 0.4      // Balanceado entre criatividade e precisão
Max Tokens: 3000      // Análise pode ser detalhada

6. Agendamento

Como é uma análise pontual:

Schedule Type: Manual

7. Executar

  1. Clique em "Criar Tarefa"
  2. Clique em "Run Now"
  3. 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/40

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:

  1. Vá em Slack → AppsIncoming Webhooks
  2. Clique em "Add to Slack"
  3. Escolha o canal (ex: #alerts)
  4. 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 threshold

3. 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

7. Executar

  1. Salve a task
  2. Ative (toggle ON)
  3. 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

  1. Vá em https://www.notion.so/my-integrations

  2. Clique em "+ New integration"

  3. Dê um nome: "Tarefa AI Integration"

  4. Copie o Internal Integration Token (começa com secret_...)

  5. Vá na sua página/database do Notion

  6. Clique em "•••""Add connections" → Selecione sua integration

2. Adicionar API Key no Tarefa AI

  1. Dashboard → Settings"API Keys"
  2. 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 Notion

4. 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:

  1. Gerar 10 ideias de posts
  2. Parsear o output
  3. Criar 10 páginas novas no Notion database
  4. Cada página terá: Título, Descrição, Tags, etc.

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ção

Isso permite reutilizar a task com diferentes inputs.

3. Escolha o Modelo Certo

Caso de UsoModelo Recomendado
Texto criativoGemini 2.5 Flash
Análise técnicaClaude 3.5 Sonnet
Code generationQwen 2.5 Coder
Raciocínio complexoo3-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.0

5. 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 → AnalyticsUsage & Costs

Troubleshooting

Task não está executando automaticamente

Causas comuns:

  1. Task não está ativa (toggle OFF)
  2. Scheduler não está rodando
  3. Cron expression inválida
  4. Timezone incorreto

Solução:

# Verificar se scheduler está rodando
ps aux | grep scheduler
 
# Iniciar scheduler
npm run scheduler
 
# Ver logs
npm run scheduler -- --verbose

Execution falhou com erro 401

Causa: API key inválida ou expirada

Solução:

  1. Vá em Settings → API Keys
  2. Atualize sua OpenRouter API key
  3. Teste novamente

Output está cortado/incompleto

Causa: maxTokens muito baixo

Solução:

  1. Edite a task
  2. Aumente Max Tokens (ex: de 1000 para 4000)
  3. Execute novamente

Imagem não está sendo processada

Causas:

  1. Modelo não suporta imagens (text-only)
  2. Arquivo muito grande (> 20MB)
  3. Formato não suportado

Solução:

  1. Use Gemini 2.5 ou Claude 3.5 Sonnet
  2. Comprima a imagem
  3. 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.


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

Ver todos os templates →


🎓 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!