工具调用出错了怎么处理？

import { z } from 'zod'

class RetryableError extends Error {} // 网络抖动、5xx、限流等暂时性错误
class BizError extends Error {} // 业务错误，信息可以给模型看

interface Tool {
  schema: z.ZodType
  idempotent: boolean // 读操作，或带幂等键的写操作
  execute(args: unknown): Promise<unknown>
}

const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms))

async function runTool(call: { name: string; arguments: string }, registry: Map<string, Tool>) {
  const tool = registry.get(call.name)
  if (!tool) return { isError: true, content: `不存在工具 ${call.name}，可用的有：${[...registry.keys()].join('、')}` }

  // 1. 解析并校验参数，错误具体到字段
  let raw: unknown
  try {
    raw = JSON.parse(call.arguments || '{}')
  } catch {
    return { isError: true, content: '参数不是合法的 JSON，请重新生成' }
  }
  const parsed = tool.schema.safeParse(raw)
  if (!parsed.success) {
    const detail = parsed.error.issues.map((i) => `${i.path.join('.') || '参数'}：${i.message}`).join('；')
    return { isError: true, content: `参数错误：${detail}。请修正后重试` }
  }

  // 2. 执行：只有幂等操作遇到暂时性错误才自动重试
  for (let attempt = 1; ; attempt++) {
    try {
      const result = await tool.execute(parsed.data)
      return { isError: false, content: JSON.stringify(result) ?? '执行成功' }
    } catch (err) {
      console.error({ tool: call.name, attempt, err }) // 完整错误只写日志
      const transient = err instanceof RetryableError
      if (transient && tool.idempotent && attempt < 3) {
        await sleep(2 ** attempt * 200 + Math.random() * 200) // 指数退避加随机抖动
        continue
      }
      if (transient && !tool.idempotent) {
        return { isError: true, content: '操作结果未知，可能已经执行。请先查询状态，不要直接重试' }
      }
      if (err instanceof BizError) return { isError: true, content: `执行失败：${err.message}` }
      return { isError: true, content: transient ? '服务暂时不可用，请稍后再试' : '内部错误，无法完成该操作' }
    }
  }
}