Agent Guardrails 与端到端追踪

Guardrail 不是一条万能的安全 Prompt，而是分布在工作流边界上的确定性检查。

四层检查

1. 输入：长度、范围、注入风险与敏感信息。
2. 工具参数：Schema、权限、资源范围与路径。
3. 副作用：写入前展示操作摘要并获取确认。
4. 输出：格式、引用、敏感数据与业务规则。

追踪模型

一次用户请求对应一个 trace；模型轮次、检索、函数工具、guardrail 和 handoff 对应 spans。每个 span 记录开始时间、耗时、状态、模型或工具名、Token、错误码。敏感输入输出默认应脱敏或关闭采集。

必看指标

任务成功率、工具成功率、每任务模型轮数、P50/P95 延迟、Token 成本、人工介入率和重试次数。按 workflow_version 分组，才能判断改动是否改善系统。

官方资料

OpenAI Agents SDK 提供工具、handoff、guardrail、session 与 tracing；Tracing 文档 说明 trace/span 层次和敏感数据开关。

官方视频

下面嵌入 OpenAI 官方 Build Hour。视频用于观察完整构建过程，关键知识点仍以版本化文档为准。