Azure AI Generative Package-klientbibliotek för Python – version 1.0.0b2
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
I vår exempellagringsplats finns exempel på hur du använder Azure AI Generative Python SDK.
Bidra
Om du stöter på buggar eller har förslag kan du skicka in ett problem i avsnittet Problem i projektet.
Azure SDK for Python
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för