Azure OpenAI

Use OpenAI models through Azure's infrastructure. Learn more here.

Azure OpenAI provides access to OpenAI's models like gpt-4o, gpt-5-mini, and more.

Installation

uv pip install -U openai agno

Create or select a gpt-5-mini chat deployment. Set AZURE_OPENAI_DEPLOYMENT to its actual deployment name, and use the key and resource endpoint for that deployment. You may omit the deployment setting only when an existing deployment is named exactly like id. Keep id aligned with the deployed model family.

Navigate to Azure OpenAI on the Azure Portal and create a service. Then, using the Azure AI Foundry portal, create a deployment and set your environment variables:

export AZURE_OPENAI_API_KEY="your_value_here"
export AZURE_OPENAI_ENDPOINT="your_value_here"  # Of the form https://<your-resource-name>.openai.azure.com
# Optional:
# export AZURE_OPENAI_DEPLOYMENT=***

Example

Use AzureOpenAI with your Agent:

from agno.agent import Agent
from agno.models.azure import AzureOpenAI

agent = Agent(
    model=AzureOpenAI(id="gpt-5-mini"),
    markdown=True
)

# Print the response on the terminal
agent.print_response("Share a 2 sentence horror story.")

Prompt caching

Prompt caching happens automatically with the AzureOpenAI model. Read more about how OpenAI handles caching in their docs.

Advanced Examples

View more examples here.

Parameters

Parameter	Type	Default	Description
`id`	`str`	`"not-provided"` (set explicitly)	Model ID sent in the request; also selects the deployment URL when azure_deployment is unset
`name`	`str`	`"AzureOpenAI"`	The name of the model
`provider`	`str`	`"Azure"`	The provider of the model
`api_key`	`Optional[str]`	`None`	The API key for Azure OpenAI (defaults to AZURE_OPENAI_API_KEY env var)
`api_version`	`Optional[str]`	`"2024-10-21"`	The API version to use
`azure_endpoint`	`Optional[str]`	`None`	The Azure endpoint URL (defaults to AZURE_OPENAI_ENDPOINT env var)
`azure_deployment`	`Optional[str]`	`None`	The deployment name (defaults to AZURE_OPENAI_DEPLOYMENT env var)
`base_url`	`Optional[str]`	`None`	Alternative base URL for the service
`azure_ad_token`	`Optional[str]`	`None`	Azure AD token for authentication
`azure_ad_token_provider`	`Optional[Any]`	`None`	Azure AD token provider for authentication
`default_headers`	`Optional[Dict[str, str]]`	`None`	Default headers to include in all requests
`default_query`	`Optional[Dict[str, Any]]`	`None`	Default query parameters to include in all requests

AzureOpenAI also supports the parameters of OpenAI.