Integração do Weights & Biases#
Importa checkpoints YOLO best.pt do Weights & Biases (W&B) para o Ultralytics Platform. Os checkpoints importados tornam-se modelos do Platform normais, prontos para inspeção, inferência, exportação ou implementação.
Para registar novas execuções de treino no W&B, consulta o guia de acompanhamento de experiências YOLO.
Importar do W&B#
- Muda para o espaço de trabalho do Platform que deverá receber os modelos.
- Acede a Settings > Integrations e seleciona Weights & Biases.
- Cola a tua chave de API do W&B e clica em Connect.
- Consulta os projetos com modelos registados da tua entidade e das tuas equipas no W&B. O número de modelos, as tarefas e os tamanhos são carregados à medida que percorres a tabela.
- Seleciona os projetos a importar. Por predefinição, nenhum está selecionado; um projeto fica disponível para seleção assim que os respetivos modelos importáveis forem carregados.
- Clica em Import N, em que N é o número de projetos selecionados. O Platform importa todos os modelos elegíveis de cada projeto selecionado.
As importações aparecem no monitor de carregamentos em segundo plano e como linhas em processamento na barra lateral de modelos do projeto de destino. Mantém o separador do navegador aberto até os carregamentos terminarem; podes navegar no Platform enquanto decorrem. A pré-visualização continua disponível depois, para poderes selecionar mais projetos sem voltar a ligar-te.

Checkpoints e resultados de treino elegíveis#
Uma execução é elegível quando tem um artefacto de modelo do W&B que contém best.pt, indica uma tarefa do Platform suportada e o checkpoint está dentro do limite de carregamento de modelos de 1 GB. A integração Ultralytics para W&B regista este artefacto após o treino, quando a gravação está ativada e existe um melhor checkpoint. Não é possível selecionar projetos sem execuções elegíveis.
O Platform lê os argumentos de treino, a tarefa, os metadados e as métricas disponíveis do checkpoint, tal como faz com um carregamento de modelo. Se um checkpoint não tiver resultados por época, o Platform tenta preencher as curvas de treino com o histórico da execução no W&B. As métricas que não foram registadas continuam indisponíveis; uma falha ao obter o histórico não impede a importação do checkpoint.
Projetos de destino e reimportações#
Cada projeto W&B selecionado é importado para um projeto do Platform com o mesmo nome, que é criado se necessário. Se necessário, os nomes de modelos existentes recebem um sufixo numérico.
As execuções do W&B não são deduplicadas em relação às importações anteriores. Se importares novamente o mesmo projeto, serão criados modelos adicionais em vez de atualizados os existentes.
Se um projeto de destino estiver no Lixo, restaura-o ou elimina-o permanentemente antes de tentar novamente. Não é possível importar diretamente um projeto W&B cujo nome corresponda ao nome de projeto reservado do Platform deploy; transfere os respetivos checkpoints do W&B e carrega-os para outro projeto do Platform.
Armazenamento e permissões#
As importações do W&B estão disponíveis em todos os planos e exigem a função de editor ou superior no espaço de trabalho. Os checkpoints importados contam para os limites de armazenamento e de modelos desse espaço de trabalho.
A pré-visualização desativa a importação quando os checkpoints selecionados excedem o espaço de armazenamento disponível apresentado. Clica novamente em Connect para atualizar a utilização do armazenamento; os limites voltam a ser verificados durante o carregamento. Os projetos que não puderem ser colocados na fila permanecem selecionados para uma nova tentativa, e uma notificação indica as importações de modelos que falharam.
O Platform não guarda a chave de API do W&B como ligação. Introdu-la novamente ao iniciar uma nova sessão de importação; não existe uma ligação guardada para desligar.