工具执行失败时返回什么，决定客户端能不能自动处理。

分类：

  • 参数错误：客户端可以改了重试，要明确说是哪个参数、期望什么
  • 权限不足：客户端应该停下来要授权，不该重试
  • 资源不存在：可能路径写错，可能是真的没有
  • 上游超时：可以重试，但要带退避提示

都返回一个笼统的 error，客户端只能瞎试，试几次就放弃了。

我在返回体里固定带三个字段：code（机器可读）、message（人可读）、retryable（布尔）。客户端据此决定重试还是上报。

这个设计成本很低，但让整个链路的健壮性上一个台阶。

主楼