Biblioteca de cliente do Pacote de Recursos de IA do Azure para Python – versão 1.0.0b2

Artigo
12/01/2023

O pacote recursos do Azure AI faz parte do SDK do Azure AI para Python e contém funcionalidades para ligar e gerir os seus recursos e projetos de IA do Azure. Nos seus projetos de IA do Azure, fornece operações de plano de controlo para criar e gerir dados, índices, modelos e implementações.

Código fonte | Pacote (PyPI) | Documentação | de referência da API Documentação do produto | [Exemplos] [ml_samples]

Este pacote foi testado com Python 3.7, 3.8, 3.9 e 3.10.

Para obter um conjunto mais completo de bibliotecas do Azure, consulte https://aka.ms/azsdk/python/all.

Introdução

Pré-requisitos

O Python 3.7 ou posterior é necessário para utilizar este pacote.
Tem de ter uma subscrição do Azure.
Uma Área de Trabalho do Azure Machine Learning.

Instalar o pacote

Instale o pacote gerador de IA do Azure para Python com pip:

pip install azure-ai-resources
pip install azure-identity

Autenticar o cliente

from azure.ai.resources.client import AIClient
from azure.identity import DefaultAzureCredential

ai_client = AIClient(credential=DefaultAzureCredential(), subscription_id='subscription_id',
                     resource_group_name='resource_group', project_name='project_name')

Conceitos-chave

Utilize esta biblioteca nos seus projetos de IA do Azure para fornecer operações de plano de controlo para criar e gerir dados, índices, modelos e implementações.

Exemplos

Veja o nosso repositório de exemplos no GitHub para obter exemplos que demonstram como utilizar o SDK Python Gerador do Azure AI.

Resolução de problemas

Geral

Os clientes de IA do Azure geram exceções definidas no Azure Core.

from azure.core.exceptions import HttpResponseError

try:
    ai_client.compute.get("cpu-cluster")
except HttpResponseError as error:
    print("Request failed: {}".format(error.message))

Registo

Esta biblioteca utiliza a biblioteca de registos padrão para registos. As informações básicas sobre as sessões HTTP (URLs, cabeçalhos, etc.) são registadas ao nível da INFORMAÇÃO.

O registo ao nível de DEBUG detalhado, incluindo os corpos de pedido/resposta e os cabeçalhos não retotados, pode ser ativado num cliente com o logging_enable argumento .

Veja a documentação completa do registo do SDK com exemplos aqui.

Telemetria

O SDK Python Gerador do Azure AI inclui uma funcionalidade de telemetria que recolhe dados de utilização e falha sobre o SDK e envia-os para a Microsoft quando utiliza o SDK apenas numa Jupyter Notebook. A telemetria não será recolhida para qualquer utilização do SDK Python fora de um Jupyter Notebook.

Os dados de telemetria ajudam a equipa do SDK a compreender como o SDK é utilizado para que possa ser melhorado e as informações sobre falhas ajudam a equipa a resolver problemas e a corrigir erros. A funcionalidade de telemetria do SDK está ativada por predefinição para Jupyter Notebook utilização e não pode ser ativada para cenários não Jupyter. Para optar ativamente por não participar na funcionalidade de telemetria num cenário do Jupyter, defina a variável "AZURE_AI_RESOURCES_ENABLE_LOGGING" de ambiente como "False".

Passos seguintes