Azure AI Generative Package-klientbibliotek för Python – version 1.0.0b2

Artikel
12/01/2023

Azure AI Generative-paketet är en del av Azure AI SDK för Python och innehåller funktioner för att skapa, utvärdera och distribuera Generative AI-program som utnyttjar Azure AI-tjänster. Standardinstallationen av paketet innehåller funktioner för molnanslutna scenarier, och genom att installera extrafunktioner kan du även köra åtgärder lokalt (till exempel skapa index och beräkna mått).

| KällkodPaket (PyPI) | API-referensdokumentation | Produktdokumentation | [Exempel] [ml_samples]

Det här paketet har testats med Python 3.7, 3.8, 3.9 och 3.10.

En mer fullständig uppsättning Azure-bibliotek finns i https://aka.ms/azsdk/python/all.

Komma igång

Förutsättningar

Python 3.7 eller senare krävs för att använda det här paketet.
Du måste ha en Azure-prenumeration.
En Azure Machine Learning-arbetsyta.

Installera paketet

Installera det generativa Azure AI-paketet för Python med pip:

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

Viktiga begrepp

Syntaxen [index,evaluate,promptflow] anger extra paket som du kan ta bort om du inte behöver funktionen:

[index] lägger till möjligheten att skapa index i din lokala utvecklingsmiljö
[evaluate] lägger till möjligheten att köra utvärdering och beräkna mått i din lokala utvecklingsmiljö
[promptflow] lägger till möjligheten att utveckla med promptflöde som är anslutet till ditt Azure AI-projekt

Användning

Ansluta till projekt

Det generativa paketet innehåller paketet azure-ai-resources och använder AIClient för att ansluta till projektet.

Skapa först en 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'
)

Använda det generativa paketet

Azure AI Generative Python SDK erbjuder följande viktiga funktioner.

Om du vill skapa ett index lokalt importerar du funktionen build_index:

from azure.ai.generative.index import build_index

Om du vill köra en lokal utvärdering importerar du funktionen evaluate:

from azure.ai.generative.evaluate import evaluate

Om du vill distribuera chattfunktioner och promptflöden importerar du distributionsfunktionen:

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

Exempelanvändning av dessa finns i det här exemplet

Exempel

I vår exempellagringsplats finns exempel på hur du använder Azure AI Generative Python SDK.

Felsökning

Allmänt

Azure AI-klienter genererar undantag som definierats i 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))

Loggning

Det här biblioteket använder standardloggningsbiblioteket för loggning. Grundläggande information om HTTP-sessioner (URL:er, rubriker osv.) loggas på INFO-nivå.

Detaljerad loggning på FELSÖKNINGsnivå, inklusive begärande-/svarskroppar och oredigerade huvuden, kan aktiveras på en klient med logging_enable argumentet .

Se fullständig SDK-loggningsdokumentation med exempel här.

Telemetri

Azure AI Generative Python SDK innehåller en telemetrifunktion som samlar in användnings- och feldata om SDK:n och skickar den till Microsoft när du endast använder SDK:n i en Jupyter Notebook. Telemetri samlas inte in för användning av Python SDK utanför en Jupyter Notebook.

Telemetridata hjälper SDK-teamet att förstå hur SDK:n används så att den kan förbättras och informationen om fel hjälper teamet att lösa problem och åtgärda buggar. SDK-telemetrifunktionen är aktiverad som standard för Jupyter Notebook användning och kan inte aktiveras för icke-Jupyter-scenarier. Om du vill välja bort telemetrifunktionen i ett Jupyter-scenario ställer du in miljövariabeln "AZURE_AI_GENERATIVE_ENABLE_LOGGING" på "False".

Nästa steg