About azure-ai
azure-ai is a guide for developers using Azure AI services, covering AI Search, Speech, OpenAI, and Document Intelligence, with MCP tool and SDK references.
Key features
- 01Query AI Search indexes
- 02Run full-text, vector, and hybrid search
- 03Transcribe and synthesize speech
- 04Consult Azure AI SDK guides
Use cases
- 01List indexes and query search content
- 02Transcribe speech into text
- 03Convert text to synthesized speech
MCP support
With Azure MCP enabled, the guide describes tools for querying AI Search indexes and transcribing or synthesizing speech.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ midudev/ autoskills --skill azure-aiAfter installing, type/azure-aiin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
version.jsonreferences/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