1---2name: azure-ai-33description: "Build and troubleshoot Azure AI Search, Speech, Document Intelligence, Translator, Content Safety, and OpenAI apps. WHEN: AI Search, vector search, hybrid search, semantic search, indexer, speech-to-text, text-to-speech, transcribe, fast or batch transcription, Speech SDK logs, session ID, result ID, OCR, document translation, glossary."4license: MIT5metadata:6 source: https://skillmd.com/skills/microsoft/azure-ai-37 author: Microsoft8 version: "0.0.0-placeholder"9---1011# Azure AI Services1213## Scope and Handoffs1415| Request Scope | Route To |16|---------------|----------|17| Foundry projects, agents (Prompt/Hosted/Voice), model deployments, fine-tuning, quota, RBAC, Foundry VNet | `microsoft-foundry` |18| Foundry IQ knowledge bases and connectors | `foundry-iq` (separate `foundry-iq-skills` plugin; if absent, say so) |19| Azure API Management AI Gateway policies (`llm-content-safety`, semantic cache, token limits) | `azure-aigateway` |20| Classic AI Search, Speech SDK/REST/batch, Document Intelligence, Translator, standalone Content Safety, OpenAI SDK | Stay in `azure-ai` |2122## Services and Diagnostic Workflows2324Read the matching reference before diagnosing errors, validating local inputs, or collecting support evidence:2526| Service | MCP / CLI | Preflight & Diagnostics |27|---------|-----------|-------------------------|28| **AI Search** (classic indexes, vector/hybrid/semantic queries, indexers/skillsets) | `azure__search` (`search_index_list`, `search_index_get`, `search_query`), `az search` | [Index, query, and indexer diagnostics](references/search/index-and-query-diagnostics.md) |29| **Speech** (STT, TTS, Fast/Batch Transcription, Batch Synthesis, SDK logs) | `azure__speech` (`speech_transcribe`, `speech_synthesize`), `az cognitiveservices` | [Speech SDK client diagnostics](references/speech/diagnostics.md) \| [Audio & REST/batch preflight](references/speech/transcription-and-audio-preflight.md) |30| **Document Intelligence** (`v4.0` Analyze, layout/OCR, custom labels) | `az cognitiveservices` | [Input, v4 migration, and Analyze diagnostics](references/document-intelligence/preflight-and-diagnostics.md) |31| **Translator** (Text & Document Translation, glossaries, Blob auth) | `az cognitiveservices` | [Document Translation & glossary preflight](references/translator/document-translation-preflight.md) |32| **Content Safety** (standalone `text:analyze`, `image:analyze`, `text:shieldPrompt`, blocklists) | `az cognitiveservices` | [Standalone API preflight & diagnostics](references/content-safety/api-preflight-and-diagnostics.md) |33| **OpenAI** (direct SDK/API usage) | `az cognitiveservices` | [.NET SDK](references/sdk/azure-ai-openai-dotnet.md) |3435**If Azure MCP is not enabled:** In Copilot CLI or Claude Code, ask the user to run `/mcp` and enable Azure MCP; in other hosts, ask the user to enable Azure MCP through the host's MCP configuration. Offline local preflight scripts do not require Azure MCP or Azure sign-in.3637For keyless authentication patterns across Azure AI SDKs, read [Azure Authentication Best Practices](references/auth-best-practices.md).3839## SDK Quick References4041- **AI Search**: [Python](references/sdk/azure-search-documents-py.md) | [TypeScript](references/sdk/azure-search-documents-ts.md) | [.NET](references/sdk/azure-search-documents-dotnet.md)42- **OpenAI**: [.NET](references/sdk/azure-ai-openai-dotnet.md)43- **Vision**: [Python](references/sdk/azure-ai-vision-imageanalysis-py.md) | [Java](references/sdk/azure-ai-vision-imageanalysis-java.md)44- **Transcription**: [Python](references/sdk/azure-ai-transcription-py.md)45- **Translation**: [Python](references/sdk/azure-ai-translation-text-py.md) | [TypeScript](references/sdk/azure-ai-translation-ts.md)46- **Document Intelligence**: [.NET](references/sdk/azure-ai-document-intelligence-dotnet.md) | [TypeScript](references/sdk/azure-ai-document-intelligence-ts.md)47- **Content Safety**: [Python](references/sdk/azure-ai-contentsafety-py.md) | [TypeScript](references/sdk/azure-ai-contentsafety-ts.md) | [Java](references/sdk/azure-ai-contentsafety-java.md)4849## Service Documentation5051- [Azure AI Search documentation](https://learn.microsoft.com/azure/search/search-what-is-azure-search)52- [Azure AI Speech documentation](https://learn.microsoft.com/azure/ai-services/speech-service/overview)53- [Azure AI Document Intelligence documentation](https://learn.microsoft.com/azure/ai-services/document-intelligence/overview)54- [Azure AI Translator documentation](https://learn.microsoft.com/azure/ai-services/translator/overview)55- [Azure AI Content Safety documentation](https://learn.microsoft.com/azure/ai-services/content-safety/overview)