> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sistema de tarefas

> O Agent divide o trabalho em tarefas que você pode revisar, executar em segundo plano e aplicar de volta à sua versão principal.

## O que é o sistema de tarefas?

Uma **tarefa** é uma unidade de trabalho que o Agent pode planejar e executar. As tarefas permitem que o Agent separe um objetivo maior em partes menores, para que você possa revisar cada parte antes que ela altere seu app.

O Agent pode trabalhar em dois lugares: a **thread principal** e as **tarefas em segundo plano**. A thread principal é a conversa onde você descreve o que quer, refina a direção e decide o que é aplicado à sua versão principal. As tarefas em segundo plano são threads separadas onde o Agent trabalha de forma independente em cópias isoladas do seu projeto.

Use a thread principal para direcionamento e decisões. Use as tarefas em segundo plano para execução que pode acontecer em paralelo. As tarefas em segundo plano não alteram sua versão principal até que você as revise e aplique.

O sistema de tarefas é como o Agent organiza esse trabalho. Quando você descreve o que quer criar, o Agent pode dividir sua solicitação em tarefas discretas e colocá-las em um quadro com colunas: **Rascunhos**, **Ativo**, **Pronto** e **Concluído**.

<Frame>
  <img src="https://mintcdn.com/replit/L22mbBMLs80H8_c8/images/replitai/task-board-progress.png?fit=max&auto=format&n=L22mbBMLs80H8_c8&q=85&s=3b4ef2fbede2d057e40c138956ccd74d" alt="Quadro de tarefas mostrando tarefas organizadas nas colunas Rascunhos, Ativo, Pronto e Concluído" width="3456" height="1984" data-path="images/replitai/task-board-progress.png" />
</Frame>

Cada tarefa se move da esquerda para a direita à medida que avança, para que você possa ver de relance o que está planejado, o que o Agent está trabalhando, o que está pronto para sua revisão e o que está concluído. As tarefas em segundo plano são enfileiradas automaticamente com base no seu plano, para que o trabalho continue avançando sem sobrecarregar sua thread principal.

Quando uma tarefa está pronta, você revisa as alterações e as aplica de volta à sua versão principal — ou as descarta se não forem o que você queria.

## Como funcionam as tarefas em segundo plano

<Steps>
  <Step title="Planeje suas tarefas">
    Inicie uma conversa na thread principal ou crie uma nova thread e planeje lá. O Agent revisa seu projeto, identifica o que teria mais impacto e elabora um plano detalhado para cada tarefa — incluindo o que fará e como é o "concluído".

    <Frame>
      <img src="https://mintcdn.com/replit/L22mbBMLs80H8_c8/images/replitai/task-describe-idea.png?fit=max&auto=format&n=L22mbBMLs80H8_c8&q=85&s=bfeb272f42640f20c393dda187f3f817" alt="Descrevendo o que construir na thread principal, com o Agent propondo e executando tarefas" width="3430" height="1986" data-path="images/replitai/task-describe-idea.png" />
    </Frame>
  </Step>

  <Step title="Revise e aceite">
    O Agent propõe um conjunto de tarefas — cada uma com título, descrição e um plano detalhado que você pode inspecionar com **Ver plano**. Revise a lista completa e escolha:

    * **Aceitar tarefas** — Inicie todas as tarefas e envie-as para o segundo plano
    * **Revisar plano** — Peça ao Agent para ajustar as tarefas antes de começar

    <Frame>
      <img src="https://mintcdn.com/replit/L22mbBMLs80H8_c8/images/replitai/task-accept-plans.png?fit=max&auto=format&n=L22mbBMLs80H8_c8&q=85&s=e788fc99c5fce2644d144f88419ba00c" alt="Caixa de diálogo de planos de tarefas criados mostrando quatro tarefas propostas com opções de Aceitar tarefas e Revisar plano" width="3430" height="1986" data-path="images/replitai/task-accept-plans.png" />
    </Frame>
  </Step>

  <Step title="As tarefas começam a executar">
    Uma vez aceitas, as tarefas começam a executar em cópias isoladas do seu projeto. O Core executa 1 tarefa em segundo plano por vez, enquanto o Pro suporta até 10 tarefas em segundo plano simultâneas. Sua versão principal permanece intocada até que você decida aplicar as alterações. Você pode acompanhar o progresso de duas formas:

    * **Visualização de thread** — Cada tarefa é executada em sua própria thread com um indicador de status ao vivo, para que você possa acompanhar ou entrar na conversa de qualquer tarefa

    <Frame>
      <img src="https://mintcdn.com/replit/L22mbBMLs80H8_c8/images/replitai/task-plan-sidebar.png?fit=max&auto=format&n=L22mbBMLs80H8_c8&q=85&s=46aa76922ec245592fba29347bebc5c7" alt="Visualização de thread mostrando múltiplas tarefas executando em paralelo com indicadores de status" width="3430" height="1986" data-path="images/replitai/task-plan-sidebar.png" />
    </Frame>

    * **Visualização de quadro** — Um quadro baseado em colunas mostrando todas as tarefas organizadas por status: **Rascunhos**, **Ativo**, **Pronto** e **Concluído**

    <Frame>
      <img src="https://mintcdn.com/replit/L22mbBMLs80H8_c8/images/replitai/task-board-active.png?fit=max&auto=format&n=L22mbBMLs80H8_c8&q=85&s=601835c79a1f6f89abdafcfa0fbe577c" alt="Visualização de quadro mostrando tarefas organizadas nas colunas Rascunhos, Ativo, Pronto e Concluído" width="3430" height="1986" data-path="images/replitai/task-board-active.png" />
    </Frame>
  </Step>

  <Step title="Revise e aplique">
    Quando uma tarefa termina, o Agent mostra o que fez — o registro de trabalho, resultados de testes e uma visualização ao vivo das alterações. Você decide o que acontece a seguir:

    * **Aplicar alterações à versão principal** — Mescle o trabalho da tarefa ao seu projeto
    * **Descartar** — Descarte as alterações se não forem o que você queria

    O Agent resolve conflitos automaticamente ao aplicar alterações de múltiplas tarefas.

    <Frame>
      <img src="https://mintcdn.com/replit/L22mbBMLs80H8_c8/images/replitai/task-review-apply.png?fit=max&auto=format&n=L22mbBMLs80H8_c8&q=85&s=4801afb66f05f46e919c8900c2963735" alt="Tela de revisão de tarefa mostrando o registro de trabalho do Agent, resultados de testes e botão Aplicar alterações" width="3456" height="1984" data-path="images/replitai/task-review-apply.png" />
    </Frame>
  </Step>
</Steps>

## Saiba mais sobre tarefas

<CardGroup cols={3}>
  <Card title="Quadro de tarefas" icon="table-columns" href="/references/agent/task-board">
    Revise tarefas nos estados Rascunhos, Ativo, Pronto e Concluído no quadro.
  </Card>

  <Card title="Ciclo de vida das tarefas" icon="rotate" href="/references/agent/task-lifecycle">
    Entenda os estados das tarefas, trabalho na fila, aplicação de alterações, arquivamento e cancelamento.
  </Card>

  <Card title="Tarefas de acompanhamento" icon="list-check" href="/references/agent/follow-up-tasks">
    Inicie próximas tarefas sugeridas e gerencie muitos acompanhamentos de uma vez.
  </Card>
</CardGroup>

## O que você pode construir

O sistema de tarefas funciona para qualquer projeto. Aqui estão alguns padrões onde ele se destaca:

* **Lance grandes funcionalidades em partes menores** — Divida autenticação, um dashboard e uma camada de API em tarefas separadas para que o Agent possa trabalhar nelas de forma organizada
* **Planeje projetos complexos** — Divida uma grande funcionalidade em tarefas bem delimitadas com dependências e execute com confiança
* **Compare diferentes direções de design** — Use tarefas separadas para experimentar múltiplas abordagens de UI e escolha o melhor resultado

## Perguntas frequentes

<Accordion title="Preciso mudar como construo?">
  Não. A thread principal funciona exatamente da mesma forma. O Agent cria tarefas automaticamente nos bastidores quando ajuda. Você também pode usar o [modo Plan](/references/agent/plan-mode) para ver e gerenciar tarefas explicitamente.
</Accordion>

<Accordion title="Por que minhas tarefas estão executando uma de cada vez?">
  O Core executa 1 tarefa em segundo plano por vez. O Pro suporta até 10 tarefas em segundo plano simultâneas. Quando você atinge o limite do seu plano, tarefas adicionais ficam na fila e começam à medida que as vagas abrem.
</Accordion>

<Accordion title="Como o Agent lida com conflitos ao aplicar tarefas em segundo plano?">
  O Agent usa resolução de conflitos assistida por IA. Ele entende o que cada tarefa estava tentando realizar e aplica as alterações de forma inteligente. Se algo parecer errado, você pode pedir ao Agent para corrigir na thread.
</Accordion>

<Accordion title="As tarefas podem depender umas das outras?">
  Sim. O Agent detecta automaticamente dependências — por exemplo, uma tarefa que constrói um dashboard depende da tarefa que cria o esquema do banco de dados. Tarefas dependentes aguardam até que seus pré-requisitos sejam concluídos.
</Accordion>

<Accordion title="Qual é a diferença entre arquivar e cancelar uma tarefa?">
  **Arquivar** se aplica a sessões de planejamento — rascunhos que ainda não começaram a construir. Sessões de planejamento arquivadas são preservadas e podem ser restauradas na coluna **Concluído**.

  **Cancelar** se aplica a tarefas que já passaram do planejamento para a construção. Cancelar para a tarefa e descarta seu trabalho, e tarefas canceladas não podem ser restauradas — você precisaria iniciar uma nova tarefa.
</Accordion>

## Disponibilidade

| Capacidade                      | Core | Pro |
| ------------------------------- | ---- | --- |
| Planejamento de tarefas         | ✅    | ✅   |
| Tarefas em segundo plano        | ✅    | ✅   |
| Tarefas em segundo plano ativas | 1    | 10  |
