TaskWeaver: análise 2026, recursos, status, alternativas

Do artigo de pesquisa ao repositório arquivado

O que é o TaskWeaver?

• Papel Planner: decompõe uma solicitação complexa em uma sequência de subtarefas e acompanha o progresso ao longo da conversa
• Papel Code Generator: escreve trechos de código Python executáveis para realizar cada subtarefa, coordenando-se com os plugins configurados
• Sistema de plugins: operações específicas de domínio (consultas a banco de dados, previsões, recuperação de documentos e mais) são empacotadas como plugins que o Code Generator pode chamar
• Execução com estado: o TaskWeaver preserva tanto o histórico de chat quanto o histórico de execução de código — incluindo estruturas de dados em memória como DataFrames do pandas — ao longo de uma sessão, não apenas o texto de mensagens anteriores
• Estruturas de dados ricas: como o estado persiste em memória, o TaskWeaver pode passar um DataFrame ou outro objeto Python diretamente entre etapas, em vez de serializá-lo novamente em texto
• Verificação de código: o código gerado é verificado quanto a possíveis problemas antes da execução, com correções sugeridas ao usuário
• Separação multiusuário por sessão: um gerenciamento básico de sessões mantém os dados de diferentes usuários separados, e a execução de código roda em processos separados para evitar interferência
• Execução baseada em contêiner por padrão: desde março de 2024, o código gerado roda dentro de um contêiner em vez do processo host, o que exige Docker

# Clonar e instalar (Python 3.10+ necessário)
git clone https://github.com/microsoft/TaskWeaver.git
cd TaskWeaver
pip install -r requirements.txt

# Configure seu LLM em taskweaver_config.json e depois execute:
python -m taskweaver -p ./project/

Quanto custa o TaskWeaver?

• TaskWeaver (o framework open source): gratuito para sempre sob a licença MIT, auto-hospedado, sem limites de uso, sem exigir conta Microsoft para executá-lo
• Nenhum produto ou assinatura hospedada pela Microsoft: o TaskWeaver é código que você mesmo executa, não um serviço gerenciado — não há nada para assinar
• Custo opcional: seu próprio hardware ou servidor, além de taxas de API do provedor de LLM configurado (por exemplo, o preço por token da OpenAI) se você conectar um modelo em nuvem em vez de um local
• Custo opcional: o Docker é necessário para o modo padrão de execução de código baseado em contêiner, que roda em infraestrutura que você já possui ou provisiona

Como instalar e começar a usar o TaskWeaver?

1. 1
   Certifique-se de que o Python 3.10 ou mais recente esteja instalado (opcionalmente, crie antes um ambiente dedicado: conda create -n taskweaver python=3.10 && conda activate taskweaver).
2. 2
   Clone o repositório: git clone https://github.com/microsoft/TaskWeaver.git.
3. 3
   Instale as dependências: cd TaskWeaver && pip install -r requirements.txt.
4. 4
   Configure um provedor de LLM em taskweaver_config.json — por exemplo, {"llm.api_key": "sua chave", "llm.model": "gpt-4"} para OpenAI.
5. 5
   Instale o Docker se for usar o modo padrão de execução de código baseado em contêiner (recomendado); veja a documentação de execução de código para a alternativa sem contêiner.
6. 6
   Inicie a CLI a partir da pasta clonada: python -m taskweaver -p ./project/, ou importe o projeto como biblioteca — veja a documentação de uso como biblioteca.

Quem deve usar o TaskWeaver?

Quando NÃO se deve usar o TaskWeaver?

• Uma equipe que está começando um novo projeto de agente do zero — um repositório arquivado com 53 issues não resolvidas e congeladas é uma base fraca para novo trabalho em produção
• Uma equipe que precisa de patches de segurança para dependências — as versões fixadas em requirements.txt estão congeladas desde o arquivamento e não receberão atualizações, então uma vulnerabilidade descoberta depois em uma dependência fixada não será corrigida na origem
• Uma equipe que precisa de suporte oficial — o GitHub Issues, antes o canal de suporte "preferido" segundo o README do projeto, não aceita mais novos envios em um repositório arquivado
• Uma equipe avaliando especificamente frameworks de agentes da Microsoft para uma nova construção — comece em vez disso com o AutoGen (modo manutenção, que pelo menos ainda recebe correções) ou o Microsoft Agent Framework ativamente desenvolvido
• Use o TaskWeaver apenas quando precisar especificamente estudar ou manter uma implantação existente de seu padrão Planner/Code Generator code-first e com estado

TaskWeaver vs. alternativas

Erros comuns ao avaliar o TaskWeaver

Perguntas frequentes

Fontes

Leitura relacionada

• Análise do AutoGen: status em modo manutenção e fork AG2 — o outro framework multiagente da Microsoft de execução de código voltado a dados, em modo manutenção em vez de arquivado.
• Análise do Semantic Kernel: recursos, preços, alternativas — o SDK de orquestração empresarial da Microsoft em desenvolvimento ativo, para equipes que precisam de suporte contínuo.
• Análise do CrewAI: recursos, preços, alternativas — um framework multiagente baseado em papéis e mantido ativamente, para fluxos de trabalho agente a agente mais amplos.
• Análise do LangGraph: recursos, preços, alternativas — um framework de fluxo de trabalho com estado, baseado em grafo e mantido ativamente, para execuções de agentes inspecionáveis e retomáveis.
• Diretório de Software LLM Local — o catálogo completo de ferramentas de IA local ao qual este artigo pertence, incluindo onde o TaskWeaver se encaixa entre os frameworks de agentes.