用途:为机器学习实验提供跟踪、运行管理与制品版本控制能力,并支持 LLM 可观测性(Weave)。当用户提及 W&B 时可使用。
主要能力与接口:基础 URL 为 https://api.wandb.ai,提供两类接口——REST API(运行管理、制品、报告)与 GraphQL API(https://api.wandb.ai/graphql,用于灵活查询)。支持获取项目下的运行列表及指标与配置、获取单个运行、更新运行标签或注释、通过 GraphQL 过滤与聚合运行、列出项目制品、下载制品文件、列出报告,以及通过 GraphQL Mutation 记录自定义指标。
认证与用法:所有请求需以 Bearer 令牌传递 API 密钥:Authorization: Bearer $WANDB_TOKEN。示例:curl -s "https://api.wandb.ai/api/v1/runs/<entity>/<project>" --header "Authorization: Bearer $WANDB_TOKEN"。其中 entity 为 W&B 用户名或团队标识,project 为项目名。更新运行使用 PATCH 方法,GraphQL 查询使用 POST 并携带 query 与 variables 的 JSON 文件。
使用前提:需在 app.vm0.ai/connectors 连接 Weights & Biases 连接器。故障排查可运行 zero doctor check-connector --env-name WANDB_TOKEN 或 zero doctor check-connector --url https://api.wandb.ai/graphql --method POST。
适用场景:适合在 MLOps 流程中查询实验指标、筛选最佳运行、更新实验元数据、管理数据集与模型制品版本,以及构建 LLM 可观测性。
限制与注意事项:多数端点需同时提供 entity 与 project。复杂过滤、排序或聚合建议优先使用 GraphQL,简单增删改查用 REST。运行 ID 为短字母数字串(如 abc12def),可在 W&B UI 的 URL 中看到。制品版本为零起始整数加 v 前缀(如 v0、v1),可用 latest 表示最新版本。W&B 对每用户有速率限制,批量操作应使用 GraphQL 游标分页(first/after)。更多参考:REST 文档 https://docs.wandb.ai/ref/rest,GraphQL 文档 https://docs.wandb.ai/ref/query-panel/graphql,Python SDK https://docs.wandb.ai/ref/python,Weave https://wandb.github.io/weave/。收费与价格信息暂未提供。