AIAI学习站
继续学习
本章进度 7 / 18
39%
Agent 与工具调用·理解·10 分钟
正文已完成

参数 Schema 是第一道执行边界

用类型、枚举、范围和必填项阻止模型生成的参数直接进入工具。

L120
为什么现在学

先用本课建立“参数校验”的基本直觉，后面的判断和练习才不会只靠记结论。

本课会用什么
  • 无需安装新工具
  • 直接阅读并完成本页理解检查

模型输出的参数是不可信输入。即使意图正确，也可能出现错误日期、负数金额、未知状态或缺失标识。Schema 让这些错误在执行前被拒绝。

这一课的结果

能为工具参数指出至少四种可自动验证的约束。

核心概念

先把关键判断说清楚

01

类型只是起点

string 不代表合法邮箱，number 不代表允许金额，还要加入格式、范围和业务规则。

02

枚举缩小动作空间

把 action 限定为 preview、submit 等批准值，避免模型创造不存在的操作。

03

跨字段规则仍需代码

结束日期不得早于开始日期等关系不能只靠简单字段类型，需要工具端验证。

案例拆解

预订会议室的四类坏参数

Agent 曾提交不存在的会议室、负参会人数、过去日期和缺少结束时间的请求。

  1. 01

    room_id 使用系统返回的 ID，不接受模型自由文本。

  2. 02

    attendee_count 限制为 1 至 30 的整数。

  3. 03

    start/end 使用带时区日期，工具端检查 end 晚于 start。

案例结果

非法参数在调用入口被拒绝，并返回具体字段错误供 Agent 修正。

提交前练习

现在轮到你

为一个工具的三个参数设计验证规则。

选做练习：本节练习可用于加速你巩固，但不影响继续学习。

内容会自动保存在当前设备
查看参考答案与评分标准

参考答案

transfer 的 from_account_id/to_account_id 必填字符串且来自账户列表，amount 为 0.01 至 50000，currency 枚举 CNY/USD；两个账户不得相同；返回 code、field、message。

评分标准

  • 类型之外还有业务限制
  • 跨字段关系被识别
  • 错误返回可指导安全修正

本课收口 · 理解检查

用 30 秒确认你理解了

用 30 秒理解检查确认你抓住了重点；阅读标记、练习和总结都不设硬门槛。

0 / 1
02完成练习（选做）0 / 4 项已填写，不影响完成03通过理解检查点此去回答，约 30 秒
04补一句总结（可选）可以留空，不影响完成本课。
哪项不能仅靠 number 类型保证？
你现在更接近哪一种状态？
尚有必填项未完成，请补齐后再继续。

资料来源

继续核对与延伸阅读

本课内容最近更新于 。