Skip to content

传统开发转Agents开发:重新理解代码与长期资产

2026年4月27日

传统开发转Agents开发:重新理解代码与长期资产

在 Agent 时代,代码越来越像日抛品。代码本身的生命周期变短了,但系统设计、上下文组织、工具边界、评估闭环的价值变长了。

一、最容易高估的是「写代码」

Agent 系统最常见的翻车点:

问题说明
上下文喂得不对模型拿到的信息和任务不匹配
工具抽象得太烂Tool Calling 返回格式不稳定
状态管理混乱Agent 不知道自己在哪个阶段
任务边界不清楚一句指令塞太多事情
模型能力和系统设计错配系统设计超出了模型能力
没有评估体系做了也不知道做得对不对
Prompt、Skill、Memory、Tool 全揉成一团本来该分层的东西混在一起

Demo 看起来能跑,实际一上强度就碎。

二、上下文工程:不是 Prompt Engineering

对比Prompt Engineering上下文工程
关注点咋写一句话让模型听话怎么组织系统给模型喂信息
技能提示词技巧信息组织能力
层级单次对话整体系统设计

常见问题

上下文结构混乱

markdown
# ❌ 坏的组织方式
你是一个智能助手,要学会计规则、理解发票识别、会看 ERP 系统流程,还要会核对数据...

# ✅ 好的组织方式
你是发票核对 Agent。
- 任务:核对发票和订单是否一致
- 约束:只从指定系统获取数据
- 工具:invoice_reader、order_fetcher、diff_checker
- 输出:核对结果 + 异常列表

设计原则

原则说明
每层只做一件事Tool 是动作,Skill 是流程,Agent 是角色
数据和规则分离数据放 Memory,规则放 Skill
复用优先于重写能复用的就是资产

三、Tool Calling:不是「连上 API」就算完

Tool Calling 的本质

Tool Calling 是让 Agent 能调用外部系统的接口层。

核心能力

  • 标准化的输入输出格式
  • 错误处理和重试机制
  • 权限和安全边界

设计规范

yaml
tool: send_email
description: 发送邮件给指定收件人
parameters:
  to:
    type: string
    description: 收件人邮箱
  subject:
    type: string
    description: 邮件主题
  body:
    type: string
    description: 邮件正文
returns:
  success: boolean
  message_id: string

常见问题

问题说明
工具描述模糊Agent 不知道什么时候用
输入输出不规范解析失败,重试,死循环
错误处理缺失一报错就整个链路崩

四、MCP:Model Context Protocol

MCP 是连接 Agent 和外部系统的协议。

特点

  • 统一接口
  • 即插即用
  • 多客户端共享

适用场景

场景用 MCP
多 Agent 共享同一数据源
需要调用公司内部系统
单 Agent 单一任务❌ 直接 Tool Calling

五、评估体系:做了对不对

为什么需要评估?

  • Agent 执行过程不透明
  • 结果稳定性差
  • 调了 prompt 不知道有没有变好

评估维度

维度说明
任务完成率能不能完成
工具调用准确率该调用时调用了没
时间效率耗时是否合理
成本效率Token 消耗是否合理
错误恢复能力出错能否恢复

评估方法

  1. 自动化测试用例
  2. 人工抽检
  3. A/B 对照

六、长期资产清单

日抛品(短期代码)

类型说明
Prompt Patch模型升级可能不需要
框架胶水层新框架可能替换
工具封装SDK 升级可能废弃

长期资产

类型说明
系统设计任务边界、数据流、状态机
上下文组织Memory、Knowledge、Skill 分层
工具边界Tool 能力定义、输入输出规范
评估体系测试用例、评估指标
能力沉淀复用的 Skill、验证通过的 Capsule

七、转型路上的坑

坑 1:把 Agent 当脚本写

Agent 不是脚本,会执行中间有大量不确定性。

坑 2:过度依赖 Prompt

Prompt 只是上下文的一部分,系统设计才是关键。

坑 3:没有评估就上线

Agent 的不稳定性是常态,评估体系是保障。

坑 4:追求一步到位

先跑通一个闭环,再迭代优化。


总结

传统开发Agent 开发
代码是资产代码是日抛品,设计是资产
关注实现关注组织
单次交付长期运行
确定性执行不确定性管理

转型核心:从「写代码」转向「设计能长期运行的智能系统」。


关键词:Agent开发转型, 上下文工程, tool calling, MCP协议, 评估体系, 长期资产

不要孤军奋战啦!

加入微信群一起学习交流 AI

与大神一起使用 OpenClaw、Hermes、Claude Code、Seedance 2.0、GPT-Image-2 等

微信公众号

扫码关注微信公众号
私信 "加群",将自动获取微信群二维码

探索 AI 世界,掌握智能未来