在中文技术讨论里，AI Agent框架ts 通常指用 TypeScript 编写 AI Agent 的框架。ts 是 TypeScript 的常见缩写，TypeScript 又是 JavaScript 的超集，在保留 JavaScript 运行时的同时加入编译期类型检查。这个说法描述的是一个开发品类，并非某个叫 TS 的固定产品。
如果你正在做企业级 AI Agent 选型，先分清框架和平台，能少走很多弯路。框架解决代码怎么组织，平台解决 Agent 怎么被管理、复用和治理。两者的边界，决定了团队该自建、该采购，还是两者配合。
AI Agent框架ts指什么
先把两个词拆开。
ts 指 TypeScript。TypeScript 官方文档把它描述为 JavaScript 的超集，并强调它不会改变 JavaScript 的运行时行为，类型检查发生在编译阶段。对 Agent 开发来说，这意味着团队仍然使用 Node.js、浏览器和 npm 生态，同时可以在编译阶段发现一部分参数类型和数据结构错误。
Agent 框架指一套帮助开发者构建 AI Agent 的代码库或运行时。AI Agent 通常由模型、指令、工具和执行循环组成。模型理解目标并决定下一步，工具负责查数据、调接口或写文件，循环把工具结果送回模型，直到任务完成或触发停止条件。框架把这套循环、工具注册、状态管理、流式输出和调试接口封装起来，让开发者把精力放在业务逻辑上。
所以，AI Agent框架ts 可以理解为面向 TypeScript 技术栈的 Agent 开发框架。它可能是一个低层编排库，也可能是一个带工作流、调试界面和部署工具的一体化工具。不同项目的官方定位差异很大，不能只看名字里有没有 ts。
这里还要区分三类东西。模型 SDK 负责调用模型，通常只提供生成文本、结构化输出和工具调用接口。Agent 框架在模型 SDK 之上增加执行循环、状态和多 Agent 协作。企业级 Agent 平台则进一步提供知识库、权限、审计、运行监控和多部门复用。三者解决的问题不同，选型时不能混为一谈。
一个 TypeScript Agent 框架通常解决哪些问题
框架的价值，出现在单次模型调用不够用的时候。下面这些能力最常被封装进框架。
| 能力层 | 解决的问题 | 常见做法 |
|---|---|---|
| 执行循环 | 模型调用工具后，如何把结果送回模型并继续 | Agent loop、ReAct 循环、停止条件 |
| 工具接入 | 如何把业务 API、数据库和外部服务交给 Agent | 函数工具、MCP、参数 schema 校验 |
| 状态与记忆 | 多轮对话和长任务中，如何保留上下文 | Session、检查点、短期与长期记忆 |
| 多 Agent 协作 | 复杂任务如何拆给多个角色 | Handoff、agents as tools、图工作流 |
| 流式输出 | 如何让用户尽快看到中间结果 | Token 流、事件流、UI 集成 |
| 安全与可观测 | 如何限制输入输出并定位失败 | Guardrail、Tracing、评估与日志 |
这些能力不是每个框架都完整具备。有的框架只做编排，把模型调用和 UI 留给其他库；有的框架把 Agent、工作流和调试界面放在一起。选型时先确认项目真正需要哪几层，再核对官方文档，避免为用不到的能力付出学习成本。
以执行循环为例，OpenAI Agents SDK 的官方文档把 Agent 定义为配备指令和工具的 LLM，并内置循环处理工具调用、把结果发回模型，直到任务完成。LangGraph.js 的官方文档则把自己定位为低层编排框架，提供图结构、持久化执行、人工介入、记忆和流式输出等原语，不强制固定 Agent 架构。两种做法对应不同的控制需求。
为什么不少团队用 TypeScript 写 Agent
选择 TypeScript 的理由，通常来自现有技术栈和团队分工。
第一，前后端可以共用语言和类型。很多企业的产品界面、管理后台和 API 服务已经在 React、Next.js 或 Node.js 上，Agent 往往要嵌入现有产品。用 TypeScript 可以把工具参数、接口返回和界面状态放在同一套类型体系里，减少跨语言转换。
第二，工具调用需要 schema 校验。Agent 调用业务接口时，参数错一个字段就可能失败。TypeScript 生态里的 Zod 等 schema 库，可以把运行时校验和静态类型放在一起。OpenAI Agents SDK 的官方文档就强调，函数工具可以自动生成 schema 并做基于 schema 的校验。
第三，npm 生态和 Web 部署路径成熟。身份认证、日志、队列、对象存储和监控，团队通常已经有现成方案。把 Agent 放进原有 Web 服务，比新建一套 Python 服务更容易复用这些基础设施。
第四，产品型场景更常见。面向客户的聊天助手、内部 Copilot、运营后台里的智能操作，往往由前端团队发起，再逐步扩展到后端。TypeScript 让前端团队能直接参与 Agent 开发，减少交接。
TypeScript 也有不适合的场景。模型训练、复杂数据处理、依赖 Python 专属机器学习库的研究任务，仍然更适合 Python。很多团队会同时使用两种语言，用 Python 做数据和模型实验，用 TypeScript 做产品集成。判断标准是团队已有能力和系统边界，不必按语言流行度决定。
常见的 TypeScript Agent 框架
下面五个框架在官方文档中都有明确的 TypeScript 支持。这里只对照定位和能力，不构成排名。信息核验于 2026 年 11 月，版本和能力会变化，正式选型时以官方文档为准。
| 框架 | 官方定位 | 主要能力 | 更适合什么场景 |
|---|---|---|---|
| LangGraph.js | 低层编排框架，用于构建可控 Agent | 图结构、持久化执行、人工介入、短期与长期记忆、流式输出 | 需要自定义流程、长任务和可恢复执行的团队 |
| OpenAI Agents SDK TypeScript | 轻量、抽象少的 Agent SDK | Agent 循环、handoff、guardrail、session、tracing、MCP、语音 Agent | 想快速起步、使用 OpenAI 或多家模型、重视调试的团队 |
| Mastra | 面向现代 TypeScript 技术栈的 Agent 与应用框架 | Agent、workflow、tools、Studio、模板与框架集成 | 希望把 Agent、工作流和调试界面放在一套开发体验里的产品团队 |
| Vercel AI SDK | 面向 TypeScript 的 AI 应用与 Agent 工具包 | 统一模型接口、工具循环、结构化输出、流式输出、React 与 Next.js 等 UI 集成 | 以 Web 产品、聊天界面和多模型接入为主的团队 |
| Google ADK for TypeScript | 开源、代码优先的 Agent 开发框架 | 多 Agent、图工作流、上下文管理、评估与部署工具 | 使用 Gemini 或 Google Cloud、需要多 Agent 和企业部署能力的团队 |
LangGraph.js 的重点在控制力。官方文档说它提供状态化、长运行工作流所需的运行时原语，不抽象提示词，也不强制固定 Agent 架构。它适合流程复杂、需要暂停恢复或人工审批的项目。代价是开发者要自己设计图和状态，学习和维护成本不低。
OpenAI Agents SDK 的重点在少抽象。官方文档列出的核心原语包括 Agent、handoff、guardrail、session 和 tracing，还支持函数工具、MCP 工具和语音 Agent。它适合先跑通一个可控的 Agent，再逐步增加工具和多 Agent。官方文档称它是此前 Swarm 实验的生产就绪升级版，生产可用仍取决于团队自己的评估、权限和运维配置。
Mastra 的重点在一体化。官方文档把它定义为面向 TypeScript 的 Agent 与应用框架，提供 Agent、workflow、tools 和 Studio，支持与 React、Next.js、Node.js 等框架集成。它适合希望在一个项目里组织 Agent、工作流和调试界面的团队。是否适合生产，还要看团队对部署方式和可观测性的具体要求。
Vercel AI SDK 的重点在模型接入和界面集成。官方文档把它描述为 TypeScript 工具包，提供统一的模型调用接口、AI SDK Core、AI SDK UI 和工具循环 Agent，支持 React、Next.js、Vue、Svelte 和 Node.js。它适合以 Web 产品为中心、需要快速接入多家模型和流式界面的团队。复杂的长任务编排和人工审批，需要结合其他库或自行实现。
Google ADK 的重点在多 Agent 和企业部署。官方站点把它定义为开源 Agent 开发框架，支持 Python、TypeScript、Go、Java 和 Kotlin，提供图工作流、多 Agent 编排、上下文管理和部署工具。TypeScript 版本适合已经在使用 Gemini 或 Google Cloud 的团队。如果模型和云平台不在 Google 生态，接入成本需要单独评估。
怎么判断该不该选 TypeScript Agent 框架
可以用下面五个问题做初筛。
- 现有系统是否以 TypeScript 为主。如果产品、API 和团队经验都在 TypeScript，框架的接入成本通常更低。如果核心系统在 Java、Go 或 Python，先评估跨语言调用和运维边界。
- 模型和工具能否接入。确认框架支持你使用的模型供应商、内部 API、MCP 服务和鉴权方式。不要只看示例里的默认模型。
- 运行方式是否匹配。Agent 是短请求还是长任务，是否需要暂停恢复，是否要部署在自有服务器或私有云。长任务要重点看持久化和恢复能力。
- 是否具备可观测和治理接口。生产环境需要追踪每次运行、定位失败、控制成本和限制权限。只提供本地调试界面的框架，不一定能直接满足企业要求。
- 维护是否可持续。查看官方文档的更新频率、版本策略、许可证和 issue 响应。GitHub star 数只能说明关注度，不能说明项目适合你的业务。
如果只是做一次文本分类、摘要或简单问答，直接调用模型 SDK 更简单。出现多步工具调用、状态保持、人工审批或多 Agent 协作时，框架才开始体现价值。先画出业务流程，再决定要不要引入框架，比先选框架再找场景更稳妥。
框架能解决代码问题，企业落地还缺平台能力
框架解决的是代码层的组织问题。Agent 进入企业生产环境后，还会遇到另一组问题：知识从哪里来，谁能调用哪个工具，运行过程如何审计，多个部门的 Agent 如何复用同一套能力，数据能否留在自己的环境里。
这些问题通常由平台层承接。以 ThinkingAI 的企业级 AI Agent 平台 Agentic Engine 为例，平台支持创建和管理各类 Agent、多 Agent 协作和私有化部署，服务全球超 1500 家企业，接入产品超 8000 款。它处理的是企业级 AI Agent 从开发到运行的管理问题，和 TypeScript 框架不在同一个层面。
这并不意味着每个项目都要先上平台。如果团队只做一个产品内的 Agent，框架加现有基础设施可能已经够用。如果 Agent 要进入多个部门、连接内部数据、需要权限和审计，平台层的价值会更明显。自建还是采购，取决于业务差异化程度、团队能力和合规要求。
FAQ
AI Agent框架ts 是某个具体产品吗
通常不是。ts 多数情况下指 TypeScript，AI Agent框架ts 是对 TypeScript Agent 开发框架的统称。npm 上确实有一些名字带 ts 的包，但它们只是众多实现中的个别产品，不能代表整个品类。
TypeScript Agent 框架和 Python 框架哪个更好
取决于团队和场景。TypeScript 更适合与 Web 产品、前端界面和 Node.js 服务集成，Python 更适合数据科学、模型训练和机器学习生态。很多企业会同时使用两种语言，不必二选一。
会 TypeScript 就能直接做 Agent 吗
不够。TypeScript 解决类型和工程组织问题，Agent 还需要提示词设计、工具 schema、上下文管理、评估方法和安全策略。框架能降低起步成本，但不能替代这些工作。
开源框架能直接上生产吗
可以作为生产基础，但通常还要补可观测性、权限、成本控制、评估和回滚机制。上线前要确认许可证、版本维护、社区活跃度和安全更新方式。涉及客户数据或敏感业务时，还要评估部署环境和数据流向。
TypeScript Agent 框架支持 MCP 吗
部分框架支持。OpenAI Agents SDK 的官方文档列出 MCP 工具调用，其他框架的支持范围和版本要求不同。选型时应以对应版本的官方文档为准，不要只凭介绍页判断。
企业应该自建还是采购 Agent 平台
先看业务差异化和团队能力。Agent 是核心产品能力、需要深度定制时，自建框架层更合适。Agent 是通用生产力工具、需要快速覆盖多个部门时，采购平台能缩短上线时间。也可以先用框架做试点，再根据治理和复用需求决定是否引入平台。
参考资料
TypeScript 官方文档，TypeScript for JavaScript Programmers https://www.typescriptlang.org/docs/handbook/typescript-from-scratch.html
LangGraph.js 官方文档，Overview https://docs.langchain.com/oss/javascript/langgraph/overview
OpenAI Agents SDK TypeScript 官方文档 https://openai.github.io/openai-agents-js/
Mastra 官方文档，Get started https://mastra.ai/docs
Vercel AI SDK 官方文档，Introduction https://ai-sdk.dev/docs/introduction
Google Agent Development Kit 官方站点 https://adk.dev/
以上资料核验于 2026 年 11 月。
