Instale o Azure Machine Learning SDK para Python

Este artigo é um guia para diferentes opções de instalação para o SDK.


Instalação predefinido

Utilize azureml-core.

pip install azureml-core

Em seguida, instale quaisquer outros pacotes necessários para o seu trabalho particular.

Instalação de upgrade

Dica

Recomendamos que mantenha sempre o núcleo azureml atualizado para a versão mais recente.

Atualizar uma versão anterior:

pip install --upgrade azureml-core

Ver versão

Verifique a sua versão SDK:

pip show azureml-core

Para ver todos os pacotes no seu ambiente:

pip list

Também pode mostrar a versão SDK em Python, mas esta versão não inclui a versão menor.

import azureml.core
print(azureml.core.VERSION)

Para saber mais sobre como configurar o seu ambiente de desenvolvimento para Azure Machine Learning serviço, consulte configurar o seu ambiente de desenvolvimento.

Outros pacotes azureml

O SDK contém muitos outros pacotes opcionais que pode instalar. Estes incluem dependências que não são necessárias para todos os casos de uso, por isso não estão incluídas na instalação padrão de modo a evitar o inchaço do ambiente. O quadro seguinte descreve as embalagens ,as suas caixas de utilização e o comando para instalar, atualizar & verificação de versão.

 Pacote adicional  Caso de utilização Instalação/Versão de   upgrade/show                
azureml-automl-core Contém aulas de aprendizagem automática automatizada para Azure Machine Learning.
Este pacote é utilizado pelo azureml-train-automl-cliente e pelo tempo de funcionação azureml-train-automl.
pip install azureml-automl-core
pip install --upgrade azureml-automl-core
pip show azureml-automl-core
azureml-accel-models Acelera redes neuronais profundas em FPGAs com o Serviço de Modelos Acelerados de Hardware Azure ML. pip install azureml-accel-models
pip install --upgrade azureml-accel-models
pip show azureml-accel-models
azureml-train-automl Fornece aulas para construir e executar experiências automatizadas de aprendizagem automática de máquinas. Também instala pacotes comuns de ciência de pandas dados, incluindo, numpy e scikit-learn .

Se pretende submeter ML automatizada funciona num computação remota e não precisar de fazer qualquer ML localmente, recomendamos a utilização do cliente fino, azureml-train-automl-client pacote que faz parte do azureml-sdk .

Consulte a orientação adicional para o caso de utilização para obter mais informações sobre o trabalho com o automl SDK completo ou o seu cliente fino, azureml-train-automl-client .

Semelhante ao padrão Python, uma versão para trás e uma versão para a frente é suportada, mas apenas para o azureml-train-automl pacote completo. Por exemplo, se um modelo for treinado com a versão SDK 1.29.0, então pode inferência com versões SDK entre 1.28.0 e 1.30.0.
Para o ambiente conda local:
pip install azureml-train-automl
pip install --upgrade azureml-train-automl pip install show azureml-train-automl

Cliente fino para computação remota:
pip install azureml-train-automl-client
pip install --upgrade azureml-train-automl-client
pip install show azureml-train-automl-client
azureml-contrib Instala pacotes azureml-contrib-* que incluem funcionalidades experimentais ou funcionalidades de pré-visualização. pip install azureml-contrib
pip install --upgrade azureml-contrib
pip show azureml-contrib
azureml-datadrift Contém funcionalidade para detetar quando os dados de treino do modelo derivaram dos seus dados de pontuação. pip install azureml-datadrift
pip install --upgrade azureml-datadrift
pip show azureml-datadrift
azureml-interpret Usado para interpretação de modelos, incluindo característica e importância de classe para modelos blackbox e whitebox. pip azureml-interpret
pip install --upgrade azureml-interpret
pip show azureml-interpret
azureml-widgets Contém pacotes centrais, módulos e classes para Azure Machine Learning. pip install azureml-widgets
pip install --upgrade azureml-widgets
pip show azureml-widgets
azureml-contrib-services Fornece funcionalidade para marcar scripts para solicitar acesso HTTP bruto. pip install azureml-contrib-services
pip install --upgrade azureml-contrib-services
pip show azureml-contrib-services
azureml-tensorboard Fornece aulas e métodos para exportar experiências executar história e lançar o TensorBoard para visualizar o desempenho e estrutura da experiência. pip install azureml-tensorboard
pip install --upgrade azureml-tensorboard
pip show azureml-tensorboard
azureml-mlflow Contém funcionalidade que integra Azure Machine Learning com O MLFlow. pip install azureml-mlflow
pip install --upgrade azureml-mlflow
pip show azureml-mlflow
azureml-automl-runtime Contém aulas automatizadas de aprendizagem automática para executar corridas em Azure Machine Learning. pip install azureml-automl-runtime
pip install --upgrade azureml-automl-runtime
pip show azureml-automl-runtime
azureml-widgets Contém funcionalidade para ver o progresso da formação de machine learning em Cadernos Jupyter. pip install azureml-widgets
pip install --upgrade azureml-widgets
pip show azureml-widgets
azureml-train-restclients-hyperdrive Contém classes necessárias para criar HyperDriveRuns com azureml-train-core. pip install azureml-train-restclients-hyperdrive
pip install --upgrade azureml-train-restclients-hyperdrive
pip show azureml-train-restclients-hyperdrive
azureml-train-core Contém aulas de estimativas de base e a classe de estimadores genéricos , estimadores utilizados na formação da Deep Neural Network (DNN), estimadores utilizados na formação Scikit-Learn, módulos e classes de apoio à afinação do hiperparímetro. pip install azureml-core
pip install --upgrade azureml-core
pip show azureml-core
azureml-train-automl-runtime Contém funcionalidade que representa componentes de ML automatizados e de tempo de execução em Azure Machine Learning. pip install azureml-train-automl-runtime
pip install --upgrade azureml-train-automl-runtime
pip show azureml-train-automl-runtime
azureml-train-automl-client Contém pacotes centrais, módulos e classes para Azure Machine Learning. pip install azureml-train-automl-client
pip install --upgrade azureml-train-automl-client
pip show azureml-train-automl-client
azureml-train-automl Contém funcionalidade para encontrar automaticamente o melhor modelo de aprendizagem automática e seus parâmetros, dados de treinamento e dados de teste pip install azureml-train-automl
pip install --upgrade azureml-train-automl
pip show azureml-train-automl
azureml-telemetry Este pacote é utilizado para recolher dados de telemetria como mensagens de registo, métricas, eventos e mensagens de atividade. pip install azureml-telemetry
pip install --upgrade azureml-telemetry
pip show azureml-telemetry
azureml-synapse Contém comando Mágico para gerir a sessão de Sinapse e submeter código e widget SparkMonitor para monitorizar o progresso do trabalho de faísca, tanto para o Jupyter como para o JupyterLab pip install azureml-synapse
pip install --upgrade azureml-synapse
pip show azureml-synapse
azureml-sdk O pacote Thos é usado para construir e executar fluxos de trabalho de aprendizagem automática no serviço Azure Machine Learning pip install azureml-sdk
pip install --upgrade azureml-sdk
pip show azureml-sdk
azureml-pipeline-steps Contém passos pré-construídos que podem ser executados num pipeline Azure Machine Learning. pip install azureml-pipeline-steps
pip install --upgrade azureml-pipeline-steps
pip show azureml-pipeline-steps
azureml-pipeline-core Contém funcionalidade central para Azure Machine Learning oleodutos, que são fluxos de trabalho de aprendizagem de máquinas configuráveis. pip install azureml-pipeline-core
pip install --upgrade azureml-pipeline-core
pip show azureml-pipeline-core
azureml-pipeline Este pacote é usado para construir, otimizar e gerir fluxos de trabalho de aprendizagem automática pip install azureml-pipeline
pip install --upgrade azureml-pipeline
pip show azureml-pipeline
azureml-opendatasets Contém funcionalidade central para Azure Machine Learning oleodutos, que são fluxos de trabalho de aprendizagem de máquinas configuráveis. pip install azureml-opendatasets
pip install --upgrade azureml-opendatasets
pip show azureml-opendatasets
azureml-interpret Contém funcionalidade para trabalhar com a interpretação do modelo em Azure Machine Learning. pip install azureml-interpret
pip install --upgrade azureml-interpret
pip show azureml-interpret
azureml-defaults Este pacote é uma metapackage que é usada internamente por Azure Machine Learning. pip install azureml-defaults
pip install --upgrade azureml-defaults
pip show azureml-defaults
azureml-dataset-runtime O objetivo deste pacote é coordenar as dependências dentro dos pacotes AzureML. Esta embalagem é interna e não se destina a ser utilizada diretamente. pip install azureml-dataset-runtime
pip install --upgrade azureml-dataset-runtime
pip show azureml-dataset-runtime
azureml-datadrift Contém funcionalidade para detetar quando os dados de treino do modelo derivaram dos seus dados de pontuação. pip install azureml-datadrift
pip install --upgrade azureml-datadrift
pip show azureml-datadrift
azureml-contrib-server Este pacote é um serviço HTTP local utilizado para expor um subconjunto da funcionalidade fornecida pelo AzureML SDK a VS Tools for AI extensions (VSCode e Visual Studio) pip install azureml-contrib-server
pip install --upgrade azureml-contrib-server
pip show azureml-contrib-server
azureml-contrib-run Este pacote é utilizado para conter o código de integração da AzureML com o Mlflow. pip install azureml-core
pip install --upgrade azureml-core
pip show azureml-core
azureml-contrib-reinforcementlearning Contém funcionalidade para criar um alvo de computação Windows em Azure Machine Learning. pip install azureml-contrib-reinforcementlearning
pip install --upgrade azureml-contrib-reinforcementlearning
pip show azureml-contrib-reinforcementlearning
azureml-contrib-pipeline-steps Contém módulos e classes para etapas de pipeline Azure Machine Learning especializados e configuração associada. pip install azureml-contrib-pipeline-steps
pip install --upgrade azureml-contrib-pipeline-steps
pip show azureml-contrib-pipeline-steps
azureml-contrib-notebook Contém extensões para trabalhar com cadernos Jupyter em Azure Machine Learning. pip install azureml-contrib-notebook
pip install --upgrade azureml-contrib-notebook
pip show azureml-contrib-notebook
azureml-contrib-gbdt Este pacote contém o estimador LightGBM. pip install azureml-contrib-gbdt
pip install --upgrade azureml-contrib-gbdt
pip show azureml-contrib-gbdt
azureml-contrib-functions Contém funcionalidade para modelos de Azure Machine Learning de embalagem para implantação em Funções Azure. pip install azureml-contrib-functions
pip install --upgrade azureml-contrib-functions
pip show azureml-contrib-functions
azureml-contrib-fairness Este pacote apoia a utilização de dashboards de avaliação de equidade no Azure Machine Learning Studio pip install azureml-contrib-fairness
pip install --upgrade azureml-contrib-fairness
pip show azureml-contrib-fairness
azureml-contrib-dataset Contém funcionalidade especializada para trabalhar com objetos dataset em Azure Machine Learning. pip install azureml-contrib-dataset
pip install --upgrade azureml-contrib-dataset
pip show azureml-contrib-dataset
azureml-contrib-automl-pipeline-steps Contém passos pré-construídos que podem ser executados num pipeline Azure Machine Learning. pip install azureml-contrib-automl-pipeline-steps
pip install --upgrade azureml-contrib-automl-pipeline-steps
pip show azureml-contrib-automl-pipeline-steps
azureml-contrib-automl-dnn-vision Este pacote destina-se apenas a ser utilizado por scripts gerados pelo sistema AutoML. Para instalar em Windows, as embalagens "tocha" e "torchvision" devem ser instaladas separadamente antes desta embalagem. pip install azureml-contrib-automl-dnn-vision
pip install --upgrade azureml-contrib-automl-dnn-vision
pip show azureml-contrib-automl-dnn-vision
azureml-contrib-automl-dnn-forecasting Azure ML pacote comum de extensão CLI. Comum em todo o azure-cli-ml e azure-cli-ml-preview. pip install azureml-contrib-automl-dnn-forecasting
pip install --upgrade azureml-contrib-automl-dnn-forecasting
pip show azureml-contrib-automl-dnn-forecasting
azureml-contrib-aisc AzureML Contrib para AzureML AI Super Computer compute target. AISCCompute é uma infraestrutura computacional gerida da IA, que pode ser anexada a um espaço de trabalho por administração de cluster. pip install azureml-contrib-aisc
pip install --upgrade azureml-contrib-aisc
pip show azureml-contrib-aisc
azureml-cli-common Azure ML pacote comum de extensão CLI. Comum em todo o azure-cli-ml e azure-cli-ml-preview. pip install azureml-cli-common
pip install --upgrade azureml-cli-common
pip show azureml-cli-common
azureml-automl-dnn-nlp Este pacote destina-se apenas a ser utilizado por scripts gerados pelo sistema AutoML. pip install azureml-automl-dnn-nlp
pip install --upgrade azureml-automl-dnn-nlp
pip show azureml-automl-dnn-nlp
azureml-automl-core Contém passos pré-construídos que podem ser executados num pipeline Azure Machine Learning. pip install azureml-automl-core
pip install --upgrade azureml-automl-core
pip show azureml-automl-core
azureml-accel-models Acelere as redes neuronais profundas em FPGAs com o Serviço de Modelos Acelerados de Hardware Azure ML. pip install azureml-accel-models
pip install --upgrade azureml-accel-models
pip show azureml-accel-models
azureml-inference-server-http Este pacote permite o desenvolvimento local, integração DE CI/CD, Rotas do Servidor. pip install azureml-inference-server-http
pip install --upgrade azureml-inference-server-http
pip show azureml-inference-server-http
azure-ml-component Este pacote contém funcionalidade para a autoria e gestão de componentes Azure Machine Learning autoria e submissão de gasodutos utilizando componentes pip install azure-ml-component
pip install --upgrade azure-ml-component
pip show azure-ml-component
azureml-pipeline-wrapper Este pacote contém funcionalidade para autoria e gestão de módulos Azure Machine Learning, autoria e submissão de oleodutos utilizando módulos pip install azureml-pipeline-wrapper
pip install --upgrade azureml-pipeline-wrapper
pip show azureml-pipeline-wrapper
azureml-designer-cv-modules Módulos para pré-processar e transformar imagens como para plantar, pad ou redimensionar. pip install azureml-designer-cv-modules
pip install --upgrade azureml-designer-cv-modules
pip show azureml-designer-cv-modules
azureml-designer-pytorch-modules Módulos para treinar e inferência modelos de classificação de imagem com base na estrutura do pytorch. pip install azureml-designer-pytorch-modules
pip install --upgrade azureml-designer-pytorch-modules
pip show azureml-designer-pytorch-modules
azureml-designer-vowpal-wabbit-modules Módulos para treinar e inferências modelos baseados na estrutura Vowpal Wabbit. pip install azureml-designer-vowpal-wabbit-modules
pip install --upgrade azureml-designer-vowpal-wabbit-modules
pip show azureml-designer-vowpal-wabbit-modules
azureml-designer-classic-modules Uma variedade de módulos para processamento de dados, formação de modelos, inferenculação e avaliação. pip install azureml-designer-classic-modules
pip install --upgrade azureml-designer-classic-modules
pip show azureml-designer-classic-modules
azureml-designer-recommender-modules Módulos para treinar e inferência modelos de recomendação baseados em rede neural profunda. pip install azureml-designer-recommender-modules
pip install --upgrade azureml-designer-recommender-modules
pip show azureml-designer-recommender-modules
azureml-designer-internal Funcionalidades internas fornecidas para módulos incorporados. pip install azureml-designer-internal
pip install --upgrade azureml-designer-internal
pip show azureml-designer-internal
azureml-designer-core Funcionalidades centrais para definição de tipo de dados, io de dados e funções frequentemente utilizadas. pip install azureml-designer-core
pip install --upgrade azureml-designer-core
pip show azureml-designer-core
azureml-designer-datatransform-modules Módulos para transformar conjunto de dados, tais como aplicando operações matemáticas, consultas de sql, clipping outliers ou gerando um relatório estatístico. pip install azureml-designer-datatransform-modules
pip install --upgrade azureml-designer-datatransform-modules
pip show azureml-designer-datatransform-modules
azureml-designer-dataio-modules Módulos para carregar dados em designer de aprendizagem de máquinas azul e escrever dados para armazenamento baseado na nuvem. pip install azureml-designer-dataio-modules
pip install --upgrade azureml-designer-dataio-modules
pip show azureml-designer-dataio-modules
azureml-designer-serving Forneça funcionalidades para invocar módulos incorporados no serviço de implementação. pip install azureml-designer-serving
pip install --upgrade azureml-designer-serving
pip show azureml-designer-serving
azureml-contrib-datadrift Contém funcionalidade para deteção de deriva de dados para vários conjuntos de dados utilizados na aprendizagem automática, incluindo conjuntos de dados de formação e conjunto de dados de pontuação. pip install azureml-contrib-datadrift
pip install --upgrade azureml-contrib-datadrift
pip show azureml-contrib-datadrift
azureml-contrib-explain-model Contém funcionalidade experimental para o pacote azureml-explain-model, que oferece uma variedade de serviços para a interpretação do modelo de aprendizagem automática. pip install azureml-contrib-explain-model
pip install --upgrade azureml-contrib-explain-model
pip show azureml-contrib-explain-model
azureml-contrib-opendatasets Este pacote fornece um conjunto de APIs para consumir Azure Open Datasets. pip install azureml-contrib-opendatasets
pip install --upgrade azureml-contrib-opendatasets
pip show azureml-contrib-opendatasets
azureml-train-widgets Contém widgets para os Cadernos Jupyter para rastrear visualmente as suas corridas. pip install azureml-train-widgets
pip install --upgrade azureml-train-widgets
pip show azureml-train-widgets

Para obter mais detalhes sobre os pacotes acima, consulte a AzureML em pypi.

Orientação adicional do caso de utilização

Se a sua caixa de utilização for descrita abaixo, observe as orientações e quaisquer ações recomendadas.

Caso de utilização Orientação
Utilização automl  Instale o azureml-train-automl SDK completo num novo ambiente Python de 64 bits. É necessário um novo ambiente de 64 bits devido à dependência do quadro LightGBM. Este pacote instala e fixa versões específicas de pacotes de ciência de dados para compatibilidade, o que requer um ambiente limpo.

O cliente azureml-train-automl-client fino, o pacote não instala pacotes adicionais de ciência de dados ou requer um ambiente python limpo. Recomendamos azureml-train-automl-client que se apenas precisar de submeter ML automatizada para um computação remota, e não precisar de submeter corridas locais ou descarregar o seu modelo localmente.

Uma versão ao contrário e uma versão para a frente só é suportada para modelos treinados com o azureml-train-automl pacote completo. Por exemplo, se um modelo for treinado com a versão SDK 1.29.0, então pode inferência com versões SDK entre 1.28.0 e 1.30.0.
Usando databricks Azure No ambiente Azure Databricks, utilize as fontes da biblioteca detalhadas neste guia para instalar o SDK. Consulte também estas dicas para obter mais informações sobre o trabalho com Azure Machine Learning SDK for Python em Azure Databricks.
Usando a máquina virtual da Azure Data Science Azure Data Science Virtual Machines criado após 27 de setembro de 2018 vem com o Python SDK pré-instalado.
Máquina Azure executando     Aprendizagem   tutoriais ou cadernos Se estiver a utilizar uma versão mais antiga do SDK do que a mencionada no tutorial ou no caderno, deverá atualizar o seu SDK. Algumas funcionalidades nos tutoriais e cadernos podem exigir pacotes python adicionais, tais matplotlib scikit-learn como, ou pandas . Instruções em cada tutorial e caderno mostrar-lhe-ão quais as embalagens necessárias.

Resolução de problemas

  • Instalação pip: As dependências não são garantidas para serem consistentes com a instalação de linha única:

    Esta é uma limitação conhecida do pip, uma vez que não tem uma dependência funcional quando se instala como uma única linha. A primeira dependência única é a única que olha.

    No código seguinte azureml-datadrift e azureml-train-automl ambos são instalados utilizando uma instalação de pip de linha única.

      pip install azureml-datadrift, azureml-train-automl
    

    Para este exemplo, digamos que azureml-datadrift requer versão > 1.0 e azureml-train-automl requer versão < 1.2. Se a versão mais recente azureml-datadrift for 1.3, então ambos os pacotes serão atualizados para 1.3, independentemente da exigência do azureml-train-automl pacote para uma versão mais antiga.

    Para garantir que as versões apropriadas são instaladas para as suas embalagens, instale usando várias linhas como no código seguinte. A ordem não é um problema aqui, uma vez que pip explicitamente desvaloriza como parte da próxima chamada de linha. E assim, as dependências de versão apropriadas são aplicadas.

       pip install azureml-datadrift
       pip install azureml-train-automl 
    
  • Pacote de explicação não garantido para ser instalado ao instalar o azureml-train-automl-cliente:

    Ao executar uma execução remota de AutoML com a explicação do modelo ativada, verá uma mensagem de erro "Por favor instale o pacote azureml-explain-model para explicações do modelo." Este é um problema conhecido. Como uma solução alternativa siga um dos passos abaixo:

    1. Instale localmente o modelo azureml-explain-explain.
        pip install azureml-explain-model
    
    1. Desative totalmente a função de explicação passando model_explainability=Falso na configuração AutoML.
        automl_config = AutoMLConfig(task = 'classification',
                               path = '.',
                               debug_log = 'automated_ml_errors.log',
                               compute_target = compute_target,
                               run_configuration = aml_run_config,
                               featurization = 'auto',
                               model_explainability=False,
                               training_data = prepped_data,
                               label_column_name = 'Survived',
                               **automl_settings)
    
  • Erros panda: Tipicamente vistos durante a Experiência AutoML:

    Ao configurar manualmente o seu ambiente utilizando pip, poderá notar erros (especialmente dos pandas) devido à instalação de versões de pacote não suportadas.

    Por exemplo, ModuleNotFoundError: No module named 'pandas.core.internals.managers'; 'pandas.core.internals' is not a package

    Para evitar tais erros, instale o AutoML SDK utilizando o automl_setup.cmd:

    1. Abra um pedido de Anaconda e clone o repositório GitHub para um conjunto de cadernos de amostras.
    git clone https://github.com/Azure/MachineLearningNotebooks.git
    
    1. cd para a pasta de como usar-azureml/automatizada-aprendizagem de máquinas onde os cadernos de amostra foram extraídos e depois executados:
    automl_setup
    
  • KeyError: 'marca' ao executar AutoML em computação local ou cluster Azure Databricks

    Se um novo ambiente for criado após 10 de junho de 2020, utilizando o SDK 1.7.0 ou mais cedo, o treino poderá falhar com este erro devido a uma atualização no pacote py-cpuinfo. (Ambientes criados em ou antes de 10 de junho de 2020, não são afetados, assim como as experiências executadas em computação remota porque são usadas imagens de treino em cache.) Para contornar esta questão, tome um dos dois passos seguintes:

    • Atualizar a versão SDK para 1.8.0 ou mais tarde (isto também reduz py-cpuinfo para 5.0.0):

      pip install --upgrade azureml-sdk[automl]
      
    • Desclasse a versão instalada do py-cpuinfo para 5.0.0:

      pip install py-cpuinfo==5.0.0
      
  • Error message: Can't desinstalar 'PyYAML'

    Azure Machine Learning SDK for Python: PyYAML é um distutils projeto instalado. Portanto, não podemos determinar com precisão quais os ficheiros que lhe pertencem se houver uma desinstalação parcial. Para continuar a instalar o SDK ignorando este erro, utilize:

    pip install --upgrade azureml-sdk[notebooks,automl] --ignore-installed PyYAML
    
  • Azure Machine Learning Instalação SDK falhando com uma exceção: MóduloNotFoundError: Nenhum módulo chamado 'ruamel' ou 'ImportError: Nenhum módulo chamado ruamel.yaml'

    Esta questão está a ser encontrada com a instalação de Azure Machine Learning SDK para Python no mais recente pip (>20.1.1) no ambiente base da Conda para todas as versões lançadas de Azure Machine Learning SDK para Python. Consulte as seguintes soluções:

    • Evite instalar o Python SDK no ambiente de base conda, antes crie o seu ambiente conda e instale o SDK nesse ambiente de utilizador recém-criado. O último pip deve trabalhar naquele novo ambiente conda.

    • Para criar imagens em estivador, onde não é possível desligar do ambiente base conda, por favor pin pip pip<=20.1.1 no ficheiro estivador.

    conda install -c r -y conda python=3.6.2 pip=20.1.1
    

Passos seguintes

Experimente estes próximos passos para aprender a usar o serviço de Azure Machine Learning SDK para Python:

  1. Leia a visão geral da Azure Machine Learnin Python SDK para aprender sobre as aulas-chave e padrões de design com amostras de código.
  2. Siga Azure Machine Learning tutorial de Introdução Python para começar a criar experiências e modelos.