Agent 创收指南免费公开资源
中文 EN العربية

返回目录 / Agent 安全

转交前仅向专家暴露必要上下文

在Agent转交时缩减或脱敏对话历史,减少无关信息和敏感数据扩散。

目标

把完成子任务所需信息传给专家,同时剔除无关或敏感内容。

步骤

  1. 确定专家需要的字段,并标记用户秘密、凭据和个人数据。 [openai-handoffs] [openai-context]
  2. 通过 handoff(agent=..., input_filter=...) 接收 HandoffInputData,显式筛选 input_history、pre_handoff_items 与 new_items。 [openai-handoffs] [openai-context]
  3. 对工具参数、工具结果和普通消息文本分别考虑脱敏,避免只删结构化工具项。 [openai-handoffs] [openai-context]
  4. 把过滤器应用到handoff边界,并保留足够信息让专家完成任务。 [openai-handoffs] [openai-context]
  5. 用带有虚构敏感字符串的测试历史验证专家输入中只保留允许字段。 [openai-handoffs] [openai-context]

验证方式

断言敏感测试标记不会出现在专家输入中,且必要任务事实仍然存在。

故障处理

若敏感内容仍传出,检查普通消息和工具结果,不要只过滤结构化工具项。

权限边界

前置条件

权限边界

限制

过滤必须覆盖普通消息、工具参数和工具结果;只清空结构化tool items或开启handoff历史压缩不等于脱敏。Server-managed conversation不支持该filter。

固定上游来源

https://github.com/openai/openai-agents-python/blob/f53c62451c7f34c15f0c87fa745e05404025420f/docs/handoffs.md

仓库
openai/openai-agents-python
文件路径
docs/handoffs.md
固定提交
f53c62451c7f34c15f0c87fa745e05404025420f
来源检查
2026-10-14 · 已按固定上游来源核对

仓库指标

以下数字属于上游仓库整体,不代表单个 Skill 或指南的点赞/热度。

Stars
未取得
Forks
未取得
观测时间
未取得

尚未取得指标快照。

许可证: MIT

主主题

让 Agent 更安全且易于核验

相关资源