从研究论文到归档仓库
微软研究院于2023年末在arXiv发布了TaskWeaver论文，并在GitHub上发布了代码，将其描述为“首个能够无缝规划和执行数据分析任务的代码优先智能体框架”。
该项目在2024年及2025年初持续开发：2024年3月推出了默认的基于容器的代码执行模式，同月还发布了一体化Docker镜像；2024年9月增加了用于在各角色间传递信息的共享内存系统；2024年12月接入了AgentOps可观测性集成；2025年1月推出了名为Recepta的实验性推理角色；2025年3月为Planner角色添加了视觉输入能力。
在项目自身的更新日志中，2025年3月的这次更新之后再无新功能公告。提交活动逐渐减少到仅有依赖项更新，微软最终于2026年3月23日将该仓库归档——GitHub的归档提示写明该仓库“已由所有者于2026年3月23日归档”，并“现为只读状态”，这将禁用新的提交、拉取请求和issue提交。
这使TaskWeaver与本系列中的大多数其他框架处境不同。AutoGen处于微软托管的维护模式（仅提供缺陷和安全修复），并有一个明确的继任者——Microsoft Agent Framework。而TaskWeaver既没有明确的继任者，也没有任何维护承诺——它就被冻结在归档时的状态。
仓库创建
- 日期:
- 2023-09
- 含义:
- GitHub仓库microsoft/TaskWeaver创建；论文随后不久在arXiv上发布
容器模式默认化+Docker镜像
- 日期:
- 2024-03
- 含义:
- 代码执行默认在隔离容器中进行；发布一体化Docker镜像以实现一步式安装
共享内存+AgentOps集成
- 日期:
- 2024-09至2024-12
- 含义:
- 各角色可通过内存系统共享信息；接入AgentOps可观测性集成
Recepta推理角色+视觉输入
- 日期:
- 2025-01至2025-03
- 含义:
- 推出实验性推理角色以及Planner角色的视觉输入能力——文档记录的最后功能
微软将仓库归档
- 日期:
- 2026-03-23
- 含义:
- GitHub将该仓库标记为只读：不再有新的提交、发布、拉取请求或issue
📌注: MIT许可证不会因归档而改变——现有代码依然可以在其条款下自由使用、fork和修改。改变的是：微软今后将不再修复漏洞、不再打安全补丁，也不再添加新功能。
TaskWeaver是什么？
TaskWeaver是微软研究院为数据分析打造的开源代码优先AI智能体框架（MIT许可，已归档，github.com/microsoft/TaskWeaver）——它将自然语言请求解释为可执行的Python代码，而不是自由文本指令，并在有状态的会话中运行该代码。
- Planner角色：将复杂请求分解为一系列子任务，并在整个对话过程中跟踪进度
- Code Generator角色：编写可执行的Python代码片段来完成每个子任务，并与已配置的插件协同工作
- 插件系统：数据库查询、预测、文档检索等特定领域操作被打包为插件，供Code Generator调用
- 有状态执行：TaskWeaver在整个会话过程中不仅保留之前消息的文本，还保留聊天历史和代码执行历史——包括pandas DataFrame等内存中数据结构
- 丰富的数据结构：由于状态保存在内存中，TaskWeaver可以在各步骤之间直接传递DataFrame或其他Python对象，而无需再次将其序列化为文本
- 代码验证：生成的代码在执行前会被检查是否存在潜在问题，并向用户提供修复建议
- 基于会话的多用户隔离：基本的会话管理使不同用户的数据相互隔离，代码执行在独立进程中运行以避免相互干扰
- 默认基于容器执行：自2024年3月起，生成的代码在容器内而非宿主进程中运行，这需要Docker支持
模型无关，提供OpenAI示例文档
TaskWeaver连接到你在taskweaver_config.json中配置的LLM，而不是自带内置模型。官方文档提供了一个OpenAI示例（llm.api_key加llm.model），并在更高级的设置中介绍了如何配置其他提供商——但由于该项目已归档，这些文档不会再针对更新的提供商API进行更新。
# 克隆并安装（需要Python 3.10及以上版本）
git clone https://github.com/microsoft/TaskWeaver.git
cd TaskWeaver
pip install -r requirements.txt
# 在taskweaver_config.json中配置你的LLM，然后运行：
python -m taskweaver -p ./project/TaskWeaver要花多少钱？
TaskWeaver本身在MIT许可下是免费的——没有订阅费、付费套餐，也没有需要付费的微软托管服务。 你需要支付的是自己的硬件或服务器费用，以及在taskweaver_config.json中配置的LLM提供商产生的任何API费用。
- TaskWeaver（开源框架）：在MIT许可下永久免费，自行托管，没有使用上限，运行无需微软账户
- 没有微软托管的产品或订阅：TaskWeaver是你自己运行的代码，而非托管服务——没有任何东西需要订阅
- 可选费用：自己的硬件或服务器，以及如果你连接云端模型而非本地模型，所配置的LLM提供商产生的API费用（例如OpenAI按token计费）
- 可选费用：默认基于容器的代码执行模式需要Docker，运行在你已有或自行提供的基础设施上
如何安装并开始使用TaskWeaver？
TaskWeaver没有PyPI软件包——安装方式是克隆GitHub仓库，并用pip安装其依赖项，这需要Python 3.10或更高版本。 由于项目已归档，这正是归档时所发布的安装流程；今后不会再有可替代安装的新版本。
- 1确保已安装Python 3.10或更高版本（可选先创建专用环境：
conda create -n taskweaver python=3.10 && conda activate taskweaver）。 - 2克隆仓库：
git clone https://github.com/microsoft/TaskWeaver.git。 - 3安装依赖：
cd TaskWeaver && pip install -r requirements.txt。 - 4在
taskweaver_config.json中配置LLM提供商——例如OpenAI可配置为{"llm.api_key": "你的密钥", "llm.model": "gpt-4"}。 - 5如果打算使用默认的基于容器的代码执行模式（推荐），请安装Docker；不使用容器的替代方案见代码执行文档。
- 6从克隆得到的文件夹启动命令行界面：
python -m taskweaver -p ./project/，或者改为将该项目作为库导入——见库使用文档。
锁定较早的版本
如果你想要某个特定的带标签版本，而不是main分支的最新状态，可以直接从发布标签安装。
- 在发布页面查看可用标签（例如
v0.0.2-alpha）。 - 直接安装该标签：
pip install git+https://github.com/microsoft/TaskWeaver@<TAG>。
TaskWeaver已经归档，我还能安装吗？
可以。归档使仓库对新贡献变为只读，但现有代码、分支和带标签的发布仍完全可以按发布时的原样下载和安装。
TaskWeaver有PyPI软件包吗？
没有。文档记录的安装方式是先克隆再在克隆的文件夹内运行pip install -r requirements.txt，或使用pip install git+https://github.com/microsoft/TaskWeaver@<TAG>安装特定的带标签版本。
谁适合使用TaskWeaver？
TaskWeaver适合已经基于它建立了可用部署的团队，或者想要研究其Planner/Code Generator架构作为参考实现的团队。 鉴于其已归档状态，对于今天要开始新生产环境智能体项目的人来说，它的适用面较窄。
适合使用TaskWeaver的情况
- 你已经拥有基于TaskWeaver构建的生产部署，且它能够原样满足你的需求——归档不会破坏现有安装
- 你想研究一个文档完善的代码优先Planner + Code Generator架构，包括其有状态代码执行历史的实现方式，作为自己实现的参考
- 你的使用场景专门是数据分析——获取数据、转换数据、运行算法、产出结果——在这类场景中，生成并运行真实的Python代码（而不仅仅是调用工具）才是正确的模式
- 你愿意今后自己维护该框架，包括未来针对更新的LLM API或Python版本所需的兼容性修复
应避免使用TaskWeaver的情况
- 你正在启动一个新的生产项目，需要积极的维护、安全补丁或兼容性更新——AutoGen至少处于微软托管的维护模式，而Microsoft Agent Framework是微软正在积极开发的继任平台
- 你需要一个通用的多智能体对话框架，而不是专门针对数据分析的代码生成器——AutoGen或CrewAI是为更广泛的智能体间对话模式构建的
- 你需要企业级支持或SLA——已归档的仓库根本没有任何支持渠道，连社区维护的渠道也没有
- 你想要一个可检查、可恢复的有状态、基于图的工作流——LangGraph正是为这种模式专门构建，并且正在积极维护
什么情况下不应使用TaskWeaver？
截至本次评测，任何新的生产项目都应避免使用TaskWeaver——微软已于2026年3月23日将该仓库归档，今后不再有维护、安全补丁或路线图。
- 从零开始启动新智能体项目的团队——一个带有53个未解决且被冻结的issue的已归档仓库，是新生产工作的薄弱基础
- 需要依赖项安全补丁的团队——
requirements.txt中固定的版本自归档以来一直被冻结，不会再获得更新，因此固定依赖项中后续发现的漏洞不会在上游得到修复 - 需要官方支持的团队——根据项目README，曾经是“首选”支持渠道的GitHub Issues，在已归档的仓库上不再接受新的提交
- 专门为新项目评估微软智能体框架的团队——应改为从AutoGen（维护模式，至少仍在接收修复）或正在积极开发的Microsoft Agent Framework入手
- 只有在你确实需要研究或维护其代码优先、有状态的Planner/Code Generator模式的现有部署时，才应使用TaskWeaver
TaskWeaver与替代方案对比
TaskWeaver与微软生态系统中其他代码执行型智能体框架相互竞争，其中大多数——与TaskWeaver不同——仍在积极维护，或至少处于官方维护模式。
工具 | 接口 | 许可证 | 状态 | 最适合场景 |
|---|---|---|---|---|
| TaskWeaver | Python代码 / CLI | MIT | 已归档（2026-03） | 研究/维护现有部署 |
| AutoGen | Python代码 | MIT / CC BY 4.0 | 维护模式 | 仅限现有AutoGen应用 |
| Semantic Kernel | .NET/Python/Java SDK | MIT | 活跃（正向MAF融合） | 企业编排SDK |
| CrewAI | Python代码 | MIT | 活跃，有风投支持 | 基于角色的多智能体团队 |
| LangGraph | Python代码 | MIT | 活跃 | 有状态的基于图的工作流 |
评估TaskWeaver时的常见误区
这些误区源于没有直接查证仓库状态，或者将TaskWeaver与其他微软智能体项目混淆。
误区1：启动新项目前未检查归档状态
TaskWeaver的GitHub描述至今仍写着“首个能够无缝规划和执行数据分析任务的代码优先智能体框架”，标题中并未提及归档——只读状态仅以横幅形式显示在仓库页面本身。在依赖某个框架进行新工作之前，应始终查看实际的仓库是否有归档横幅。
误区2：认为已归档就等于已损坏
归档只是禁用了新的提交、issue和拉取请求——它不会删除代码，也不会撤销MIT许可证。现有的TaskWeaver部署会继续按归档之前的方式运行；归档日期本身不会导致任何东西损坏。
误区3：将TaskWeaver与AutoGen或Microsoft Agent Framework混淆
这三者都是与微软相关的智能体项目，但处于维护谱系上的三个不同位置：TaskWeaver已归档（冻结），AutoGen处于维护模式（仅缺陷和安全修复），而Microsoft Agent Framework是微软正在积极开发的继任平台。应确认自己实际评估的是其中哪一个。
常见问题
TaskWeaver还在维护吗？
不再维护。微软已于2026年3月23日将microsoft/TaskWeaver仓库归档，使其变为只读状态——今后不再接受新的提交、发布或issue提交。
TaskWeaver免费吗？
是的。TaskWeaver采用MIT许可证，商业使用、修改和自行托管均免费。没有订阅费，也没有需要付费的微软托管产品。
GitHub仓库中的“已归档”是什么意思？
当所有者将仓库归档后，GitHub会将其标记为只读：无法再提交新的提交、拉取请求或issue，但现有代码、分支和发布仍可下载。
TaskWeaver的核心架构是什么？
Planner角色将请求分解为子任务，Code Generator角色为每个子任务编写并执行Python代码，插件系统提供特定领域的操作——所有这些都在一个保留聊天历史和代码执行历史的有状态会话中协同运作。
如何安装TaskWeaver？
使用git clone https://github.com/microsoft/TaskWeaver.git克隆仓库，然后在克隆得到的文件夹内运行pip install -r requirements.txt。没有PyPI软件包。
TaskWeaver需要Docker吗？
并非严格必需，但自2024年3月起，默认的代码执行模式会在容器内运行生成的代码，这需要Docker——不使用容器的替代方案见代码执行文档。
TaskWeaver使用什么许可证发布？
MIT许可证，允许免费的商业使用、修改和自行托管。仓库归档不会改变许可证。
什么取代了TaskWeaver？
TaskWeaver没有任何官方明确指定的继任者。如果需要正在积极开发的通用微软智能体框架，应转而评估Microsoft Agent Framework或Semantic Kernel。
TaskWeaver有多少GitHub星标？
截至2026年9月，microsoft/TaskWeaver仓库的GitHub星标已超过6,100，fork超过780。
我还能对TaskWeaver提交issue或贡献代码吗？
不能。归档禁用了新的issue和拉取请求。归档时开放的53个issue仍然可见，但已被冻结——不会再被处理或关闭。