---
search:
  exclude: true
---
# 示例

在[repo](https://github.com/openai/openai-agents-python/tree/main/examples)的 examples 部分查看该 SDK 的各类示例实现。这些示例按多个目录组织，展示不同的模式与能力。

## 目录

- **[agent_patterns](https://github.com/openai/openai-agents-python/tree/main/examples/agent_patterns):**
  本目录中的示例展示常见的智能体设计模式，例如：
  - 确定性工作流
  - 将智能体作为工具
  - 并行智能体执行
  - 条件性工具使用
  - 输入/输出安全防护措施
  - LLM 作为裁判
  - 路由
  - 流式传输安全防护措施

- **[basic](https://github.com/openai/openai-agents-python/tree/main/examples/basic):**
  这些示例展示 SDK 的基础能力，例如：
  - Hello World 代码示例（默认模型、GPT-5、open-weight 模型）
  - 智能体生命周期管理
  - 动态系统提示词
  - 流式输出（文本、条目、函数调用参数）
  - 提示模板
  - 文件处理（本地与远程、图像与 PDF）
  - 使用情况追踪
  - 非严格输出类型
  - 先前响应 ID 的使用

- **[customer_service](https://github.com/openai/openai-agents-python/tree/main/examples/customer_service):**
  航空公司的客服系统示例。

- **[financial_research_agent](https://github.com/openai/openai-agents-python/tree/main/examples/financial_research_agent):**
  一个金融研究智能体，展示通过智能体与工具实现结构化的金融数据分析工作流。

- **[handoffs](https://github.com/openai/openai-agents-python/tree/main/examples/handoffs):**
  查看带消息过滤的智能体任务转移的实用示例。

- **[hosted_mcp](https://github.com/openai/openai-agents-python/tree/main/examples/hosted_mcp):**
  展示如何使用托管的 MCP (Model Context Protocol) 连接器和审批的示例。

- **[mcp](https://github.com/openai/openai-agents-python/tree/main/examples/mcp):**
  学习如何使用 MCP (Model Context Protocol) 构建智能体，包括：
  - 文件系统示例
  - Git 示例
  - MCP 提示服务示例
  - SSE (Server-Sent Events) 示例
  - 可流式传输的 HTTP 示例

- **[memory](https://github.com/openai/openai-agents-python/tree/main/examples/memory):**
  展示不同的智能体记忆实现方式，包括：
  - SQLite 会话存储
  - 高级 SQLite 会话存储
  - Redis 会话存储
  - SQLAlchemy 会话存储
  - 加密会话存储
  - OpenAI 会话存储

- **[model_providers](https://github.com/openai/openai-agents-python/tree/main/examples/model_providers):**
  了解如何在 SDK 中使用非 OpenAI 模型，包括自定义提供方与 LiteLLM 集成。

- **[realtime](https://github.com/openai/openai-agents-python/tree/main/examples/realtime):**
  展示如何使用 SDK 构建实时体验的示例，包括：
  - Web 应用
  - 命令行界面
  - 与 Twilio 的集成

- **[reasoning_content](https://github.com/openai/openai-agents-python/tree/main/examples/reasoning_content):**
  演示如何处理推理内容与 structured outputs 的示例。

- **[research_bot](https://github.com/openai/openai-agents-python/tree/main/examples/research_bot):**
  简单的深度研究克隆，展示复杂的多智能体研究工作流。

- **[tools](https://github.com/openai/openai-agents-python/tree/main/examples/tools):**
  了解如何实现由OpenAI托管的工具，例如：
  - 网络检索以及带筛选的网络检索
  - 文件检索
  - Code interpreter
  - 计算机操作
  - 图像生成

- **[voice](https://github.com/openai/openai-agents-python/tree/main/examples/voice):**
  查看语音智能体示例，使用我们的 TTS 和 STT 模型，包括流式语音示例。