标签： Python

使用 OpenAI Python SDK 的 Responses 流式累加器时，如果上游（尤其是 OpenAI 兼容的第三方 provider）发送的 response.output_item.added 事件里 item 为 null ，SDK 会在读取 event.item.type 时直接崩溃

当调用 vector_stores.files.upload_and_poll() 时，文件上传成功、挂载到 vector store 也成功，但该 SDK 调用会无限期阻塞，底层文件状态一直停在 in_progress 。优先排查的是服务端向量存储文件处理/索引是否卡住，并给轮询加上超时上限，避免

这个报错通常出现在使用 OpenAI Python SDK 消费流式响应（stream=True）时，如果流中途发生读取超时或连接中断，SDK 没有包装异常，而是直接把原始 httpx 异常抛出；优先排查你的异常捕获是否只写了 except openai.APIError ，以及你是否依赖 max_

这个报错通常出现在使用 Gradio gr.Audio(..., streaming=True, format='wav') 接收分块音频流的场景中，表现为播放时声音不连续、断断续续。优先排查向 streaming=True 的 Audio 输出 yield 音频分块的方式，而不是先怀疑模型或音频数

当 DOCXSearchTool 以固定文档方式初始化（例如 DOCXSearchTool(docx="document.docx") ）后，Agent 执行工具时只传入 search_query ，会因子类化的 FixedDOCXSearchToolSchema 仍把 docx 标记为必填而触发

这个报错通常出现在已发布的 Chatflow WebApp 中使用 Human Input 节点后，提交人工输入并等待工作流跑完，聊天输入框仍然保持禁用；优先排查前端是否在 Human Input 恢复后没有把 isResponding 状态恢复为 true ，以及所在版本是否已包含相关前端修复。

这个报错通常出现在 Dify 自托管环境中已禁用 RBAC（改用 legacy roles）、且被访问的 Agent 应用底层是 roster agent 时，Agent app detail API 返回的 permission_keys 始终为空。优先排查 detail 序列化时是否用原始 UU

这个“报错”本身并不是运行失败，而是开发者在 LangChain 中找不到 Sarvam AI 官方 ChatModel 集成而提交的功能请求（“Support for Sarvam Chat Model Integration”）。如果你在 LangChain 中调用 Sarvam 模型失败，优先

当你在 langchain-huggingface 中以 backend="ipex" 调用 HuggingFacePipeline.from_model_id() 或 HuggingFaceEmbeddings(model_kwargs={"backend": "ipex"}) ，且安装了 opt

在非 CUDA 加速卡（例如 Intel XPU、通过 ROCm 暴露的 AMD 设备）上调用 HuggingFacePipeline.from_model_id(..., device=0) 时，如果该机器上 torch.cuda.device_count() 返回 0，就会触发设备校验失败；优先