追踪 OpenAI Agents SDK 应用

使用 LangSmith 追踪 OpenAI Agents SDK 的 Python 和 JavaScript 应用。

OpenAI Agents SDK 让你构建由 OpenAI 模型驱动的 agent 应用。

使用 LangSmith 追踪 OpenAI Agents SDK 的 run，包括 agent 步骤、模型调用、工具调用和交接。

安装

INFO

需要 Python SDK 版本 langsmith>=0.3.15。

安装支持 OpenAI Agents 的 LangSmith：

pip

pip install "langsmith[openai-agents]"

uv

uv add "langsmith[openai-agents]"

这会同时安装 LangSmith 库和 OpenAI Agents SDK。

环境配置

export LANGSMITH_API_KEY=<your-api-key>
export OPENAI_API_KEY=<your-openai-api-key>

# Optional: set a project for your traces
export LANGSMITH_PROJECT=<your-project-name>

# For LangSmith API keys linked to multiple workspaces, set the LANGSMITH_WORKSPACE_ID environment variable to specify which workspace to use.
export LANGSMITH_WORKSPACE_ID=<your-workspace-id>

快速开始

使用 OpenAIAgentsTracingProcessor 类将 LangSmith 追踪与 OpenAI Agents SDK 集成。

import asyncio

from agents import Agent, Runner, set_trace_processors
from langsmith.integrations.openai_agents_sdk import OpenAIAgentsTracingProcessor

async def main():
    agent = Agent(
        name="Captain Obvious",
        instructions="You are Captain Obvious, the world's most literal technical support agent.",
    )

    question = "Why is my code failing when I try to divide by zero? I keep getting this error message."
    result = await Runner.run(agent, question)
    print(result.final_output)

if __name__ == "__main__":
    set_trace_processors([OpenAIAgentsTracingProcessor()])
    asyncio.run(main())

agent 的执行流程（包括 span 及其详细信息）会记录到 LangSmith。

---