Weights & Biases 集成#
将 Weights & Biases (W&B) 中的 YOLO best.pt 检查点导入 Ultralytics Platform。导入的检查点会成为常规的 Platform 模型，可供检查、预测、导出或部署。
如需将新的训练运行记录到 W&B，请参阅 YOLO 实验跟踪指南。
从 W&B 导入#
- 切换到要接收模型的 Platform 工作区。
- 前往 Settings > Integrations，然后选择 Weights & Biases。
- 粘贴你的 W&B API 密钥，然后点击 Connect。
- 查看你的 W&B 实体和团队中记录了模型的项目。浏览表格时，模型数量、任务和大小会逐步加载。
- 选择要导入的项目。默认情况下不会选中任何项目；项目中的可导入模型加载完成后，该项目才可供选择。
- 点击 Import N，其中 N 是所选项目的数量。Platform 会从每个所选项目中导入所有符合条件的模型。
导入任务会显示在后台上传跟踪器中，也会作为正在处理的行显示在目标项目的模型侧边栏中。请保持浏览器标签页打开，直到上传完成；上传期间你可以在 Platform 内切换页面。之后仍可使用预览，无需重新连接即可选择更多项目。
符合条件的检查点和训练结果#
当某次运行包含一个内含 best.pt 的 W&B 模型工件、报告了 Platform 支持的任务，且检查点未超过 1 GB 模型上传限制时，该运行符合导入条件。Ultralytics W&B 集成会在训练后于启用保存且存在最佳检查点时记录此工件。没有符合条件的运行的项目无法选择。
Platform 会读取检查点的训练参数、任务、元数据和可用指标，方式与处理模型上传相同。如果检查点缺少逐轮结果，Platform 会尝试从该运行的 W&B 历史记录中补全训练曲线。未记录的指标仍不可用；即使无法获取历史记录，也不会阻止检查点导入。
目标项目和重新导入#
每个选定的 W&B 项目都会导入到同名的 Platform 项目中；如果该项目不存在，系统会创建它。必要时，现有模型名称会添加数字后缀。
W&B 运行不会与之前的导入内容去重。再次导入同一项目会创建额外模型，而不是更新现有模型。
如果目标项目位于回收站，请先恢复它或将其永久删除，再重试。名称解析为保留的 Platform 项目名称 deploy 的 W&B 项目无法直接导入；请从 W&B 下载其检查点，然后将其上传到另一个 Platform 项目。
存储和权限#
所有套餐均可使用 W&B 导入功能，但需要工作区编辑者角色或更高权限。导入的检查点会占用该工作区的存储空间并计入模型限额。
如果所选检查点超出显示的可用存储空间，预览会禁用导入。再次点击 Connect 可刷新存储用量；上传期间系统会再次检查限额。无法排入队列的项目会保持选中状态，方便重试；通知会报告模型导入失败的情况。
Platform 不会将 W&B API 密钥保存为连接。开始新的导入会话时，请重新输入密钥；由于没有已保存的连接，因此无需断开连接。