SuperAPI AI 工具集

scaffolding-openai-agents

智能体与模型

查看项目

更新于 10-16 06:48

技能介绍

用途:该技能演示如何使用 OpenAI Agents SDK 搭建生产级 AI 智能体,采用原生 async/await 编程模式,并覆盖多智能体编排、工具调用、防护栏、上下文注入与 FastAPI 集成等场景。

主要能力:

  • 智能体配置:用 Agent 定义 name、instructions、model,可搭配 ModelSettings 设置 temperature、max_tokens;用 output_type(如 Pydantic 模型)强制结构化输出。
  • 运行模式:Runner.run 为异步主方式;Runner.run_sync 用于简单脚本;Runner.run_streamed 配合 stream_events 实现流式输出;可通过 to_input_list 延续对话历史。
  • 工具:用 @function_tool 定义同步或异步工具,支持 httpx 异步请求和 Pydantic 类型参数与返回。
  • 多智能体:用 handoffs 做路由(triage 智能体分派专家智能体);或用 agent.as_tool 将子智能体作为工具供管理者编排。
  • 防护栏:@input_guardrail 与 @output_guardrail 校验输入输出,通过 tripwire_triggered 触发拦截。
  • 上下文:用 RunContextWrapper 与 dataclass 在智能体间共享状态。
  • 集成:提供 FastAPI 的 /ask 与 /ask/stream 示例,以及 traces 追踪(platform.openai.com/traces)和 RunConfig 自定义追踪。

使用方式:先创建项目与虚拟环境,python -m venv .venv && source .venv/bin/activate,安装 pip install openai-agents,设置 export OPENAI_API_KEY=sk-...,再编写 main.py 并运行。可运行 python scripts/verify.py 验证。

限制:资料未说明收费、价格与具体模型可用性;示例中 eval 与代码执行工具提示生产环境需使用 safe_eval;未提供完整生产部署与错误处理细节,部分内容需结合实际环境验证。