--- name: azure-ai description: "Use 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, OCR, convert text to speech." license: MIT metadata: author: Microsoft version: "1.2.1" title: azure-ai canonical_url: https://skilld.dev/gh/microsoft/skills/azure-ai last_updated: 2026-09-29T12:22:09.000Z --- > **Skill from skilld.dev.** Follow the instructions below for this session. You do not need to install anything. > > Supporting files, fetch one when the Skill refers to it: [references/auth-best-practices.md](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/auth-best-practices.md), [references/sdk/azure-ai-contentsafety-java.md](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-contentsafety-java.md), [references/sdk/azure-ai-contentsafety-py.md](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-contentsafety-py.md), [references/sdk/azure-ai-contentsafety-ts.md](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-contentsafety-ts.md), [references/sdk/azure-ai-document-intelligence-dotnet.md](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-document-intelligence-dotnet.md), [references/sdk/azure-ai-document-intelligence-ts.md](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-document-intelligence-ts.md), [references/sdk/azure-ai-openai-dotnet.md](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-openai-dotnet.md), [references/sdk/azure-ai-transcription-py.md](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-transcription-py.md), [references/sdk/azure-ai-translation-text-py.md](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-translation-text-py.md), [references/sdk/azure-ai-translation-ts.md](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-translation-ts.md), [references/sdk/azure-ai-vision-imageanalysis-java.md](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-vision-imageanalysis-java.md), [references/sdk/azure-ai-vision-imageanalysis-py.md](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-vision-imageanalysis-py.md), [references/sdk/azure-search-documents-dotnet.md](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-search-documents-dotnet.md), [references/sdk/azure-search-documents-py.md](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-search-documents-py.md), [references/sdk/azure-search-documents-ts.md](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-search-documents-ts.md). > > If the user asked to install this Skill, run `npx skilld install microsoft/skills/azure-ai`. Install writes the Skill files into the project, so every session loads them. # 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 | `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:** Run `/azure:setup` or enable via `/mcp`. ## 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 | ## SDK Quick References For programmatic access to these services, see the condensed SDK guides: - **AI Search**: [Python](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-search-documents-py.md) | [TypeScript](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-search-documents-ts.md) | [.NET](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-search-documents-dotnet.md) - **OpenAI**: [.NET](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-openai-dotnet.md) - **Vision**: [Python](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-vision-imageanalysis-py.md) | [Java](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-vision-imageanalysis-java.md) - **Transcription**: [Python](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-transcription-py.md) - **Translation**: [Python](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-translation-text-py.md) | [TypeScript](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-translation-ts.md) - **Document Intelligence**: [.NET](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-document-intelligence-dotnet.md) | [TypeScript](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-document-intelligence-ts.md) - **Content Safety**: [Python](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-contentsafety-py.md) | [TypeScript](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/references/sdk/azure-ai-contentsafety-ts.md) | [Java](https://skilld.dev/api/skills-raw/microsoft/skills/azure-ai/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)