# Azure AI

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

- Skill: `jonathan-vella/azure-ai` (Agent Skill, multi-file: 18 files)
- Install (CLI): `npx skillmds@latest add jonathan-vella/azure-ai`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jonathan-vella/azure-ai/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- License: MIT
- Author: jonathan-vella (https://skillmd.com/u/jonathan-vella)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jonathan-vella/azure-ai

---


# 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](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)

## Reference Index

Load these on demand — do NOT read all at once:

| Reference                           | When to Load        |
| ----------------------------------- | ------------------- |
| `references/auth-best-practices.md` | Auth Best Practices |