$npx -y skills add microsoft/azure-skills --skill azure-aiUse for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe,
| 1 | # Azure AI Services |
| 2 | |
| 3 | ## Services |
| 4 | |
| 5 | | Service | Use When | MCP Tools | CLI | |
| 6 | |---------|----------|-----------|-----| |
| 7 | | AI Search | Full-text, vector, hybrid search | `azure__search` | `az search` | |
| 8 | | Speech | Speech-to-text, text-to-speech | `azure__speech` | - | |
| 9 | | OpenAI | GPT models, embeddings, DALL-E | - | `az cognitiveservices` | |
| 10 | | Document Intelligence | Form extraction, OCR | - | - | |
| 11 | |
| 12 | ## MCP Server (Preferred) |
| 13 | |
| 14 | When Azure MCP is enabled: |
| 15 | |
| 16 | ### AI Search |
| 17 | - `azure__search` with command `search_index_list` - List search indexes |
| 18 | - `azure__search` with command `search_index_get` - Get index details |
| 19 | - `azure__search` with command `search_query` - Query search index |
| 20 | |
| 21 | ### Speech |
| 22 | - `azure__speech` with command `speech_transcribe` - Speech to text |
| 23 | - `azure__speech` with command `speech_synthesize` - Text to speech |
| 24 | |
| 25 | **If Azure MCP is not enabled:** Run `/azure:setup` or enable via `/mcp`. |
| 26 | |
| 27 | ## AI Search Capabilities |
| 28 | |
| 29 | | Feature | Description | |
| 30 | |---------|-------------| |
| 31 | | Full-text search | Linguistic analysis, stemming | |
| 32 | | Vector search | Semantic similarity with embeddings | |
| 33 | | Hybrid search | Combined keyword + vector | |
| 34 | | AI enrichment | Entity extraction, OCR, sentiment | |
| 35 | |
| 36 | ## Speech Capabilities |
| 37 | |
| 38 | | Feature | Description | |
| 39 | |---------|-------------| |
| 40 | | Speech-to-text | Real-time and batch transcription | |
| 41 | | Text-to-speech | Neural voices, SSML support | |
| 42 | | Speaker diarization | Identify who spoke when | |
| 43 | | Custom models | Domain-specific vocabulary | |
| 44 | |
| 45 | ## SDK Quick References |
| 46 | |
| 47 | For programmatic access to these services, see the condensed SDK guides: |
| 48 | |
| 49 | - **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) |
| 50 | - **OpenAI**: [.NET](references/sdk/azure-ai-openai-dotnet.md) |
| 51 | - **Vision**: [Python](references/sdk/azure-ai-vision-imageanalysis-py.md) | [Java](references/sdk/azure-ai-vision-imageanalysis-java.md) |
| 52 | - **Transcription**: [Python](references/sdk/azure-ai-transcription-py.md) |
| 53 | - **Translation**: [Python](references/sdk/azure-ai-translation-text-py.md) | [TypeScript](references/sdk/azure-ai-translation-ts.md) |
| 54 | - **Document Intelligence**: [.NET](references/sdk/azure-ai-document-intelligence-dotnet.md) | [TypeScript](references/sdk/azure-ai-document-intelligence-ts.md) |
| 55 | - **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) |
| 56 | |
| 57 | ## Service Details |
| 58 | |
| 59 | For deep documentation on specific services: |
| 60 | |
| 61 | - AI Search indexing and queries -> [Azure AI Search documentation](https://learn.microsoft.com/azure/search/search-what-is-azure-search) |
| 62 | - Speech transcription patterns -> [Azure AI Speech documentation](https://learn.microsoft.com/azure/ai-services/speech-service/overview) |