openai-agents-python
一個輕量級、功能強大的多代理工作流程框架。
openai-agents-python 是什麼?
一個輕量級、功能強大的多代理工作流程框架。使用 MIT 授權條款。
openai-agents-python 概覽
這是什麼
OpenAI Agents SDK 是一個輕量但功能強大的框架,用於建構多代理工作流程。它與供應商無關,支援 OpenAI Responses 與 Chat Completions API,以及超過 100 種其他 LLM。SDK 包含核心概念,如代理、沙盒代理、即時代理、語音代理、代理作為工具/交接、工具、護欄、人機協作、對話歷史管理與追蹤。
主要功能
- 代理:配置了指令、工具、護欄與交接功能的 LLM。
- 沙盒代理:預先配置可與容器協作,適用於長時間任務的代理。
- 即時代理:使用 gpt-realtime-2.1 建構具備完整代理功能的語音代理。
- 語音代理:結合語音轉文字、代理工作流程與文字轉語音的語音管線。
- 交接:將特定任務委派給其他代理。
- 工具:多種工具(函式、MCP、託管工具)讓代理能採取行動。
- 護欄:可設定的安全檢查,用於輸入與輸出驗證。
- 人機協作:內建機制,可在代理執行過程中引入人類參與。
- 對話歷史管理:自動管理跨代理執行的對話歷史。
- 追蹤:內建代理執行追蹤,可檢視、除錯與最佳化工作流程。
使用情境
- 建構需要多個 LLM 驅動代理協調的多代理工作流程。
- 建立沙盒環境,讓代理能檢查檔案、執行命令、套用修補程式或長時間保留工作區狀態。
- 透過即時代理開發低延遲的語音與多模態體驗(基於 WebSocket)。
- 實作語音管線,將音訊轉換為文字、執行代理工作流程,並串流輸出合成語音。
- 透過交接將特定任務委派給專門的代理。
快速開始
設定 Python 環境(需 Python 3.10 或更新版本),然後安裝套件。 bash python -m venv .venv source .venv/bin/activate # 在 Windows 上:.venv/Scripts/activate pip install openai-agents 如需語音支援:pip install 'openai-agents[voice]'。如需 Redis 對話歷史支援:pip install 'openai-agents[redis]'。 或者使用 uv: bash uv init uv add openai-agents 如需語音支援:uv add 'openai-agents[voice]'。如需 Redis 對話歷史支援:uv add 'openai-agents[redis]'。 執行範例前請先設定 OPENAI_API_KEY 環境變數。
授權與價格
本專案採用 MIT 授權條款,為開放原始碼。未提及任何價格資訊。
內容整理自該專案公開的 README 與儲存庫資訊。