Downloads contain the instructions shown here. Use the install command for the complete skill.

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

--- 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)

Instructions