Promptflow Azure

1.18.5 verified Fri May 01 auth: no python

Promptflow Azure is the Azure integration package for Microsoft Promptflow, enabling creation, management, and execution of prompt flows on Azure AI services. Version 1.18.5 (current). Releases occur irregularly.

pip install promptflow-azure

Common errors

error ImportError: cannot import name 'AzureOpenAIModelConfiguration' from 'promptflow.azure' ↓

cause AzureOpenAIModelConfiguration moved to promptflow.core in version 1.17.0.

fix

Change import to: from promptflow.core import AzureOpenAIModelConfiguration

error ModuleNotFoundError: No module named 'promptflow.azure' ↓

cause The promptflow.azure subpackage was removed in promptflow 1.17.0.

fix

Install promptflow-azure and use imports from promptflow.core or promptflow.connections instead.

Warnings

breaking In promptflow 1.17.0, the 'promptflow.azure' subpackage was removed; all Azure-specific classes moved to 'promptflow.core' or 'promptflow.connections'. ↓

fix Update imports: from promptflow.azure import AzureOpenAIModelConfiguration -> from promptflow.core import AzureOpenAIModelConfiguration

deprecated The 'promptflow.connections.AzureOpenAIConnection' is deprecated in favor of direct model configuration using AzureOpenAIModelConfiguration. ↓

fix Use AzureOpenAIModelConfiguration from promptflow.core instead.

gotcha The package 'promptflow-azure' is a separate package that must be installed alongside 'promptflow'; it does not contain the core classes but provides Azure-specific tooling and integrations. ↓

fix Always install both: pip install promptflow promptflow-azure

Imports

AzureOpenAIConnection
wrong
```
from promptflow_azure import AzureOpenAIConnection
```
correct
```
from promptflow.connections import AzureOpenAIConnection
```
Incorrect import path; AzureOpenAIConnection is in promptflow.connections, not promptflow_azure.

Quickstart

Create an Azure OpenAI model configuration using environment variables.

from promptflow.core import AzureOpenAIModelConfiguration
import os

config = AzureOpenAIModelConfiguration(
    azure_endpoint=os.environ.get('AZURE_OPENAI_ENDPOINT', ''),
    api_key=os.environ.get('AZURE_OPENAI_API_KEY', ''),
    api_version="2023-05-15",
    azure_deployment="gpt-35-turbo"
)
print("Configuration created.")