AI Agent / 知识点

AI Agent 工具调用速查手册

手册条目

根据任务是否依赖外部数据、精确计算或实际操作,判断应直接回答还是发起工具调用。

判断是否需要工具

先判断任务是否依赖模型上下文之外的事实、确定性计算或真实世界操作。只有工具能显著提高正确性、时效性或可验证性时才调用;否则直接回答,避免无意义的延迟和失败点。

判断标准

优先调用工具的典型条件:

  • 结果依赖实时或私有数据,例如库存、天气、账户余额、内部工单。
  • 需要精确计算、结构化查询或大规模检索,人工推算容易出错。
  • 用户要求产生实际副作用,例如发邮件、创建日程、修改记录。
  • 结论必须可追溯到工具返回值,而不能仅凭模型记忆。

通常直接回答的情况包括解释已有文本、改写、翻译、常识性推理,以及用户已经提供全部必要数据的任务。

工具调用判断流程

可运行判断器

下面的 TypeScript 示例把判断条件显式化,适合放在 Agent 路由层。实际项目应再叠加权限、成本和超时策略。

ts
type Task = {
  needsExternalData: boolean;
  needsExactComputation: boolean;
  hasSideEffect: boolean;
  toolAvailable: boolean;
  toolAuthorized: boolean;
};

function decide(task: Task): "CALL_TOOL" | "ANSWER_DIRECTLY" | "ASK_FOR_PERMISSION" {
  const needsTool =
    task.needsExternalData ||
    task.needsExactComputation ||
    task.hasSideEffect;

  if (!needsTool) return "ANSWER_DIRECTLY";
  if (!task.toolAvailable) return "ANSWER_DIRECTLY";
  if (!task.toolAuthorized) return "ASK_FOR_PERMISSION";
  return "CALL_TOOL";
}

const cases: Task[] = [
  {
    needsExternalData: false,
    needsExactComputation: false,
    hasSideEffect: false,
    toolAvailable: true,
    toolAuthorized: true
  },
  {
    needsExternalData: true,
    needsExactComputation: false,
    hasSideEffect: false,
    toolAvailable: true,
    toolAuthorized: true
  },
  {
    needsExternalData: false,
    needsExactComputation: false,
    hasSideEffect: true,
    toolAvailable: true,
    toolAuthorized: false
  }
];

for (const task of cases) {
  console.log(decide(task));
}

预期输出

text
ANSWER_DIRECTLY
CALL_TOOL
ASK_FOR_PERMISSION

读取方法:第一项信息完整且无副作用,直接回答;第二项依赖外部数据,调用工具;第三项会产生真实操作但尚未授权,应先请求许可。

风险与边界

误判为“无需工具”通常发生在数据具有时效性或属于用户私域时,后果是回答过期、虚构或不可验证;安全替代方案是先调用只读查询工具,再基于返回值作答。

误判为“必须调用工具”通常发生在纯解释、改写或本地推理任务中,后果是增加延迟、费用和失败概率;安全替代方案是先检查用户输入是否已经包含完整材料。

涉及写入、支付、删除、发送或权限变更时,即使工具可用也不能自动执行。应先展示将要执行的动作和关键参数,获得明确授权后再调用。

排障清单

  • 工具调用前,确认缺失信息确实无法从当前上下文得到。
  • 检查工具是否可用、参数是否完整、权限是否满足。
  • 调用失败时区分参数错误、权限错误、超时和上游无数据。
  • 工具返回空结果时,不把“空”解释为“不存在”,先检查查询范围和过滤条件。
  • 最终回答只引用已验证的返回值,并明确动态值可能随时间变化。

速查原则:外部事实、精确计算、真实操作三类需求优先考虑工具;无明确收益时直接回答。

目录与阅读设置

记录一个想法

AI Agent 工具调用速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通