SuperAPI AI 工具集

openai-agents

智能体与模型

查看项目

更新于 10-15 17:29

技能介绍

用途:基于 OpenAI Agents SDK 构建多智能体(multi-agent)系统,通过工具定义、智能体交接、上下文共享与追踪来组织协作流程,并可校验 OpenAI Webhook 回调签名。

主要能力:

  • 工具定义:Python 用 @function_tool 装饰器,SDK 自动从函数签名提取参数,支持 name_override、description_override;Go 用 agents.NewFunctionTool。
  • 智能体与交接:Agent 可配置 instructions、tools、handoffs,实现智能体互相委派;支持循环交接(在定义后追加 handoffs 以避免前向引用问题),以及 on_handoff 钩子处理副作用。
  • 上下文管理:Python 使用 Pydantic BaseModel 作为共享上下文,工具通过 RunContextWrapper 访问;Go 使用 context.Value。
  • 追踪:用 trace()(Python)或 tracing.RunTrace()(Go)包裹运行,设置 group_id 以便按会话追踪。
  • 运行循环:Python 用 Runner.run,Go 用 agents.RunInputs,可迭代处理 MessageOutputItem、HandoffOutputItem 等输出项,并通过 result.to_input_list() 维持对话历史。
  • Webhook 校验:使用 OpenAI 客户端配合 webhook_secret,通过 client.webhooks.unwrap 验证签名,捕获 InvalidWebhookSignatureError 返回 400;可按 event.type(如 response.completed)处理事件。

使用方式:Python 从 agents 导入 Agent、Runner、RunContextWrapper、function_tool、handoff、trace,以及 handoff_prompt.RECOMMENDED_PROMPT_PREFIX;Go 使用 github.com/nlpodyssey/openai-agents-go 相关包。示例中模型使用 gpt-4o。

适用场景:需要多智能体分工、任务分流(triage)、客户支持委派、会话追踪以及接收 OpenAI 响应事件的 Webhook 服务。

限制:资料未说明安装命令、认证配置、具体收费与版本要求;Go 版本依赖第三方库 nlpodyssey/openai-agents-go,非官方 SDK。