本文提供可直接运行的 Python 离线示例:校验工具名、JSON 重复键和参数边界,不执行工具、不请求模型。
直接回答
模型提出工具调用,只是一份待处理的数据。应用应先限制输入大小、解析并校验结构及允许的工具,再独立检查用户授权和业务条件;JSON 解析成功本身不意味着工具已执行或获准执行。本文只实现离线校验,不连接模型,也不调用任何工具。
场景和边界
示例假设程序收到人工构造的 JSON:{"name":"format_note","arguments":{"text":"买牛奶"}}。它只是本文自定义格式,不是任何厂商实际响应的完整协议。我们只允许 format_note 和唯一的 text 参数,输出是原样校验后的字典;该名称仅作示例,不做格式化操作。Python 3.11 标准库即可运行,无需密钥或 SDK。
生产系统还需要可信身份、逐操作授权、数据隔离、超时和审计等控制;一个允许列表既不能判定内容安全,也不能替代真实工具执行前的权限检查。字符长度限制不等于 token、内存或账单限制。
完整代码与运行
保存为 validate_call.py,运行 python validate_call.py:
"""本地合成示例:只校验,不执行工具,也不访问网络。"""
import json
def unique_object(pairs):
result = {}
for key, value in pairs:
if key in result:
raise ValueError("duplicate key")
result[key] = value
return result
def validate_call(raw):
if not isinstance(raw, str) or len(raw.encode("utf-8")) > 1024:
raise ValueError("invalid input size or type")
try:
data = json.loads(raw, object_pairs_hook=unique_object)
except (json.JSONDecodeError, RecursionError) as exc:
raise ValueError("invalid JSON") from exc
if not isinstance(data, dict) or set(data) != {"name", "arguments"}:
raise ValueError("invalid envelope")
if data["name"] != "format_note":
raise ValueError("tool not allowed")
args = data["arguments"]
if not isinstance(args, dict) or set(args) != {"text"}:
raise ValueError("invalid arguments")
note = args["text"]
if not isinstance(note, str) or not note.strip() or len(note) > 80:
raise ValueError("invalid text")
return data
if __name__ == "__main__":
sample = '{"name":"format_note","arguments":{"text":"买牛奶"}}'
print(json.dumps(validate_call(sample), ensure_ascii=False))
本次本地输出:
{"name": "format_note", "arguments": {"text": "买牛奶"}}
先限制 UTF-8 字节数,再通过 object_pairs_hook 拒绝重复键,避免不同组件对同一键取不同值;然后校验顶层字段、工具名、参数字段及字符串长度。空白文本、额外字段和未知工具都拒绝。捕获解析错误后向调用方抛出 ValueError;外层服务还应按自身协议处理错误,避免把敏感输入写进日志。
验证与排错
在本地测试中,七个 unittest 方法通过,覆盖正常输入、未知工具、嵌套重复键、额外字段、空白和非字符串、非法 JSON、超过输入大小上限。它们只覆盖示例所列情况,不证明生产安全或远端调用行为。上述输出和测试均来自人工输入,未发起模型请求。
invalid JSON:检查引号、逗号和括号;JSON 的字符串必须使用双引号。tool not allowed:确认请求的名称确属应用允许的列表;不要通过扩大列表掩盖未知调用。invalid arguments或invalid text:核对字段、类型和长度;缺字段不能靠猜测补齐。- 深层输入、上游超时或非 UTF-8 数据仍需由接收层处理;此演示不提供网络服务器。
常见问题
解析成功可以立即执行吗? 不可以直接推断已授权。还需验证操作者、目标资源和操作的具体权限,必要时要求用户确认。
允许的名字就意味着参数安全? 不是。允许列表只限制名字,参数仍要校验,工具实现也需要执行自身权限与业务规则。
这是 OpenAI 或本站的实际响应格式吗? 这是教学用的自定义 JSON。对接具体服务前应阅读该服务当前官方文档并编写适配层;不能从本文推断本站支持某接口。
小练习与下期预告
构造同时包含两个 text 键的 JSON,确认程序拒绝;再添加一个多余字段,观察不同错误。下一篇讨论校验后的操作如何记录可追溯状态,以及失败时何时可以重试。
来源:Python json 官方文档;OpenAI Function calling 文档。本文由 AI 辅助整理,代码和样例经本地核验。
433



被折叠的 条评论
为什么被折叠?



