openai-agents-js
一個輕量級、強大的框架,用於多代理工作流程與語音代理
openai-agents-js 是什麼?
一個輕量級、強大的框架,用於多代理工作流程與語音代理。此框架專為多代理協作與語音互動設計,提供高效能與靈活性。
openai-agents-js 概覽
這是什麼
OpenAI Agents SDK 是一個輕量但功能強大的框架,用於在 JavaScript/TypeScript 中建構多代理工作流程。它與供應商無關,支援 OpenAI API 及其他服務。SDK 包含的核心概念有:代理(Agents)、沙盒代理(Sandbox Agents)、即時代理(Realtime Agents)、代理作為工具/交接(Handoffs)、工具(Tools)、護欄(Guardrails)、人機協作(Human in the loop)、對話管理(Sessions)以及追蹤(Tracing)。
主要功能
- 代理可設定指令、工具、護欄與交接 - 沙盒代理搭配檔案系統工作區與沙盒環境,適合長時間執行的工作 - 即時代理提供低延遲語音互動,支援工具、護欄、交接與對話歷史 - 工具類型:函式、MCP、託管工具 - 護欄機制用於輸入與輸出驗證 - 人機協作機制可在代理執行過程中引入人類參與 - 對話管理自動處理對話歷史 - 追蹤功能可檢視、除錯與最佳化工作流程
使用情境
- 使用一般代理進行純文字工作流程 - 使用沙盒代理執行檔案系統操作、執行指令或跨任務維持工作區狀態 - 在瀏覽器中透過即時代理進行低延遲語音互動 - 透過交接將任務委派給其他代理
快速開始
安裝 SDK 及其同儕依賴: bash npm install @openai/agents zod 為文字與沙盒代理設定 OPENAI_API_KEY 環境變數。若使用瀏覽器即時代理,請在伺服器端建立短期有效的暫時用戶端權杖。 基本文字代理範例: js import { Agent, run } from '@openai/agents'; const agent = new Agent({ name: 'Assistant', instructions: 'You are a helpful assistant.', }); const result = await run( agent, 'Write a haiku about recursion in programming.', ); console.log(result.finalOutput); 更多範例請參閱 examples/ 目錄。
授權與價格
本專案採用 MIT 授權條款,為開放原始碼(免費)。
內容整理自該專案公開的 README 與儲存庫資訊。