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

返回目录 / Agent 可观测性

逐步呈现Agent事件流并处理结束状态

把Agent流式事件映射到稳定的界面状态,避免把工具内部事件误显示成最终答案。

目标

在保持事件顺序的同时展示进度,并在结束、失败或取消时正确收尾。

步骤

  1. 识别文本增量、工具调用、handoff和run完成等事件类别。 [openai-streaming] [openai-running]
  2. 用 result=Runner.run_streamed(agent, input) 并消费 async for event in result.stream_events()。 [openai-streaming] [openai-running]
  3. 按 event.type 分流 raw_response_event 与 run_item_stream_event;只有消息delta可作为逐字呈现文本。 [openai-streaming] [openai-running]
  4. 在流终止、超时或用户取消时关闭连接并设置最终状态。 [openai-streaming] [openai-running]
  5. 用包含文本、工具事件和失败的模拟流检查界面不会泄露隐藏参数。 [openai-streaming] [openai-running]

验证方式

事件测试覆盖正常结束和中途失败;工具事件不得被拼接进用户可见答复。

故障处理

若内容重复,检查事件顺序和重连逻辑,避免重复追加文本增量。

权限边界

前置条件

权限边界

限制

SDK行为可能随版本变化;固定来源仅说明其提交中的实现,不代表其他Agent或客户端完全兼容。生产环境需独立审阅数据保留、授权和副作用。

固定上游来源

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

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

仓库指标

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

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

尚未取得指标快照。

许可证: MIT

主主题

让编码 Agent 从理解上下文走到验证修改

相关资源