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

Source: https://skillsagentes.com/skills/microsoft/azure-skills/azure-ai
Repository: https://github.com/microsoft/azure-skills
Author: microsoft
License: MIT
Updated: hace 17 días
Context cost: 77 tok installed, 817 tok once triggered, 7.2k tok with every bundled file
Bundle: 16 files, 28 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add microsoft/azure-skills --skill azure-ai --agent claude-code
```

## What it does

- Cubre cuatro servicios de Azure AI: AI Search, Speech, OpenAI y Document Intelligence, con la tabla de cuándo usar cada uno.
- Prefiere el servidor MCP de Azure cuando está habilitado: `azure__search` para listar y consultar índices, `azure__speech` para transcribir y sintetizar.
- Detalla las capacidades de AI Search — búsqueda de texto completo, vectorial, híbrida y enriquecimiento con IA — y las de Speech, incluida la diarización de hablantes.
- Enlaza guías condensadas de SDK por lenguaje para Search, OpenAI, Vision, transcripción, traducción, Document Intelligence y Content Safety.

## Use it when

- Se necesita búsqueda: texto completo, vectorial, híbrida o semántica.
- Se necesita voz: transcripción, texto a voz o conversión de texto a habla.
- Se necesita OCR o extracción de formularios.

## What triggers it

- "monta una búsqueda vectorial"
- "transcribe este audio"
- "haz OCR de estos formularios"
- "¿cómo hago búsqueda híbrida?"

## Before you install

- Si el MCP de Azure no está habilitado, indica ejecutar `/azure:setup` o activarlo con `/mcp`.

## Files

- SKILL.md — 3 KB
- references/auth-best-practices.md — 6 KB
- references/sdk/azure-ai-contentsafety-java.md — 1 KB
- references/sdk/azure-ai-contentsafety-py.md — 1 KB
- references/sdk/azure-ai-contentsafety-ts.md — 1 KB
- references/sdk/azure-ai-document-intelligence-dotnet.md — 1 KB
- references/sdk/azure-ai-document-intelligence-ts.md — 2 KB
- references/sdk/azure-ai-openai-dotnet.md — 1 KB
- references/sdk/azure-ai-transcription-py.md — 1 KB
- references/sdk/azure-ai-translation-text-py.md — 1 KB
- references/sdk/azure-ai-translation-ts.md — 1 KB
- references/sdk/azure-ai-vision-imageanalysis-java.md — 1 KB
- references/sdk/azure-ai-vision-imageanalysis-py.md — 1 KB
- references/sdk/azure-search-documents-dotnet.md — 1 KB
- references/sdk/azure-search-documents-py.md — 2 KB
- references/sdk/azure-search-documents-ts.md — 1 KB

## SKILL.md

Reproduced verbatim from microsoft/azure-skills under MIT. This section is the upstream document and is in English.

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

---

Skills Agentes — https://skillsagentes.com/skills/microsoft/azure-skills/azure-ai