Repolode
openai

openai/openai-agents-python

一个轻量的 Python 多智能体工作流框架,支持工具调用、任务移交、护栏、会话与追踪,可接入 OpenAI 及 100 多种其他 LLM。

Star
30,164
Fork
5,079
未关闭 Issue
23
最近提交
23小时前

这是什么?

OpenAI Agents SDK 是一个用于构建智能体的 Python 框架。开发者可以为 LLM 配置指令、工具、护栏和任务移交,让一个智能体把具体工作委派给其他智能体。它同时支持 OpenAI 的 Responses 和 Chat Completions API,以及 100 多种其他 LLM,不绑定单一模型服务商。

除文本智能体外,SDK 还提供在容器中长时间执行任务的沙盒智能体、基于 WebSocket 的低延迟语音与多模态实时智能体,以及将语音转文字、智能体工作流和文字转语音串联起来的语音管道。会话功能可在多次运行之间自动管理对话历史,内置的人工介入机制也允许人在智能体运行过程中参与决策。

内置追踪功能会记录每次智能体运行,便于查看、调试和优化工作流。JavaScript/TypeScript 版本由另一个仓库单独维护。

核心功能

  • 01智能体可配置指令、工具、护栏和任务移交
  • 02支持 OpenAI Responses 与 Chat Completions API 及 100 多种其他 LLM
  • 03沙盒智能体可在工作区内检查文件、运行命令并应用补丁
  • 04提供实时与语音智能体,支持基于 WebSocket 的语音管道
  • 05自动管理会话历史,并内置运行追踪

适用场景

  • 构建多智能体系统,让专门的智能体处理委派的子任务
  • 搭建结合语音识别、智能体与语音合成的语音助手
  • 运行需要在沙盒中读取文件、执行命令的编程或研究类智能体
  • 利用内置追踪功能调试和监控生产环境中的智能体运行

快速上手

  1. 1

    创建虚拟环境

    python -m venv .venv
  2. 2

    激活虚拟环境

    source .venv/bin/activate
  3. 3

    安装 openai-agents 包

    pip install openai-agents
  4. 4

    设置 OPENAI_API_KEY 环境变量,然后运行文本智能体

使用前须知

  • 需要 Python 3.10 或更高版本。
  • 运行示例需要 OpenAI API 密钥(OPENAI_API_KEY)。

标签

常见问题

openai-agents-python 是什么?
一个轻量的 Python 多智能体工作流框架,支持工具调用、任务移交、护栏、会话与追踪,可接入 OpenAI 及 100 多种其他 LLM。 OpenAI Agents SDK 是一个用于构建智能体的 Python 框架。开发者可以为 LLM 配置指令、工具、护栏和任务移交,让一个智能体把具体工作委派给其他智能体。它同时支持 OpenAI 的 Responses 和 Chat Completions API,以及 100 多种其他 LLM,不绑定单一模型服务商。
openai-agents-python 可以免费使用吗?用的什么许可证?
openai-agents-python 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
openai-agents-python 还在维护吗?
活跃维护中。openai-agents-python 最近一次提交是在 2026年10月20日。
openai-agents-python 适合用来做什么?
构建多智能体系统,让专门的智能体处理委派的子任务 搭建结合语音识别、智能体与语音合成的语音助手 运行需要在沙盒中读取文件、执行命令的编程或研究类智能体 利用内置追踪功能调试和监控生产环境中的智能体运行
openai-agents-python 怎么安装和运行?
创建虚拟环境: python -m venv .venv 激活虚拟环境: source .venv/bin/activate 安装 openai-agents 包: pip install openai-agents 设置 OPENAI_API_KEY 环境变量,然后运行文本智能体
在哪里获取 openai-agents-python?
源代码和安装说明在 GitHub 上:https://github.com/openai/openai-agents-python

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目