Bibliothèque cliente de package génératif Azure AI pour Python - version 1.0.0b2

Article
12/06/2023

Le package Azure AI Generative fait partie du Kit de développement logiciel (SDK) Azure AI pour Python et contient des fonctionnalités permettant de créer, d’évaluer et de déployer des applications d’IA générative qui tirent parti des services Azure AI. L’installation par défaut du package contient des fonctionnalités pour les scénarios connectés au cloud, et en installant des extras, vous pouvez également exécuter des opérations localement (telles que la création d’index et le calcul des métriques).

| Code source Package (PyPI) | Documentation de référence sur les | APIDocumentation produit | [Exemples] [ml_samples]

Ce package a été testé avec Python 3.7, 3.8, 3.9 et 3.10.

Pour obtenir un ensemble plus complet de bibliothèques Azure, consultez https://aka.ms/azsdk/python/all.

Prise en main

Prérequis

Python 3.7 ou version ultérieure est requis pour utiliser ce package.
Vous devez disposer d’un abonnement Azure.
Un espace de travail Azure Machine Learning.

Installer le package

Installez le package génératif Azure AI pour Python avec pip :

pip install azure-ai-generative[index,evaluate,promptflow]
pip install azure-identity

Concepts clés

La [index,evaluate,promptflow] syntaxe spécifie des packages supplémentaires que vous pouvez éventuellement supprimer si vous n’avez pas besoin de la fonctionnalité :

[index] ajoute la possibilité de créer des index sur votre environnement de développement local
[evaluate] ajoute la possibilité d’exécuter l’évaluation et de calculer des métriques dans votre environnement de développement local
[promptflow] ajoute la possibilité de développer avec un flux d’invite connecté à votre projet Azure AI

Utilisation

Connexion à des projets

Le package génératif inclut le package azure-ai-resources et utilise le AIClient pour se connecter à votre projet.

Tout d’abord, créez un AI Client:

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

Utilisation du package génératif

Le Kit de développement logiciel (SDK) Python génératif Azure AI offre les fonctionnalités clés suivantes.

Pour créer un index localement, importez la fonction build_index :

from azure.ai.generative.index import build_index

Pour exécuter une évaluation locale, importez la fonction d’évaluation :

from azure.ai.generative.evaluate import evaluate

Pour déployer des fonctions de conversation et des flux d’invite, importez la fonction de déploiement :

from azure.ai.resources.entities.deployment import Deployment

Pour obtenir des exemples d’utilisation de ceux-ci, reportez-vous à cet exemple.

Exemples

Consultez notre référentiel d’exemples pour obtenir des exemples d’utilisation du Kit de développement logiciel (SDK) Python génératif Azure AI.

Dépannage

Général

Les clients Azure AI lèvent des exceptions définies dans 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))

Journalisation

Cette bibliothèque utilise la bibliothèque de journalisation standard pour la journalisation. Les informations de base sur les sessions HTTP (URL, en-têtes, etc.) sont enregistrées au niveau INFO.

La journalisation détaillée au niveau DEBUG, y compris les corps de requête/réponse et les en-têtes non expurgés, peut être activée sur un client avec l’argument logging_enable .

Consultez la documentation complète sur la journalisation du KIT de développement logiciel (SDK) avec des exemples ici.

Télémétrie

Le Kit de développement logiciel (SDK) Python génératif Azure AI inclut une fonctionnalité de télémétrie qui collecte les données d’utilisation et d’échec sur le KIT de développement logiciel (SDK) et les envoie à Microsoft lorsque vous utilisez le Kit de développement logiciel (SDK) dans un Jupyter Notebook uniquement. Les données de télémétrie ne sont pas collectées pour une utilisation du KIT de développement logiciel (SDK) Python en dehors d’un Jupyter Notebook.

Les données de télémétrie aident l’équipe du Kit de développement logiciel (SDK) à comprendre comment le KIT de développement logiciel (SDK) est utilisé afin qu’il puisse être amélioré et que les informations sur les échecs aident l’équipe à résoudre les problèmes et à résoudre les bogues. La fonctionnalité de télémétrie du KIT de développement logiciel (SDK) est activée par défaut pour Jupyter Notebook utilisation et ne peut pas l’être pour les scénarios autres que Jupyter. Pour désactiver la fonctionnalité de télémétrie dans un scénario Jupyter, définissez la variable "AZURE_AI_GENERATIVE_ENABLE_LOGGING" d’environnement sur "False".

Étapes suivantes