Repolode
wandb

wandb/weave

Weights & Biases 推出的 Python 工具包,用于追踪和评估 AI 智能体与 LLM 应用。

可替代:LangSmith

Star
1,144
Fork
183
未关闭 Issue
164
最近提交
19小时前

这是什么?

Weave 是 Weights & Biases 推出的工具包,用于追踪和评估 AI 智能体。它会记录对话、轮次、LLM 调用和工具调用,并在 W&B 网页界面的 Agents 标签页中展示。使用 @weave.op 装饰器可以追踪普通函数,结果显示在 Calls 标签页中。

调用 weave.init() 后,Weave 会自动接入 OpenAI Agents SDK、Claude Agent SDK、Google ADK 等受支持的智能体框架,也会自动追踪原生 openai 客户端的调用。对于未使用这些框架的智能体,可以通过 start_conversation、start_turn、start_llm 等上下文管理器自行记录执行循环。

项目需要 Python 3.10 及以上版本,并需要一个 Weights & Biases 账号和 API Key。追踪数据保存在 W&B 项目中,查看时需要登录其托管服务。

核心功能

  • 01在 Agents 标签页中追踪智能体的对话、轮次、LLM 调用和工具调用。
  • 02调用 weave.init() 后自动接入 OpenAI Agents SDK、Claude Agent SDK 和 Google ADK。
  • 03通过 @weave.op 装饰器追踪普通 Python 函数。
  • 04提供 Conversation API,用于追踪自定义的智能体循环。
  • 05自动追踪 openai Python 客户端发出的调用。

适用场景

  • 借助工具调用和 LLM 请求记录,调试基于受支持框架构建的多轮智能体。
  • 为未使用受支持框架的自定义智能体循环添加追踪。
  • 对 LLM 应用的输出运行评估和评分函数。
  • 记录 LLM 调用的 token 用量和模型响应。

快速上手

  1. 1

    安装 Weave 和 OpenAI Agents SDK

    pip install weave openai-agents requests
  2. 2

    设置 WANDB_API_KEY 和 OPENAI_API_KEY 环境变量

  3. 3

    运行示例代码,然后在打印的项目链接中打开 Agents 标签页

使用前须知

  • 查看追踪记录需要 Weights & Biases 账户和 API 密钥。
  • 高级 Weave 引擎和看板代码已暂停,目前不在积极开发中。

收录于专题

标签

常见问题

weave 是什么?
Weights & Biases 推出的 Python 工具包,用于追踪和评估 AI 智能体与 LLM 应用。 Weave 是 Weights & Biases 推出的工具包,用于追踪和评估 AI 智能体。它会记录对话、轮次、LLM 调用和工具调用,并在 W&B 网页界面的 Agents 标签页中展示。使用 @weave.op 装饰器可以追踪普通函数,结果显示在 Calls 标签页中。
weave 可以免费使用吗?用的什么许可证?
weave 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
weave 还在维护吗?
活跃维护中。weave 最近一次提交是在 2026年11月6日。
weave 适合用来做什么?
借助工具调用和 LLM 请求记录,调试基于受支持框架构建的多轮智能体。 为未使用受支持框架的自定义智能体循环添加追踪。 对 LLM 应用的输出运行评估和评分函数。 记录 LLM 调用的 token 用量和模型响应。
weave 怎么安装和运行?
安装 Weave 和 OpenAI Agents SDK: pip install weave openai-agents requests 设置 WANDB_API_KEY 和 OPENAI_API_KEY 环境变量 运行示例代码,然后在打印的项目链接中打开 Agents 标签页
在哪里获取 weave?
源代码和安装说明在 GitHub 上:https://github.com/wandb/weave

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目