目录

• 项目身份 - 能力边界 - 证据与来源政策 - 安装前验证路径 - AI 宿主交接 - Doramagic 踩坑日志 - 验收清单

标准仓库：openai/openai-agents-python

来源 URL：https://github.com/openai/openai-agents-python

它是什么：OpenAI Agents Python 是用于构建带工具、handoff、guardrail、tracing 和多 agent 协作的 Python SDK。

最适合：正在设计 Python agent 工作流，并需要工具、handoff、guardrail、trace 和可复核边界的开发者。

不适合：不适合一次性 Prompt，或没有工具边界、trace、审批模型的 agent 流程。

这个 canary 页面用于让搜索引擎和 AI 检索系统稳定识别项目身份。页面必须保留上游仓库链接、可见来源证据和用户可执行的验证边界，不能暗示 Doramagic 已完成新的生产部署、实时基准或本地安装验证。

主要风险：主要风险是把 SDK 示例当成生产可用，而没有工具、guardrail、trace 和审批边界。

语义标签：OpenAI Agents SDK、Python、智能体框架、工具调用、Handoff、Guardrail、Tracing

1. 身份检查：确认上游项目是 OpenAI Agents Python 智能体框架 SDK 项目。
2. 边界检查：确认任务是否匹配 Agent 工作流设置、工具契约检查、handoff 设计、guardrail 复核、tracing 验证和验收标准。
3. 安全验证：先构建一个只含无害工具、可见 trace 和明确 handoff/guardrail 的最小 agent。

边界必须保持窄。用户应该能判断项目是否相关、复制 prompt 给 AI 宿主、阅读说明书，并在安装前验证一个很小的可回滚任务。

缺少命令、风险或社区证据时，页面必须暴露缺口并引导用户做沙箱验证，不能补写成功故事。

• 确认 openai/openai-agents-python 是目标上游项目。
• 先阅读能力边界：Agent 工作流设置、工具契约检查、handoff 设计、guardrail 复核、tracing 验证和验收标准。
• 用公开样本、无密钥、固定超时和可删除产物做第一次验证。
• 记录输出、失败条件、清理方式和仍缺失的证据。

AI 宿主交接

把这个包当成可携带上下文，不要当成自动安装指令。安全交接应包含来源 URL、能力边界、第一步安全动作、已知风险，并要求 AI 在触碰凭据、文件、网络或持久状态前先请求确认。

Doramagic 踩坑日志

• 风险：主要风险是把 SDK 示例当成生产可用，而没有工具、guardrail、trace 和审批边界。 - 影响：如果没有边界，用户可能把未验证的能力接入真实数据或生产环境。 - 回滚要求：第一次验证必须能删除数据、停止服务或撤销配置。 - 证据要求：成功声明必须来自可复核命令、trace、artifact manifest 或上游文档。

• 页面标题遵循 Doramagic.ai 格式。
• 页面暴露 SoftwareSourceCode、TechArticle、BreadcrumbList 和 FAQPage 结构化数据。
• 页面链接回 https://github.com/openai/openai-agents-python。
• 页面为 AI 消费者提供 Markdown alternate route。
• 页面保持 OpenAI Agents Python 智能体框架 SDK 项目 的真实语义身份：Agent 工作流设置、工具契约检查、handoff 设计、guardrail 复核、tracing 验证和验收标准。
• 页面不把项目错误写成浏览器自动化、网页控制或其他无关类别。
• 页面可逆：删除生成的 canary pack root 后，构建会回到原始 source-cache 状态。