agents sdk

OpenAI Agents SDK 工程笔记：ToolContext 工具侧上下文注入、跨请求串租户与生产禁区一个多租户的计费助手里，扣费工具需要知道当前是哪个租户。最早的写法很省事：请求进来时把租户 id 写进模块级的字典，工具函数里直接读。压测那天，两个租户的请求几乎同时到达，A 租户的一次扣费记到了 B 租户头上。日志里看，工具确实被 A 的会话调用，读到的租户却是 B。

OpenAI Agents SDK 工程笔记：RunResult.last_agent 多交接后责任归属、终稿误挂与生产禁区多 Agent 交接跑完以后，日志里常出现一个尴尬问题。入口叫分诊，终稿却是计费专家写的，告警和计费却挂在分诊头上。RunResult 上有一个专门字段处理这件事。本机 openai-agents 0.23.1 里，属性名就是 last_agent，类型是 Agent。它指向本轮跑完时最后一个仍被框架握着的 Agent。标题里说的责任归属，指的就是用这个字段钉终稿作者，而不是用入口名或展示名猜。

OpenAI Agents SDK 工程笔记：AgentOutputSchema 结构化输出声明、strict 校验失败与生产禁区很多团队在 Agent 上写了 output_type=某个 Pydantic 模型，就默认终稿一定是结构化对象。声明期那一层 AgentOutputSchema 才管这件事。它生成 JSON Schema，再在模型返回后做 validate_json。跑完再用别的方法强转，是另一条路径，本文不展开。

OpenAI Agents SDK 工程笔记：TraceProcessor 导出、敏感字段脱敏与生产禁区Agents SDK 的追踪默认是开着的。每次 Runner.run 都会生成一条 trace，下面挂着 Agent、生成、工具调用、交接等 span。排障时这很方便，可它也意味着用户输入、工具参数、工具返回值都会被打包，交给处理器导出。导出到哪里、带走了什么，很多团队上线前没有认真看过。

OpenAI Agents SDK 工程笔记：自定义 Session 接口（get_items / add_items / clear）与多租户隔离的生产禁区官方给了 SQLiteSession，也给了托管的会话实现。很多团队还是会自己写一个 Session，原因很实际，历史要进公司已有的 Postgres 或 Redis，要按租户分库，要接审计。自己写的那一刻，SDK 不再替你兜底。Runner 只管调用四个方法，键怎么拼、写入是否原子、读出来多少条、清空清到哪一层，全是实现者的责任。

OpenAI Agents SDK 工程笔记：SQLiteSession 多轮会话持久化与生产禁区千笔-AIWritePaper · https://www.aiwritepaper.com多轮 Agent 最容易踩的坑，不是「忘了上一句」，而是以为落盘了其实只落了半截、以为隔离了其实共用了 session_id、以为删掉了其实 messages 还在。OpenAI Agents SDK 的 SQLiteSession 把对话 item 写进 SQLite：默认 :memory: 进程结束即丢；传入文件路径才跨重启。Runner.run(..., session=...) 跑前 get_items 取

OpenAI Agents SDK 工程笔记：AgentsException 族、失败分类与生产恢复禁区千笔-AIWritePaper · https://www.aiwritepaper.com线上 Agent 挂掉时，最危险的操作是「反正再跑一遍」。OpenAI Agents SDK 把运行失败收进 AgentsException 族：回合耗尽、模型行为异常、调用方误配、模型超时、工具超时、护栏触发等。它们有的挂着 run_data 快照，有的根本不在这个族里（例如缺 OPENAI_API_KEY 时的 openai.OpenAIError）。能不能重试，取决于异常类型 + 是否幂等 + 是否已经产生写

OpenAI Agents SDK 工程笔记：WebSearchTool 与 FileSearchTool 托管工具边界与生产禁区千笔-AIWritePaper · https://www.aiwritepaper.com挂上 WebSearchTool 或 FileSearchTool，并不等于「Agent 会自己做完可靠检索」。它们是 OpenAI 托管工具：在服务器侧执行网页或向量库检索，再把命中回灌给模型。启用条件绑在 Responses 模型路径上；结果默认进入对话上下文，不自动等于已抽检的终裁事实。租户向量库挂错、截断丢掉反证、空命中仍自信作答，都会在生产里变成静默事故。

OpenAI Agents SDK 工程笔记：tool_use_behavior 与 is_enabled 动态工具开关生产禁区千笔-AIWritePaper · https://www.aiwritepaper.com一个 Agent 调完工具之后，接下来发生什么？默认情况下，工具结果会交回模型，模型再决定是继续调用还是给出终答。这个默认值看起来理所当然，直到线上出现两类事故：通知发了两遍，因为模型在第二轮「确认一下」又调了一次；管理员的清缓存工具突然不见了，因为开关函数读错了上下文里的键。

OpenAI Agents SDK 工程笔记：LocalShellTool 与 ApplyPatchTool 执行面边界与生产禁区千笔-AIWritePaper · https://www.aiwritepaper.comLocalShellTool / ShellTool 与 ApplyPatchTool 让模型能在你的机器上执行命令、改文件。SDK 不会替你做工作区隔离：executor / editor 收到什么就执行什么。本文在 openai-agents 0.23.1 下用脚本化假模型发出真实的 local_shell_call / apply_patch_call，对比「朴素实现」与「加闸实现」，留下 13 行 CSV（

[Ai Agent] 12 Swarm 与 Agents SDK —— 去中心化的多智能体协作博客配套代码发布于github：12 Agents SDK & Swarm 模式相关Agent专栏：Ai Agent教学

Agents-SDK智能体开发[4]之集成MCP入门进入项目目录，激活虚拟环境运行MCP客户端和服务器

我是有底线的