About azure-ai
azure-ai is a skill that guides agents in choosing and using Azure AI services such as AI Search and Speech. It summarizes each service's use cases, MCP tools, CLI commands and SDK quick references.
Key features
- 01Service selection table for Azure AI
- 02AI Search tools for indexes and queries
- 03Speech tools for transcription and synthesis
- 04Summaries of search and speech capabilities
- 05Links to condensed SDK guides
Use cases
- 01Choosing an Azure AI service for an agent task
- 02Querying Azure AI Search indexes through Azure MCP
- 03Running speech-to-text or text-to-speech with Speech
MCP support
The skill prefers calling Azure services through Azure MCP and lists the azure__search and azure__speech commands. It explains how to enable Azure MCP in Copilot CLI, Claude Code and other hosts.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoft/ azure-skills --skill azure-aiAfter installing, type/azure-aiin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/auth-best-practices.mdreferences/sdk/azure-ai-contentsafety-java.mdazure-ai-contentsafety-py.mdazure-ai-contentsafety-ts.mdazure-ai-document-intelligence-dotnet.mdazure-ai-document-intelligence-ts.mdazure-ai-openai-dotnet.mdazure-ai-transcription-py.mdazure-ai-translation-text-py.mdazure-ai-translation-ts.mdazure-ai-vision-imageanalysis-java.mdazure-ai-vision-imageanalysis-py.mdazure-search-documents-dotnet.mdazure-search-documents-py.mdazure-search-documents-ts.mdDetails
From the project READMEAzure 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__searchwith commandsearch_index_list- List search indexesazure__searchwith commandsearch_index_get- Get index detailsazure__searchwith commandsearch_query- Query search index
Speech
azure__speechwith commandspeech_transcribe- Speech to textazure__speechwith commandspeech_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 |
SDK Quick References
For programmatic access to these services, see the condensed SDK guides:
- AI Search: Python | TypeScript | .NET
- OpenAI: .NET
- Vision: Python | Java
- Transcription: Python
- Translation: Python | TypeScript
- Document Intelligence: .NET | TypeScript
- Content Safety: Python | TypeScript | Java
Service Details
For deep documentation on specific services:
- AI Search indexing and queries -> Azure AI Search documentation
- Speech transcription patterns -> Azure AI Speech documentation