简介:读完本文,你可以分清“直接调用模型接口手写智能体”和“用编排框架搭建智能体”的共同目标、架构差异与适用边界,并据此判断接入成本、调试难度、状态管理和长期维护该怎么权衡。
本文对比的是两类实现智能体(Agent)的路径:一类是只用通用编程语言配合大模型接口,自行完成提示拼装、工具调用和循环控制;另一类是采用专门的智能体或工作流编排框架,用现成抽象把模型、工具、记忆和多步骤流程串起来。前者常被称作“手写”或“薄封装”,后者强调“框架编排”。二者都能做出可用的智能体,差别主要在控制权、复杂度落点和团队成本,而不是能不能跑通。
真实工程里的智能体,本质往往只做三件事:把上下文整理成模型能读的文本或结构化消息,调用模型接口拿到下一步决策,再根据决策去调外部能力并决定是否继续循环。这些能力用语言自带的字符串处理、网络请求和循环就能完成,因此“不用框架、纯手写”在工程上完全成立。
框架出现,是因为多模型接入格式不统一、单次调用做不完复杂任务、模型本身不能直接改业务系统。框架把这些重复劳动收成统一接口、步骤链、工具注册、记忆和状态图。问题在于:抽象一旦变厚,提示和响应就被包进多层对象,排查时不容易看见模型到底读到了什么、回了什么。不少团队在简单场景里过早引入图编排、角色分工和检查点,结果调试时间超过业务收益。也有团队在分支很多、运行很长、需要人工介入时,发现手写循环难以维护。所以选型不是立场之争,而是复杂度是否配得上抽象。
手写方案把智能体看成一个受控循环。开发者显式维护消息列表、可用工具清单、停止条件和错误处理。模型只负责在给定约束下产出下一步;真正执行动作、校验参数、写日志、落状态的是业务代码。适合边界清楚、步骤可预期的任务。
框架方案把智能体看成可配置的运行时。它通常提供:统一的模型适配,减少供应商接口差异;把多步调用串成链或图;把外部系统封装成工具;用记忆或检查点保存中间状态;有的还支持条件分支、人工确认和多个角色之间的任务转交。适合流程本身就是产品核心、且会持续演化的系统。
两者解决的都是“让模型在循环中使用工具完成目标”,不是替代业务系统。模型仍然可能幻觉、漏参或提前结束,可靠性主要来自约束、校验和可观测性,而不是来自某一种写法的名字。
架构与系统边界。 手写方案的边界在业务代码里,依赖少,调用栈短,状态存在你自己的数据结构或数据库中。框架方案把循环、路由和状态机放进运行时,业务代码更多是注册工具和填写节点。依赖变多后,升级框架可能连带改变默认重试、消息格式或序列化方式。
功能覆盖。 手写方案默认几乎什么都不帮你做:统一多家模型、长任务断点、人工审批、多角色委托都要自己写。这也意味着你不会无意中启用用不到的能力。框架把这些做成可选组件,复杂分支、检查点和人机协同更容易表达,但简单的“检索再回答”也可能被做成多层图。
接入与改造。 若团队已经熟悉模型接口,手写一个“思考—调用工具—观察结果”的循环,往往几十行到一两百行就能表达核心模式。框架接入要学习其状态对象、装饰器和运行约定,短期样例更快,接到现有鉴权、审计和事务时,常常要顺着框架生命周期改。
可观测与调试。 手写时,提示、响应和工具参数都是普通数据,打印或落库即可。框架若把这些内容藏在内部消息对象里,排错就要先弄清抽象映射。对底层行为的错误假设,是线上问题的常见来源:例如以为某节点不会重试,或以为记忆会自动裁剪。
性能与稳定性。 不应臆造吞吐数字。可以确定的是:手写路径的额外开销主要是你自己的序列化和网络调用;框架路径还可能增加对象拷贝、检查点写入和图调度。延迟敏感、步骤少的场景,薄循环更可控。长任务、需要中断恢复的场景,检查点的稳定性价值通常高于那一点调度开销。
安全。 两种方案都必须把工具参数当成不可信输入。手写时权限检查写在调用前,位置明确。框架若支持动态选工具或跨角色委托,要额外确认:工具白名单是否可被提示注入绕过,记忆里是否混入了其他用户数据,检查点是否存了敏感原文。
成本结构。 没有统一价签。手写的资源成本主要是模型和自建状态存储,人力成本前期低、后期随分支变多而上升。框架的许可与运行时成本因选型而异,人力成本常从“少写样板”开始,转到“理解并约束框架行为”。迁移成本取决于你是否把业务规则写进了框架专有图或角色模板。
| 维度 | 手写(语言 + 模型接口) | 编排框架 |
|---|---|---|
| 核心抽象 | 消息、工具函数、循环与停止条件 | 链/图、节点、记忆、检查点、角色 |
| 上手 | 会调接口即可,样板少 | 示例快,概念多 |
| 调试 | 直接看到提示与响应 | 需穿过抽象层 |
| 复杂分支 | 自己写条件,容易散 | 图和条件边更清晰 |
| 长任务恢复 | 需自建持久化 | 常内置检查点 |
| 多角色协作 | 需自定协议 | 角色与委托更现成 |
| 灵活性 | 高,改动即业务代码 | 受运行时约定约束 |
| 锁定风险 | 主要锁在自有代码 | 可能锁在框架模型 |
| 更适合 | 步骤少、边界清、要强控制 | 分支多、要恢复、流程常改 |
下面只说明控制流,不是某个产品的接口。
messages = [系统指令, 用户目标]tools = 已注册且带参数约束的函数for step in range(最大步数):decision = 调用模型(messages, tools的描述)if decision是最终回答:return decisionif decision要调用工具:校验参数与权限result = 执行工具(decision)messages.append(工具结果)else:记录异常并按策略重试或终止return 超过步数的失败说明
框架做的往往是同一件事,只是把 for、分支和 messages 收成状态图:节点产生决策,条件边决定去工具节点、人工节点还是结束节点,检查点把状态写入外部存储。理解这一点后,就不必把框架当成另一种智能,也不必把手写当成“不专业”。
步骤固定的问答或单工具调用。 例如先检索再生成、或调用一个查询接口后总结。手写更合适。引入完整状态图通常只增加阅读成本。
分支明显、且分支规则会随业务变。 例如工单分流、多系统对账、失败后走不同补偿。框架的条件边和可视化流程更容易让多人协作;若分支仍少,用手写的显式状态机(普通枚举加转移表)也够,且更好测。
运行时间长、允许中断后继续。 人工审批、等待外部回调、跨小时的批处理,需要持久化的中间状态。框架的检查点能减少自研;若你已有工作流引擎或任务表,手写把状态放进现有任务系统往往更一致,不必再套一层智能体图。
多个专门角色互相委托。 框架的角色与任务转交能快速搭出协作样本。生产上仍要限制委托深度和工具范围,否则角色之间会循环调用。手写则适合先固定“规划者—执行者”两段,协议用结构化字段而不是自由文本。
团队与治理。 人少、要快速定位故障时,薄实现通常更省心。多人维护、流程即资产、且需要统一审计轨迹时,框架的约定能减少每个人各写一套循环。无论哪边,都要把提示、工具契约和评估集放在版本管理里。
从框架迁回手写,或从手写迁到框架,都要先列出真实依赖,而不是只看演示工程。
纯手写与框架编排都能实现智能体,因为核心都是字符串、接口调用和循环。手写把控制面留在业务代码中,调试直接、依赖少,复杂分支和长任务恢复要自己补。框架用链、图、记忆和检查点换取表达力,适合流程复杂且会持续变化的系统,但抽象会遮蔽提示与响应,也会带来升级和锁定成本。选择时看步骤是否固定、是否需要断点与人工介入、团队是否愿意维护另一套运行时,而不是默认“框架更高级”或“手写更纯粹”。先用最薄的循环验证工具契约和停止条件,只有当重复的分支与持久化开始主导复杂度时,再引入或保留编排框架。