/azure-ai

name: azure-ai
description: "Build and troubleshoot Azure AI Search, Speech, OpenAI, and Document Intelligence apps. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, Speech SDK logs, session ID, result ID, OCR, convert text to speech."
license: MIT
metadata:
  author: Microsoft
  version: "1.2.3"

Azure AI Services

Services

| Service | Use When | MCP Tools | CLI | |---------|----------|-----------|-----| | AI Search | Full-text, vector, hybrid search | `azure__search` | `az search` | | Speech | Speech-to-text, text-to-speech, SDK logs | `azure__speech` | - | | OpenAI | GPT models, embeddings, DALL-E | - | `az cognitiveservices` | | Document Intelligence | Form extraction, OCR | - | - |

MCP Server (Preferred)

When Azure MCP is enabled:

AI Search

• `azure__search` with command `search_index_list` - List search indexes
• `azure__search` with command `search_index_get` - Get index details
• `azure__search` with command `search_query` - Query search index

Speech

• `azure__speech` with command `speech_transcribe` - Speech to text
• `azure__speech` with command `speech_synthesize` - Text to speech

**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.

AI Search Capabilities

| Feature | Description | |---------|-------------| | Full-text search | Linguistic analysis, stemming | | Vector search | Semantic similarity with embeddings | | Hybrid search | Combined keyword + vector | | AI enrichment | Entity extraction, OCR, sentiment |

Speech Capabilities

| Feature | Description | |---------|-------------| | Speech-to-text | Real-time and batch transcription | | Text-to-speech | Neural voices, SSML support | | Speaker diarization | Identify who spoke when | | Custom models | Domain-specific vocabulary | | Client SDK diagnostics | [Speech SDK client diagnostics](references/speech/diagnostics.md) for log collection, offline analysis, features, and session/result IDs (no MCP or login required) |

SDK Quick References

For programmatic access to these services, see the condensed SDK guides:

• **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)
• **OpenAI**: [.NET](references/sdk/azure-ai-openai-dotnet.md)
• **Vision**: [Python](references/sdk/azure-ai-vision-imageanalysis-py.md) | [Java](references/sdk/azure-ai-vision-imageanalysis-java.md)
• **Transcription**: [Python](references/sdk/azure-ai-transcription-py.md)
• **Translation**: [Python](references/sdk/azure-ai-translation-text-py.md) | [TypeScript](references/sdk/azure-ai-translation-ts.md)
• **Document Intelligence**: [.NET](references/sdk/azure-ai-document-intelligence-dotnet.md) | [TypeScript](references/sdk/azure-ai-document-intelligence-ts.md)
• **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)

Service Details

For deep documentation on specific services:

• AI Search indexing and queries -> [Azure AI Search documentation](https://learn.microsoft.com/azure/search/search-what-is-azure-search)
• Speech transcription patterns -> [Azure AI Speech documentation](https://learn.microsoft.com/azure/ai-services/speech-service/overview)
• Speech SDK client logs and troubleshooting -> [Speech SDK client diagnostics](references/speech/diagnostics.md)