easynet.run · 全部问题场景

每做一个新 Agent,团队又重写一套接入和授权代码。

售前助手要查订单,客服助手也要查,分析助手还要按月份汇总。三个项目各自接了一遍订单系统。后来接口改了一个字段,三组人分别修复;更麻烦的是,同样叫“订单金额”,有的返回含税价,有的已经扣除了退款。

这部分工作并不需要每个 Agent 重新实现。先对照现有代码,找出真正相同的一项操作,例如按订单编号返回订单状态和允许查看的金额。汇总分析需要另一种输入和权限,不能仅因为都涉及订单,就塞进一个什么都能查的工具。

如果已有内部 API 或 SDK 已经统一了这些规则,继续用它。需要补上的可能只是让不同助手找到并使用这个入口,而不是再写一个订单服务。EasyNet 的用途在于把这种已维护的操作接给不同调用方,不是替换团队已有的业务系统。

对于仍散落在脚本里的实现,可以由订单系统的维护者选定一个函数,通过 EasyRemote 接入;已有服务则保留原有接口和维护方式。函数描述要说清输入、金额口径、失败原因和负责人,再为需要使用它的助手配置支持的调用入口,例如 MCP。

共享实现不能变成共享超级账号。客服能查哪些客户,分析助手能取哪些字段,仍要由提供方依据可信的调用身份检查。助手在参数里声称“我是管理员”不构成授权,工具说明写了“只读”也不能代替底层账号和业务代码的限制。

先让两个现有项目使用同一个查询,分别测试正常订单、无权查看的订单和业务接口不可用的情况。也要检查助手是否理解结果:接口返回的是含税总额,就不该在回答里说成已到账收入。运行结果一致与业务解释正确,需要分别验证。

如果下次接口变化只需维护者修一次,两个项目仍能得到同样含义的结果,复用才真正成立。团队少维护的是重复的业务连接和规则;每个助手仍需完成自己的连接配置、身份授权和任务测试。

  1. 01

    固定业务含义

    金额是否含税、状态来自何处。

  2. 02

    连接维护好的函数

    实现与上游凭证由提供方维护。

  3. 03

    两个项目复用

    同一语义,不同授权范围。

订单逻辑维护一处,消费者保留各自权限。

不要只返回一个没有含义的金额

虚构的订单结果示例,展示字段口径;不是实时订单。

示例内容 · json
{
  "order_id": "demo-42",
  "status": "shipped",
  "total": {"amount": "108.00", "currency": "USD", "tax_included": true},
  "metric": "order_total_not_booked_revenue"
}

预期结果:销售与分析不会把同一108美元误当作两种指标。

接入时的检查项
  • 两个消费者调用同一业务实现并获得一致语义。
  • 权限不同的消费者返回范围确实不同。
  • 业务接口变更能通过共同契约测试被发现。
源码与接入资料