TaskWeaver

TaskWeaver: Microsoft’s code-first agent framework

TaskWeaver is an open-source framework from Microsoft for building code-first AI agents, especially for data analytics and complex task automation. Instead of only passing text between an LLM and tools, TaskWeaver plans through code snippets and coordinates plugins as Python functions.

The key distinction is state. TaskWeaver preserves both chat history and code execution history, including in-memory data such as DataFrames. That makes it more practical for analytical work where intermediate variables, generated charts, fetched datasets, and plugin outputs need to remain available across steps.

Best use cases

• Data analytics agents: pull data from databases, transform tables, run anomaly detection, forecast time series, and generate artifacts.
• Code-first automation: turn natural-language requests into Python code and plugin calls that can be inspected and debugged.
• Domain-specific workflows: wrap proprietary algorithms, databases, APIs, or business rules as plugins.
• Stateful multi-step tasks: keep execution history, memory, and intermediate data available during long analytical conversations.
• Research and prototyping: compare code-first agent design with LangGraph, AutoGen, OpenHands, CrewAI, and other agent frameworks.

Notable capabilities

• Task decomposition, progress tracking, and reflective execution.
• Container-mode code execution by default for better isolation.
• Plugin orchestration through Python functions.
• Shared memory, experience selection, AgentOps observability, and experimental Recepta reasoning role.
• Vision input support for the Planner role, according to the 2025 official update.

Official screenshot and examples

When to choose TaskWeaver

Choose TaskWeaver when the task is closer to analytical programming than generic chat automation. It is strongest when you need Python, DataFrames, stateful execution, custom plugins, and transparent logs. It is less suitable if you only need a no-code workflow builder or a fully hosted production agent product.

Sources checked

• Official Microsoft TaskWeaver GitHub
• Official TaskWeaver documentation
• Vision input for Planner
• TaskWeaver paper