OpenAI Agents SDK + Neo4j 集成
概述
OpenAI Agents SDK 是 OpenAI 用于构建 AI 代理的 Python 工具包。基于轻量且灵活的架构，它提供原生工具集成、代理之间的无缝交接、输入/输出验证的安全护栏，以及生产必备功能，如追踪、错误处理和会话管理。
安装
pip install openai-agents核心功能
-
原生 MCP（模型上下文协议）服务器支持
-
使用
@function_tool装饰器创建自定义工具 -
用于输入/输出验证的安全护栏
-
内置追踪和错误处理
-
LiteLLM 集成以支持其他大模型提供商
扩展点
MCP 身份验证
支持的机制
✅ 环境变量（STDIO 传输） - 对于本地 MCP 服务器，凭证通过生成时的 env 参数传递。
✅ HTTP 头部（HTTP/SSE 传输） - 对于远程 MCP 服务器，通过 headers 参数传递 API 密钥或 Bearer 令牌（例如 Authorization: Basic ${CREDENTIALS} 或 Authorization: Bearer ${TOKEN}）。
✅ OAuth/Bearer 令牌（托管 MCP） - 对于通过 HostedMCPTool 的 OpenAI 连接器，使用带有访问令牌的 authorization 字段。
配置示例（可流式 HTTP 传输）
credentials = base64.b64encode(f"{username}:{password}".encode()).decode()
async with MCPServerStreamableHttp(
name="Neo4j server",
params={
"url": "https://:80/mcp",
"headers": {"Authorization": f"Basic {credentials}"},
"timeout": 10,
},
) as server:
agent = Agent(
name="Assistant",
instructions="Use the MCP tools to answer the questions.",
mcp_servers=[server],
)