Loading source

Preparing the source view

Pulling the file list, source metadata, and syntax-aware rendering for this listing.

Source from repo

Azure AI Services

Guidance for building and deploying AI solutions on Azure using Azure AI services and Copilot for Azure

microsoftGitHub microsoftOfficialSource repo Original GitHub link Publisher page

Files

17

Skill

n/a

Size

28.2 KB

Entrypoint

SKILL.md

Format

git-repo

Open file

references/sdk/azure-ai-openai-dotnet.md

Syntax-highlighted preview of this file as included in the skill package.

Rendered Source

markdown34 linesFree

Azure OpenAI — .NET SDK Quick Reference

Condensed from azure-ai-openai-dotnet. Full patterns (function calling, structured outputs, RAG with Search) in the azure-ai-openai-dotnet plugin skill if installed.

Install

dotnet add package Azure.AI.OpenAI

Quick Start

using Azure.AI.OpenAI;
using OpenAI.Chat;
var azureClient = new AzureOpenAIClient(new Uri(endpoint), credential);
ChatClient chatClient = azureClient.GetChatClient("gpt-4o-mini");

Non-Obvious Patterns

Client hierarchy: AzureOpenAIClient.GetChatClient() / GetEmbeddingClient() / GetImageClient() / GetAudioClient()
Reasoning models (o1): use DeveloperChatMessage instead of SystemChatMessage, set ReasoningEffortLevel
RAG: #pragma warning disable AOAI001 then options.AddDataSource(new AzureSearchChatDataSource{...})
Structured outputs: ChatResponseFormat.CreateJsonSchemaFormat(...)

Best Practices

Use Entra ID in production — avoid API keys
Reuse client instances — create once, share across requests
Handle rate limits — implement exponential backoff for 429 errors
Stream for long responses — use CompleteChatStreamingAsync
Set appropriate timeouts for long completions
Use structured outputs for consistent response format
Monitor token usage via completion.Usage for cost management
Validate tool call arguments before execution