AgentOps

AI Agent 的可观测性与开发工具平台

AgentOps 致力于帮助开发者构建、评估和监控 AI Agent。涵盖从原型设计到生产部署的全过程。

开源声明

AgentOps 应用在 MIT 许可协议下开源。欢迎访问我们的 app 目录 查看源代码。

核心集成 🔌

📊 回放分析与调试	分步 Agent 执行图表
💸 LLM 成本管理	跟踪 LLM 基础模型提供商的支出
🤝 框架集成	原生集成 CrewAI、AG2 (AutoGen)、Agno、LangGraph 等
⚒️ 自托管	想在自己的云端运行 AgentOps？完全支持

快速上手 ⌨️

pip install agentops

仅需两行代码实现会话回放

初始化 AgentOps 客户端，即可自动获取所有 LLM 调用的分析数据。

获取 API key

import agentops

# 程序开头 (例如 main.py, __init__.py)
agentops.init( )

...

# 程序结束
agentops.end_session('Success')

您可以在 AgentOps 控制台 查看所有会话。

自托管

如果您希望在本地运行完整的 AgentOps 应用（控制台 + API 后端），请按照 app/README.md 中的设置指南操作：

• 运行应用与后端 (控制台 + API)

一流的开发者体验

通过尽可能少的代码，为您的 Agent、工具和函数添加强大的可观测性：逐行实现。

请参考我们的 文档

# 创建一个 session span (所有其他 span 的根节点)
from agentops.sdk.decorators import session

@session
def my_workflow():
    # 在此处编写会话代码
    return result

# 创建一个 agent span 用于跟踪 Agent 操作
from agentops.sdk.decorators import agent

@agent
class MyAgent:
    def __init__(self, name):
        self.name = name
        
    # 在此处编写 Agent 方法

# 创建 operation/task span 以跟踪特定操作
from agentops.sdk.decorators import operation, task

@operation  # 或 @task
def process_data(data):
    # 处理数据
    return result

# 创建 workflow span 以跟踪多操作工作流
from agentops.sdk.decorators import workflow

@workflow
def my_workflow(data):
    # 工作流实现
    return result

# 嵌套装饰器以构建正确的 span 层级
from agentops.sdk.decorators import session, agent, operation

@agent
class MyAgent:
    @operation
    def nested_operation(self, message):
        return f"Processed: {message}"
        
    @operation
    def main_operation(self):
        result = self.nested_operation("test message")
        return result

@session
def my_session():
    agent = MyAgent()
    return agent.main_operation()

所有装饰器均支持：

• 输入/输出记录
• 异常处理
• Async/await 函数
• 生成器函数
• 自定义属性和名称

集成 🦾

OpenAI Agents SDK 🖇️

利用工具、移交（handoffs）和护栏（guardrails）构建多 Agent 系统。AgentOps 为 Python 和 TypeScript 的 OpenAI Agents SDK 提供了原生集成。

Python

pip install openai-agents

• Python 集成指南
• OpenAI Agents Python 文档

TypeScript

npm install agentops @openai/agents

• TypeScript 集成指南
• OpenAI Agents JS 文档

CrewAI 🛶

仅需两行代码即可为 Crew Agent 添加可观测性。只需在环境变量中设置 AGENTOPS_API_KEY，您的 Crew 就会自动在 AgentOps 控制台上进行监控。

pip install 'crewai[agentops]'

• AgentOps 集成示例
• CrewAI 官方文档

AG2 🤖

只需两行代码，即可为 AG2（前身为 AutoGen）Agent 添加全面的可观测性和监控功能。在环境变量中设置 AGENTOPS_API_KEY 并调用 agentops.init()。

• AG2 可观测性示例