返回工具常见问题
帮助中心 · 常见问题工具1 分钟阅读

如何验证工具返回的结构化数据?

应将工具输出视为可能不完整、过时或结构与预期不同的数据。使用前验证必需字段和类型,并明确处理缺失或意外值,避免下游出现误导性更新或故障。

工具

检查响应契约

确认预期结构,包括可选字段、枚举值、标识符和单位。名为“time”的字段可能表示秒、毫秒或格式化日期;应核对契约,而不是凭名称猜测。

在输出进入工作流的边界处验证。对格式错误的记录予以拒绝或隔离,并保留足够的排查上下文,同时避免在日志中暴露秘密或个人数据。

以防御方式使用数据

设置合理范围和一致性检查,例如计数不能为负,相关标识符应指向同一对象。如果默认替换会改变含义,就不要静默替换无效值。

字段缺失时,采用已记录的回退方案,或将结果标记为不完整。区分验证错误和传输错误,以便修复正确的问题。

返回工具常见问题