Biblioteca cliente del paquete de recursos de Azure AI para Python: versión 1.0.0b2

Artículo
12/01/2023

El paquete de recursos de Azure AI forma parte del SDK de Azure AI para Python y contiene funcionalidades para conectarse a los recursos y proyectos de Azure AI y administrarlos. Dentro de los proyectos de Azure AI, proporciona operaciones del plano de control para crear y administrar datos, índices, modelos e implementaciones.

Código | fuentePaquete (PyPI) | Documentación | de referencia de API Documentación del producto | [Ejemplos] [ml_samples]

Este paquete se ha probado con Python 3.7, 3.8, 3.9 y 3.10.

Para obtener un conjunto más completo de bibliotecas de Azure, consulte https://aka.ms/azsdk/python/all.

Introducción

Requisitos previos

Se requiere Python 3.7 o posterior para usar este paquete.
Debe tener una suscripción de Azure.
Un área de trabajo de Azure Machine Learning.

Instalar el paquete

Instale el paquete generativo de Azure AI para Python con pip:

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

Autenticar el 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')

Conceptos clave

Use esta biblioteca en los proyectos de Azure AI para proporcionar operaciones de plano de control para crear y administrar datos, índices, modelos e implementaciones.

Ejemplos

Consulte nuestro repositorio de ejemplos en GitHub para ver ejemplos que muestran cómo usar el SDK de Python generative de Azure AI.

Solución de problemas

General

Los clientes de Azure AI generan excepciones definidas en 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))

Registro

Esta biblioteca usa la biblioteca de registro estándar para el registro. La información básica sobre las sesiones HTTP (direcciones URL, encabezados, etc.) se registra en el nivel INFO.

El registro detallado de nivel DEBUG, incluidos los cuerpos de solicitud/respuesta y los encabezados no aprobados, se puede habilitar en un cliente con el logging_enable argumento .

Consulte la documentación completa del registro del SDK con ejemplos aquí.

Telemetría

El SDK de Python generative de Azure AI incluye una característica de telemetría que recopila datos de uso y errores sobre el SDK y los envía a Microsoft cuando se usa el SDK solo en un Jupyter Notebook. La telemetría no se recopilará para ningún uso del SDK de Python fuera de un Jupyter Notebook.

Los datos de telemetría ayudan al equipo del SDK a comprender cómo se usa el SDK para que se pueda mejorar y la información sobre los errores ayuda al equipo a resolver problemas y corregir errores. La característica de telemetría del SDK está habilitada de forma predeterminada para Jupyter Notebook uso y no se puede habilitar para escenarios que no son de Jupyter. Para no participar en la característica de telemetría en un escenario de Jupyter, establezca la variable "AZURE_AI_RESOURCES_ENABLE_LOGGING""False"de entorno en .

Pasos siguientes