azure-ai — скилл для Claude Code: Azure AI Search, Speech и OCR
Подключает к агенту сервисы Azure: поиск по индексам, распознавание и синтез речи, OCR. Пригодится, когда проект уже живёт в Azure.
npx skills add microsoft/skills --skill azure-ai -a claude-codeЧто делает azure-ai
Скилл описывает четыре сервиса Azure и то, какими инструментами к ним ходить. AI Search закрывает полнотекстовый, векторный и гибридный поиск, плюс обогащение данными: извлечение сущностей, OCR, тональность. Speech отвечает за распознавание речи в реальном времени и пакетом, синтез нейронными голосами с поддержкой SSML, разделение говорящих по ролям и кастомные модели под свою лексику. Отдельно идут OpenAI с моделями GPT, эмбеддингами и DALL-E и Document Intelligence для разбора форм и OCR.
Основной путь — через Azure MCP. Тогда агенту доступны azure__search с командами search_index_list, search_index_get и search_query, а также azure__speech с speech_transcribe и speech_synthesize. Если Azure MCP не включён, в Copilot CLI или Claude нужно попросить пользователя выполнить /mcp и включить сервер; в других хостах — включить Azure MCP через их конфигурацию. Без этого скилл останется справочником.
Внутри есть краткие руководства по SDK для Python, TypeScript, .NET и Java: поиск, OpenAI, Vision, транскрибация, перевод, Document Intelligence, Content Safety. Для CLI заявлены az search и az cognitiveservices. Скилл не поднимает сами сервисы в Azure — ресурсы и доступы нужны заранее, иначе вызовы инструментов упрутся в пустой список индексов.
Какие задачи решает
- найти нужный индекс и выполнить по нему запрос
- собрать гибридный поиск из ключевых слов и векторов
- расшифровать аудио в текст пакетом или в реальном времени
- озвучить текст нейронным голосом с разметкой SSML
- вытащить поля из сканов и форм через OCR
Примеры запросов агенту
- покажи список индексов в Azure AI Search
- найди в индексе документы по запросу про возвраты
- расшифруй файл записи встречи в текст
Как установить azure-ai
1Через Skills CLI (Vercel)
npx skills add microsoft/skills --skill azure-ai -a claude-code2Вручную: положить файлы
~/.claude/skills/azure-ai/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/azure-ai/
Вручную: положить файлы
.agents/skills/azure-ai/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/azure-ai/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install microsoft/skills azure-ai2Вручную: положить файлы
.github/skills/azure-ai/SKILL.mdКомандой платформы
gemini skills install https://github.com/microsoft/skills --path .github/plugins/azure-skills/skills/azure-aiВручную: положить файлы
.devin/skills/azure-ai/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о azure-ai
Как установить azure-ai в Claude?
Выполните npx skills add microsoft/skills --skill azure-ai -a claude-code. Файл скилла окажется по пути ~/.claude/skills/azure-ai/SKILL.md.
Что делает azure-ai?
Даёт агенту работу с Azure AI Search, Speech, OpenAI и Document Intelligence: поиск по индексам, распознавание и синтез речи, OCR, разбор форм. Плюс ссылки на SDK-руководства для Python, TypeScript, .NET и Java.
Нужен ли Azure MCP для работы скилла?
Да, это предпочтительный путь: инструменты azure__search и azure__speech доступны только при включённом Azure MCP. В Claude и Copilot CLI его включают через /mcp.
Исходный текст
SKILL.md · MIT
--- 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.2" --- # 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:** 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](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)
© Microsoft · MIT · microsoft/skills
