Sdílet prostřednictvím

Klientská knihovna azure AI Generative Package pro Python – verze 1.0.0b2

  • Článek

Balíček Azure AI Generative je součástí sady Azure AI SDK pro Python a obsahuje funkce pro sestavování, vyhodnocování a nasazování aplikací generativní AI, které využívají služby Azure AI. Výchozí instalace balíčku obsahuje možnosti pro scénáře s připojením ke cloudu a instalací doplňků můžete také spouštět operace místně (například vytváření indexů a výpočet metrik).

Zdrojový kód | Balíček (PyPI) | Referenční dokumentace k | rozhraní APIDokumentace k produktu | [Ukázky] [ml_samples]

Tento balíček byl testován s Pythonem 3.7, 3.8, 3.9 a 3.10.

Podrobnější sadu knihoven Azure najdete v tématu https://aka.ms/azsdk/python/all.

Začínáme

Požadavky

Instalace balíčku

Nainstalujte balíček Generative Azure AI pro Python pomocí pip:

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

Klíčové koncepty

Syntaxe [index,evaluate,promptflow] určuje dodatečné balíčky, které můžete volitelně odebrat, pokud tuto funkci nepotřebujete:

  • [index] přidává možnost vytvářet indexy v místním vývojovém prostředí.
  • [evaluate] Přidává možnost spouštět vyhodnocení a počítat metriky v místním vývojovém prostředí.
  • [promptflow] přidává možnost vývoje s využitím toku výzvy připojeného k projektu Azure AI.

Využití

Připojení k projektům

Generativní balíček obsahuje balíček azure-ai-resources a pro připojení k vašemu AIClient projektu používá .

Nejprve vytvořte 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'
)

Použití generativního balíčku

Sada Azure AI Generative Python SDK nabízí následující klíčové funkce.

Pokud chcete vytvořit index místně, naimportujte funkci build_index:

from azure.ai.generative.index import build_index

Pokud chcete spustit místní vyhodnocení, naimportujte funkci evaluate:

from azure.ai.generative.evaluate import evaluate

Pokud chcete nasadit funkce chatu a toky výzvy, naimportujte funkci deploy:

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

Informace o ukázkovém použití najdete v této ukázce.

Příklady

Příklady použití sady Azure AI Generative Python SDK najdete v našem úložišti ukázek .

Řešení potíží

Obecné

Klienti Azure AI vyvolávají výjimky definované v 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))

protokolování

Tato knihovna používá k protokolování standardní knihovnu protokolování. Základní informace o relacích HTTP (adresy URL, hlavičky atd.) se protokolují na úrovni INFO.

U klienta logging_enable s argumentem je možné povolit podrobné protokolování úrovně DEBUG, včetně těl požadavků/odpovědí a nezopravovaných hlaviček.

Kompletní dokumentaci k protokolování sady SDK s příklady najdete tady.

Telemetrie

Sada Azure AI Generative Python SDK obsahuje funkci telemetrie, která shromažďuje data o využití a selhání sady SDK a odesílá je do Microsoftu, když sadu SDK použijete pouze v Jupyter Notebook. Telemetrie se nebude shromažďovat pro jakékoli použití sady Python SDK mimo Jupyter Notebook.

Telemetrická data pomáhají týmu sady SDK pochopit, jak se sada SDK používá, aby bylo možné ji vylepšit, a informace o chybách pomáhají týmu řešit problémy a opravovat chyby. Funkce telemetrie sady SDK je ve výchozím nastavení povolená pro Jupyter Notebook využití a nedá se povolit ve scénářích bez Jupyteru. Pokud se chcete odhlásit z funkce telemetrie ve scénáři Jupyter, nastavte proměnnou "AZURE_AI_GENERATIVE_ENABLE_LOGGING" prostředí na "False".

Další kroky

Příklady použití sady Azure AI Generative Python SDK najdete v našem úložišti ukázek .

Přispívání

Pokud narazíte na nějaké chyby nebo máte návrhy, nahlaste problém v části Problémy projektu.

Imprese