返回目录 / Agent 可观测性
逐步呈现Agent事件流并处理结束状态
把Agent流式事件映射到稳定的界面状态,避免把工具内部事件误显示成最终答案。
目标
在保持事件顺序的同时展示进度,并在结束、失败或取消时正确收尾。
步骤
- 识别文本增量、工具调用、handoff和run完成等事件类别。 [openai-streaming] [openai-running]
- 用
result=Runner.run_streamed(agent, input)并消费async for event in result.stream_events()。 [openai-streaming] [openai-running] - 按
event.type分流raw_response_event与run_item_stream_event;只有消息delta可作为逐字呈现文本。 [openai-streaming] [openai-running] - 在流终止、超时或用户取消时关闭连接并设置最终状态。 [openai-streaming] [openai-running]
- 用包含文本、工具事件和失败的模拟流检查界面不会泄露隐藏参数。 [openai-streaming] [openai-running]
验证方式
事件测试覆盖正常结束和中途失败;工具事件不得被拼接进用户可见答复。
故障处理
若内容重复,检查事件顺序和重连逻辑,避免重复追加文本增量。
权限边界
前置条件
- Python 3.10+、固定提交兼容的 openai-agents、获准模型提供商凭据(本地模拟测试例外)
权限边界
- 只在本地或隔离测试环境操作;涉及外部数据或副作用时使用最小权限并先审批
限制
SDK行为可能随版本变化;固定来源仅说明其提交中的实现,不代表其他Agent或客户端完全兼容。生产环境需独立审阅数据保留、授权和副作用。
固定上游来源
- 仓库
- openai/openai-agents-python
- 文件路径
- docs/streaming.md
- 固定提交
f53c62451c7f34c15f0c87fa745e05404025420f- 来源检查
- 2026-10-14 · 已按固定上游来源核对
仓库指标
以下数字属于上游仓库整体,不代表单个 Skill 或指南的点赞/热度。
- Stars
- 未取得
- Forks
- 未取得
- 观测时间
- 未取得
尚未取得指标快照。
许可证: MIT