Início rápido: avaliar um modelo de aprendizado de máquina
Tome este tutorial para aprender como avaliar um modelo que prevê quais candidatos se qualificam para hipotecas. Deve-se avaliar o modelo para qualidade, justiça e explicabilidade.
- Serviços necessários
- watsonx.ai Runtime
- watsonx.ai Studio
- Watson OpenScale
O fluxo de trabalho básico inclui estas tarefas:
- Abrir um projeto. Os projetos são onde você pode colaborar com outras pessoas para trabalhar com dados e modelos
- Construa um modelo. É possível construir um modelo usando um destes métodos:
- Crie um notebook Jupyter e adicione o código Python.
- Crie um experimento do AutoAI
- Implemente seu modelo.
- Configure os monitores do Watson OpenScale usando um destes métodos:
- Crie um bloco de notas Jupyter.
- Inclua a implementação no painel do Watson OpenScale usando a UI.
Leia sobre Watson OpenScale
O Watson OpenScale rastreia e mede resultados de seus modelos de IA e ajuda a assegurar que eles permaneçam justos, explicáveis e compatíveis, independentemente de onde seus modelos foram construídos ou estão em execução. O Watson OpenScale também detecta e ajuda a corrigir o desvio na precisão quando um modelo de IA está em produção.
Assista a um vídeo sobre como avaliar um modelo de aprendizado de máquina
Assista a este vídeo para visualizar as etapas deste tutorial. Pode haver pequenas diferenças na interface do usuário mostrada no vídeo. O vídeo é destinado a ser um companheiro para o tutorial escrito. O vídeo começa no hub de recursos.
Este vídeo fornece um método visual para aprender os conceitos e tarefas nesta documentação.
Tente um tutorial sobre como avaliar um modelo de aprendizado de máquina
Neste tutorial, você concluirá estas tarefas:
- Tarefa 1: Criar o Projeto de Amostra
- Tarefa 2: Implementar o modelo
- Tarefa 3: Executar o bloco de notas para configurar os monitores
- tarefa 4: avaliar o modelo
- Tarefa 5: Observar os monitores de modelo para qualidade
- Tarefa 6: Observe os monitores de modelo para imparcialidade
- Tarefa 7: Observe os monitores de modelo para desvio
- Tarefa 8: Observar os monitores de modelo para explicabilidade
Dicas para concluir este tutorial
Aqui estão algumas dicas para concluir com sucesso este tutorial.
Use a imagem em vídeo
A imagem animada a seguir mostra como usar os recursos de imagem em vídeo e de índice:

Configure as janelas do navegador
Para uma experiência ideal ao concluir este tutorial, abra sua conta em uma janela do navegador e mantenha esta página do tutorial aberta em outra janela do navegador para alternar facilmente entre as duas janelas. Considere organizar as duas janelas do navegador lado a lado para facilitar o acompanhamento.

Tarefa 1: Criar o Projeto de Amostra
Para visualizar esta tarefa, assista ao vídeo a partir do minuto 00:06.
Este tutorial usa um projeto de amostra contendo um modelo de aprendizado de máquina e um notebook para configurar os monitores. Siga estas etapas para criar um projeto com base em uma amostra
Acesse o projeto de amostra Avaliar um modelo de ML no hub de recursos.
Clique em Criar projeto.
Se solicitado a associar o projeto a uma instância Cloud Object Storage, selecione uma instância Cloud Object Storage a partir da lista.
Clique em Criar.
Aguarde a importação do projeto ser concluída e, em seguida, clique em Visualizar novo projeto para verificar se o projeto e os ativos foram criados com êxito.
Clique na aba Ativos para visualizar os ativos no projeto de amostra.
Verifique seu progresso
A imagem a seguir mostra o projeto de amostra Agora você está pronto para iniciar o tutorial.

Tarefa 2: Implementar o modelo
Antes de poder implementar o modelo, é necessário promover o modelo para um novo espaço de implementação Os espaços de implementação ajudam a organizar recursos de suporte, como dados de entrada e ambientes; implementar modelos ou funções para gerar predições ou soluções; e visualizar ou editar detalhes da implementação.
Tarefa 2a: Promover o modelo para um espaço de implementação
Para visualizar esta tarefa, assista ao vídeo a partir do minuto 00:49.
Siga estas etapas para promover o modelo para um novo espaço de implementação:
Na guia Ativos , clique em Modelo de Previsão de Aprovação de Hipoteca para visualizar o modelo.
Na página do modelo, clique no ícone Promover para o espaço
de implantação.
Para o Espaço de destino, selecione Criar um novo espaço de implementação.
Para o nome do espaço de implantação, copie e cole o nome exatamente como mostrado, sem espaços à esquerda ou à direita:
Golden Bank Preproduction SpaceSelecione um serviço de armazenamento da lista.
Selecione o seu serviço de aprendizado de máquina fornecido na lista.
Clique em Criar.
Clique em Fechar.
Para o Espaço de destino, certifique-se de que Espaço de pré-produção do Golden Bank esteja selecionado.
Marque a opção Acesse o modelo no espaço após promovê-lo.
Clique em Promover.
Verifique seu progresso
A imagem a seguir mostra o modelo no espaço de implementação Agora você está pronto para criar uma implementação de modelo.

Tarefa 2b: Criar uma implementação on-line do modelo
Para visualizar essa tarefa, assista ao vídeo começando em 01:30.
Siga estas etapas para criar uma implementação on-line para seu modelo:
Quando o espaço de implementação abrir, clique em Nova implementação.
Para o Tipo de implementação, selecione On-line.
Para o Name, copie e cole o nome da implantação exatamente como mostrado, sem espaços à esquerda ou à direita:
Mortgage Approval Model DeploymentClique em Criar.
Aguarde a implementação do modelo ser concluída. Quando o modelo for implementado com sucesso, visualize a implementação para ver o terminal de pontuação e, opcionalmente, teste o modelo.
Verifique seu progresso
A imagem a seguir mostra a implementação do modelo Agora você está pronto para executar o bloco de notas para configurar os monitores.

Tarefa 3: Executar o bloco de notas para configurar os monitores
Para visualizar esta tarefa, assista ao vídeo a partir do minuto 01:55.
Execute o notebook incluído no projeto de amostra para:
- Busque o modelo e as implementações
- Configurar Watson OpenScale.
- Crie o provedor de serviços e a assinatura para seu serviço de aprendizado de máquina.
- Configure o monitor de qualidade
- Configure o monitor de justiça.
- Configure a explicabilidade.
Siga estas etapas para executar o notebook incluído no projeto de amostra. Esse bloco de notas configura monitores para seu modelo, que também podem ser configurados por meio da interface com o usuário.. No entanto, é mais rápido e menos propenso a erro configurá-los com um notebook. Reserve um tempo para ler os comentários no bloco de notas, que explicam o código em cada célula.
No Menu de
Navegação, selecione Projetos > Exibir todos os projetos.
Abra o projeto Avaliar um modelo de ML
Clique na guia Ativos e navegue até Cadernos.
Nota:Se você vir um ícone
de “Atenção” ao lado do notebook, clique no menu
“Overflow” ao lado do notebook “monitor-wml-model-with-watson-openscale ” e selecione “Alterar ambiente ”. Selecione um modelo de Runtime on Python compatível e clique em Change (Alterar ).
Abra o notebook monitor-wml-model-with-watson-openscale .
Como o caderno está no modo somente leitura, clique no ícone
“Editar” para colocá-lo no modo de edição.
Observe a primeira célula deste caderno. Se você importou o notebook de um projeto, ele contém o token de acesso do projeto.
Se o caderno não contiver um token de acesso ao projeto na primeira célula, gere um. Para gerar o token, no menu “Mais ”, selecione “Inserir token do projeto ”. Essa ação insere uma nova célula como a primeira célula no bloco de notas que contém o token do projeto
Na seção Fornecer sua chave de API do IBM Cloud, você precisa passar suas credenciais para a API do watsonx.ai Runtime usando uma chave de API. Se você ainda não tiver uma chave de API salva, siga estas etapas para criar uma chave de API.
Clique em Criar uma chave de API do IBM Cloud. Se você tiver alguma chave API existente, o botão poderá ser rotulado Criar.
Digite um nome e uma descrição.
Clique em Criar.
Copiar a chave de API.
Faça o download da chave de API para uso futuro.
Retorne ao bloco de notas e cole sua chave de API no campo ibmcloud_api_key .
No 3. Seção Modelo e Implementação , verifique os valores designados às variáveis space_name, model_namee deployment_name .
Clique em Célula> Executar Todos para executar todas as células no bloco de notas Como alternativa, clique no ícone
“Executar” ao lado de cada célula para executar o notebook célula por célula e explorar cada célula e sua saída.
O caderno leva de 1 a 3 minutos para ser concluído. É possível monitorar a célula de progresso por célula observando o asterisco "In [
*]" mudando para um número, por exemplo, "In [1]".Se você encontrar erros durante a execução do bloco de notas, tente estas dicas de resolução de problemas:
Clique em Kernel> Reiniciar & Limpar Saída para reiniciar o kernel e, em seguida, execute o bloco de notas novamente
Exclua quaisquer implementações existentes do Watson OpenScale e provisione uma nova instância de serviço
Verifique se você criou o espaço de implementação e o nome da implementação copiando e colando o nome do artefato especificado exatamente sem espaços iniciais ou finais.
Verifique seu progresso
A imagem a seguir mostra o bloco de notas quando a execução é concluída O notebook configurou monitores para o seu modelo; assim, agora você pode visualizar a implantação em Watson OpenScale.

Tarefa 4: Avaliar o modelo
Para ter uma prévia desta tarefa, assista ao vídeo a partir dos 03:35.
Siga estas etapas para fazer download de dados de validação e use esses dados para avaliar o modelo no Watson OpenScale:
Clique no projeto Avaliar um modelo de ML na trilha de navegação

Na guia Ativos , clique em Dados> Ativos de dados
Clique no menu
de opções do ativo de dados “ GoldenBank_HoldoutData.csv ” e selecione “Baixar ”. Para validar que o modelo está funcionando conforme necessário, é necessário um conjunto de dados rotulados, que foi mantido do treinamento do modelo. Este arquivo CSV contém esses dados de retenção.
Ative o Watson OpenScale.
No menu de navegação, selecione Serviços > Instâncias de serviço.
Clique em sua instância do Watson OpenScale para abrir a página da instância de serviço Se solicitado, efetue login usando as mesmas credenciais que você usou para se inscrever no Cloud Pak for Data.
Nota:A sua instância pode ter um nome diferente, como `watsonx.governance-xx` Na página da instância de serviço Watson OpenScale , clique em Ativar Watson OpenScale.
No Painel de insights, clique no bloco Implementação do modelo de aprovação de hipoteca.
A partir do menu Ações, selecione Avaliar agora.
A partir da lista de opções de importação, selecione a partir do arquivo CSV.
Arraste o arquivo de dados “ GoldenBank_HoldoutData.csv”, que você baixou do projeto, para o painel lateral.
Clique em Fazer upload e avaliar e aguarde a conclusão da avaliação.
Verifique seu progresso
A imagem a seguir mostra o resultado da avaliação para o modelo implementado no Watson OpenScale Agora que avaliou o modelo, você está pronto para observar a qualidade do modelo.

Tarefa 5: Observar os Monitores de Modelo para Qualidade
Para ter uma prévia desta tarefa, assista ao vídeo a partir dos 04:40.
O monitor de qualidade Watson OpenScale gera um conjunto de métricas para avaliar a qualidade de seu modelo. É possível usar essas métricas de qualidade para determinar o quão bem seu modelo prevê os resultados. Quando a avaliação que usa os dados de validação for concluída, siga estas etapas para observar a qualidade ou precisão do modelo:
Na seção Qualidade, clique no ícone Configurar. Aqui é possível ver que o limite de qualidade configurado para esse monitor é de 70% e que a medição de qualidade que está sendo usada é a área sob a curva ROC.Clique em Acessar resumo do modelo para retornar para a tela de detalhes do modelo
Na seção “Qualidade”, clique no ícone
“Detalhes” para visualizar os resultados detalhados da qualidade do modelo. Aqui você vê um número de cálculos de métrica de qualidade e uma matriz de confusão mostrando decisões de modelo corretas, juntamente com falsos positivos e falsos negativos. A área calculada sob a curva ROC é 0.9 ou superior, o que excede o limite 0.7 , portanto, o modelo está atendendo seu requisito de qualidade.Clique em Implementação do modelo de aprovação de hipoteca na trilha de navegação para retornar à tela de detalhes do modelo.
Verifique seu progresso
A imagem a seguir mostra os detalhes de qualidade em Watson OpenScale Agora que você observou a qualidade do modelo, é possível observar a justiça do modelo.

Tarefa 6: Observar os monitores de modelo para justiça
Para ter uma prévia desta tarefa, assista ao vídeo a partir dos 05:41.
O monitor de justiça do Watson OpenScale gera um conjunto de métricas para avaliar a imparcialidade de seu modelo. É possível usar as métricas de justiça para determinar se o seu modelo produz resultados propensos. Siga estas etapas para observar a justiça do modelo:
Na seção “Fairness ”, clique no ícone “Configurar ”. Aqui você consulta que o modelo está sendo revisado para garantir que os candidatos estão sendo tratados imparcialmente, independentemente de seu gênero. As mulheres são identificadas como o grupo monitorado para quem a equidade está sendo medida e o limite para a equidade é ser de pelo menos 80%. O monitor de equidade usa o método de impacto discrepante para determinar a equidade. O impacto díspar compara a porcentagem dos resultados favoráveis de um grupo monitorado com a porcentagem dos resultados favoráveis de um grupo de referência.Clique em Acessar resumo do modelo para retornar para a tela de detalhes do modelo
Na seção “Equidade ”, clique no ícone
“Detalhes” para visualizar os resultados detalhados sobre a equidade do modelo. Aqui você vê a porcentagem de candidatos do sexo masculino e feminino que estão sendo aprovados automaticamente, juntamente com uma pontuação de justiça de mais de 100%, portanto, o desempenho do modelo excede muito o limite de imparcialidade de 80% necessário.Anote os conjuntos de dados identificados Para assegurar que as métricas de imparcialidade sejam mais precisas, o Watson OpenScale usa a perturbação para determinar os resultados em que apenas os atributos protegidos e as entradas de modelo relacionadas são alterados enquanto outros recursos permanecem os mesmos. A perturbação muda os valores do recurso do grupo de referência para o grupo monitorado, ou vice-versa. Essas balizas adicionais são usadas para calcular a equidade quando o conjunto de dados "balanceados" for usado, mas também é possível visualizar os resultados de equidade usando apenas dados de carga útil ou de treinamento do modelo. Como o modelo está se comportando adequadamente, não é necessário entrar em mais detalhes sobre essa métrica.

Clique na trilha de navegação Implementação do modelo de aprovação de hipoteca para retornar à tela de detalhes do modelo.
Verifique seu progresso
A imagem a seguir mostra os detalhes de justiça no Watson OpenScale. Agora que você observou a justiça do modelo, é possível observar a explicabilidade do modelo.

Tarefa 7: Observar os monitores de modelo para desvio
Para ter uma prévia desta tarefa, assista ao vídeo a partir dos 07:25.
O monitor de desvio do Watson OpenScale mede as mudanças em seus dados ao longo do tempo para assegurar resultados consistentes para seu modelo Use avaliações de desvio para identificar mudanças em sua saída de modelo, a precisão de suas previsões e a distribuição de seus dados de entrada. Siga estas etapas para observar o desvio do modelo:
Na seção Drift, clique no ícone “Configurar ”. Aqui você vê os limites de desvio. O desvio de saída mede a mudança na distribuição de confiabilidade do modelo O desvio de qualidade do modelo mede a queda na precisão comparando a precisão de tempo de execução estimada com a precisão de treinamento. O desvio de recurso mede a mudança na distribuição de valor para recursos importantes A configuração também mostra o número de recursos selecionados e os recursos mais importantes.Clique em Acessar resumo do modelo para retornar para a tela de detalhes do modelo
Na seção “Drift”, clique no ícone
“Detalhes” para visualizar os resultados detalhados do desvio do modelo. É possível visualizar o histórico de como cada pontuação de métrica muda ao longo do tempo com um gráfico de série temporal. Os valores inferiores são melhores, portanto, neste caso, os resultados estão acima dos limites superiores definidos na configuração. Em seguida, visualize detalhes sobre como a saída de pontuações e os desvios de recursos são calculados. Também é possível visualizar os detalhes sobre cada recurso para entender como eles contribuem para as pontuações geradas pelo Watson OpenScaleClique na trilha de navegação Implementação do modelo de aprovação de hipoteca para retornar à tela de detalhes do modelo.
Verifique seu progresso
A imagem a seguir mostra os detalhes do desvio em Watson OpenScale Agora que você observou o desvio do modelo, é possível observar a explicabilidade do modelo

Tarefa 8: Observe os monitores de modelo para explicabilidade
Para ter uma prévia desta tarefa, assista ao vídeo a partir dos 08:46.
Também é importante entender como o modelo chegou à sua decisão. Essa compreensão é necessária tanto para explicar as decisões às pessoas envolvidas na aprovação do empréstimo quanto para garantir ao proprietário do modelo que as decisões são válidas. Para compreender essas decisões, siga estas etapas para observar a explicabilidade do modelo:
No painel de navegação à esquerda, clique no ícone “Explicar uma transação ”.Selecione Implementação do Modelo de Aprovação de Hipoteca para ver uma lista de transações.
Para qualquer transação, clique em Explicar sob a coluna Ações. Aqui você vê a explicação detalhada desta decisão. É possível ver as variáveis de entrada mais importantes do modelo, bem como a importância de cada uma delas para o resultado final. Barras azuis representam entradas que tenderam a suportar a decisão do modelo, enquanto barras vermelhas mostram entradas que podem ter levado a outra decisão. Por exemplo, um candidato pode ter renda suficiente para ser aprovado de outra forma, mas seu histórico de crédito ruim e a alta dívida juntos levam o modelo a rejeitar o aplicativo. Analise esta explicação para se certificar dos fundamentos da decisão sobre o modelo.
(Opcional) Se desejar aprofundar mais sobre como o modelo tomou sua decisão, clique na guia Inspecionar . Use o recurso “Inspecionar” para analisar a decisão e identificar áreas de sensibilidade nas quais uma pequena alteração em alguns dados de entrada resultaria em uma decisão diferente; você mesmo pode testar a sensibilidade substituindo alguns dos dados de entrada reais por alternativas para verificar se isso afetaria o resultado.
Verifique seu progresso
A imagem a seguir mostra a explicação de uma transação no Watson OpenScale. Você determinou que o modelo é exato e trata todos os candidatos de forma justa.. Agora, você pode avançar o modelo para a próxima fase em seu ciclo de vida.

Próximas etapas
Experimente estes tutoriais adicionais para obter mais experiência prática com a construção e avaliação de modelos:
Recursos adicionais
- Visualizar mais vídeos.
- Visão geral do Cloud Pak for Data as a Service