# Como integrar o classificador de ovos ao seu sistema? > Cada ovo sai do Vigiovo como um registro estruturado, em formato JSON, com classe, pontuações, motivos legíveis e medidas. Esses campos podem alimentar um painel de qualidade ou o sistema da empresa, e a integração deve tratar cada ovo como um registro independente. Antes de automatizar qualquer ação com os dados, a equipe precisa entender o que cada campo significa e o que ele não significa. Atualizado em: 2026-10-09 · URL: https://vigiovo.com/recursos/integracao-dados-da-classificacao · English: https://vigiovo.com/en/resources/integrating-egg-grading-data.md ## Resumo - Cada ovo gera um registro em formato JSON, com classe, pontuações, motivos e medidas. - Use a classe para contar e os motivos e medidas para explicar cada decisão. - As pontuações são uma fórmula fixa, não probabilidades, e não devem ser lidas como medida de confiança. - A câmera não vê o interior do ovo, então um painel com esses dados não mede a qualidade interna. - Antes de acionar um desviador ou qualquer outra ação automática, valide a integração com ovos rotulados da sua linha. ## O que cada campo do registro significa? Cada registro tem um número de identificação do ovo, a classe, as pontuações das três classes de defeito (limpo, sujo e trincado), uma lista de motivos em texto simples e um bloco de medidas. A classe é a decisão final. Os motivos explicam a decisão, e as medidas são os números que os motivos usam. Os campos de medida são: a fração de sujeira, o comprimento da trinca em múltiplos do [raio de referência](https://vigiovo.com/recursos/glossario#raio-de-referencia), a solidez, o preenchimento da elipse, a razão entre os eixos e se o ovo toca a borda da imagem. Um ovo que toca a borda não é julgado: ele recebe a classe não verificado. Um exemplo da imagem de demonstração: um ovo trincado registrou o motivo de comprimento de trinca de 1,22 r contra o limite de 0,80 r. Quem lê o registro vê o motivo e o número que o gerou, sem consultar outra fonte. ## Como usar os registros para contar classes e filtrar lotes? A contagem por classe é a forma mais simples de usar os dados: some quantos ovos de cada classe passaram por um lote, um turno ou um galpão. A associação com o lote, o turno ou o horário precisa ser feita no seu sistema, porque a descrição do registro por ovo não trata desses campos. Vale somar também os motivos. Um aumento de ovos sujos pode vir de mais sujeira na casca ou de uma mudança de limiar, e só o motivo e a medida registrados mostram a diferença. Um painel que mostra apenas a taxa de cada classe não diz por que ela mudou. ## Quando é seguro acionar uma ação automática com esses dados? Na maior parte dos casos, comece pelo painel e não pela ação automática. Um desviador ou um alarme que reage a cada registro transforma um erro de limiar em perda de produto imediata. Um registro de ovo vê só a superfície, então ações baseadas nele tratam apenas o que a superfície mostra. Qualquer decisão que dependa de câmara de ar, gema ou [trinca capilar](https://vigiovo.com/recursos/glossario#trinca-capilar) continua dependendo da [ovoscopia](https://vigiovo.com/recursos/glossario#ovoscopia). 1. Valide a integração com ovos rotulados da sua linha antes de ligar qualquer ação. 2. Rode o painel em modo de observação por um período e compare com a avaliação da equipe. 3. Defina quem recebe os alertas e o que fazer quando a taxa de um defeito muda de repente. 4. Registre cada ação automática com a regra usada, para que a auditoria consiga reconstruí-la. A calibração com ovos rotulados é o passo que valida os limiares antes da integração: veja a [calibração com ovos rotulados](https://vigiovo.com/recursos/calibracao-com-ovos-rotulados). ## Por que o mesmo registro deve sair igual para a mesma imagem? O [Vigiovo](https://vigiovo.com/como-funciona) é determinístico: a mesma imagem e a mesma configuração dão o mesmo resultado. Isso ajuda a integração, porque se um número mudar sem explicação, a primeira suspeita deve ser a configuração ou a imagem, e não o próprio classificador. Sobre o tema, veja [reprodutibilidade na inspeção](https://vigiovo.com/recursos/reprodutibilidade-na-inspecao). Por isso, guarde junto com os registros a configuração em uso e a data de cada mudança. Sem isso, uma diferença entre duas semanas não tem como ser explicada. ## Perguntas frequentes ### O registro do Vigiovo pode alimentar um painel de qualidade? Sim. Cada ovo sai como um registro estruturado, com classe, pontuações, motivos e medidas. O que o painel mostra e como os dados são agregados cabe à sua equipe, e os números devem ser lidos com a limitação de que a câmera vê apenas a superfície do ovo. ### Posso usar as pontuações como nível de confiança? Não. As pontuações vêm de uma fórmula fixa aplicada às medidas, e não são probabilidades estimadas a partir de dados. Uma medida de confiança real exigiria outra validação. Use as medidas e o motivo para entender cada decisão. ### A integração substitui a ovoscopia? Não. A câmera vê a superfície do ovo, e a ovoscopia vê o interior, incluindo câmara de ar, gema e trincas finas. Dados da câmera não devem ser usados para afirmar a qualidade interna do ovo. A ovoscopia continua sendo a etapa que verifica esses critérios. ## Fontes - [Como o Vigiovo classifica ovos sem IA / How Vigiovo grades eggs without AI](https://vigiovo.com/como-funciona), Vigiovo ## Leia também - [Ovos brancos e vermelhos: o que muda na inspeção por câmera](https://vigiovo.com/recursos/ovos-brancos-e-vermelhos-na-camera.md) (Explicação, 2026-10-09): Por que os limiares padrão do Vigiovo foram pensados para ovos marrons e cremes, o que a casca branca ou azulada muda na máscara de cor e como recalibrar. - [Reprodutibilidade: mesma imagem, mesmo resultado](https://vigiovo.com/recursos/reprodutibilidade-na-inspecao.md) (Explicação, 2026-10-09): Por que a reprodutibilidade importa em auditorias e disputas na classificação de ovos, o que a torna possível no Vigiovo e o que ela não garante. - [Ovoscopia ou visão computacional: o que cada uma detecta](https://vigiovo.com/recursos/ovoscopia-vs-visao-computacional.md) (Comparação, 2026-10-09): Comparação entre ovoscopia e inspeção por câmera na classificação de ovos: defeitos que cada uma detecta, velocidade, registro e por que as duas se completam. ## Como o Vigiovo ajuda O Vigiovo classifica ovos na esteira como limpos, sujos, trincados ou não verificados, em tempo real, com visão computacional determinística: cada decisão vem com as medidas que a justificam e roda em CPU comum. https://vigiovo.com/como-funciona.md 4 min de leitura.