返回目录 / Agent 安全
转交前仅向专家暴露必要上下文
在Agent转交时缩减或脱敏对话历史,减少无关信息和敏感数据扩散。
目标
把完成子任务所需信息传给专家,同时剔除无关或敏感内容。
步骤
- 确定专家需要的字段,并标记用户秘密、凭据和个人数据。 [openai-handoffs] [openai-context]
- 通过
handoff(agent=..., input_filter=...)接收HandoffInputData,显式筛选input_history、pre_handoff_items与new_items。 [openai-handoffs] [openai-context] - 对工具参数、工具结果和普通消息文本分别考虑脱敏,避免只删结构化工具项。 [openai-handoffs] [openai-context]
- 把过滤器应用到handoff边界,并保留足够信息让专家完成任务。 [openai-handoffs] [openai-context]
- 用带有虚构敏感字符串的测试历史验证专家输入中只保留允许字段。 [openai-handoffs] [openai-context]
验证方式
断言敏感测试标记不会出现在专家输入中,且必要任务事实仍然存在。
故障处理
若敏感内容仍传出,检查普通消息和工具结果,不要只过滤结构化工具项。
权限边界
前置条件
- Python 3.10+、固定提交兼容的 openai-agents、获准模型提供商凭据(本地模拟测试例外)
权限边界
- 只在本地或隔离测试环境操作;涉及外部数据或副作用时使用最小权限并先审批
限制
过滤必须覆盖普通消息、工具参数和工具结果;只清空结构化tool items或开启handoff历史压缩不等于脱敏。Server-managed conversation不支持该filter。
固定上游来源
- 仓库
- openai/openai-agents-python
- 文件路径
- docs/handoffs.md
- 固定提交
f53c62451c7f34c15f0c87fa745e05404025420f- 来源检查
- 2026-10-14 · 已按固定上游来源核对
仓库指标
以下数字属于上游仓库整体,不代表单个 Skill 或指南的点赞/热度。
- Stars
- 未取得
- Forks
- 未取得
- 观测时间
- 未取得
尚未取得指标快照。
许可证: MIT