Клиентская библиотека azure AI Generative Package для Python версии 1.0.0b2

Статья
12/06/2023

Пакет Azure AI Generative является частью пакета SDK azure AI для Python и содержит функциональные возможности для создания, оценки и развертывания приложений сгенерируемым ИИ, использующих службы ИИ Azure. Установка пакета по умолчанию содержит возможности для сценариев, подключенных к облаку, и путем установки дополнительных компонентов можно также выполнять операции локально (например, создание индексов и вычисление метрик).

Исходный код | Пакет (PyPI) | Справочная документация по | APIДокументация по продукту | [Примеры] [ml_samples]

Этот пакет протестирован с python 3.7, 3.8, 3.9 и 3.10.

Более полный набор библиотек Azure см. в разделе https://aka.ms/azsdk/python/all.

Начало работы

Предварительные требования

Для использования этого пакета требуется Python 3.7 или более поздней версии.
У вас должна быть подписка Azure.
Рабочая область Машинного обучения Azure.

Установка пакета

Установите пакет создания ИИ Azure для Python с помощью pip:

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

Основные понятия

Синтаксис [index,evaluate,promptflow] указывает дополнительные пакеты, которые при необходимости можно удалить, если вам не нужна функциональность:

[index] добавляет возможность создавать индексы в локальной среде разработки.
[evaluate] добавлена возможность выполнять оценку и вычислять метрики в локальной среде разработки.
[promptflow] добавляет возможность разработки с помощью потока запроса, подключенного к проекту ИИ Azure.

Использование

Подключение к проектам

Генерирующий пакет включает пакет azure-ai-resources и использует AIClient для подключения к проекту.

Сначала создайте 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'
)

Использование генерирующего пакета

Пакет SDK azure AI для Python generative предлагает следующие ключевые возможности.

Чтобы создать индекс локально, импортируйте функцию build_index:

from azure.ai.generative.index import build_index

Чтобы выполнить локальную оценку, импортируйте функцию evaluate:

from azure.ai.generative.evaluate import evaluate

Чтобы развернуть функции чата и потоки запросов, импортируйте функцию deploy:

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

Примеры использования см. в этом примере.

Примеры

В нашем репозитории примеров приведены примеры использования пакета SDK azure AI Generative Python.

Устранение неполадок

Общие сведения

Клиенты ИИ Azure вызывают исключения, определенные в 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))

Ведение журнала

Эта библиотека использует для ведения журнала соответствующую стандартную библиотеку. Основные сведения о сеансах HTTP (URL-адреса, заголовки и т. д.) регистрируются на уровне INFO.

Подробное ведение журнала на уровне DEBUG, включая тексты запросов и ответов и нередактированные заголовки, можно включить на клиенте с помощью аргумента logging_enable .

См. полную документацию по ведению журнала пакета SDK с примерами здесь.

Телеметрия

Пакет SDK azure AI Generative Python включает функцию телеметрии, которая собирает данные об использовании и сбоях пакета SDK и отправляет их в корпорацию Майкрософт при использовании пакета SDK только в Jupyter Notebook. Данные телеметрии не будут собираться для любого использования пакета SDK для Python за пределами Jupyter Notebook.

Данные телеметрии помогают команде sdk понять, как используется пакет SDK, чтобы его можно было улучшить, а сведения о сбоях помогают команде устранять проблемы и устранять ошибки. Функция телеметрии пакета SDK включена по умолчанию для Jupyter Notebook использования и не может быть включена для сценариев, отличных от Jupyter. Чтобы отказаться от функции телеметрии в сценарии Jupyter, задайте для переменной "AZURE_AI_GENERATIVE_ENABLE_LOGGING" среды значение "False".

Дальнейшие действия