azure-ai — скилл для Claude Code: диагностика Azure AI
Скилл azure-ai для Claude Code помогает создавать и диагностировать приложения на Azure AI. Он подключается к запросам о поиске, речи, документах, переводе и других перечисленных сервисах Azure AI.
MIT 757 500 установок ★ 1 664 обновлён 2026-11-20
npx skills add microsoft/azure-skills --skill azure-ai -a claude-codeЧто делает azure-ai
azure-ai помогает разбирать ошибки и проверять входные данные для Azure AI Search, Speech, Document Intelligence, Content Understanding, Translator, Content Safety и приложений на OpenAI. Он включается при работе с векторным и семантическим поиском, распознаванием речи, OCR, переводом документов или журналами Speech SDK.
Для диагностики сервисов ссылается на справочные материалы и использует команды Azure MCP или Azure CLI, например az cognitiveservices. Если Azure MCP не подключён, для работы с ним его нужно включить в конфигурации хоста; в Claude Code и Copilot CLI для этого можно открыть /mcp. Локальные предварительные проверки не требуют Azure MCP и входа в Azure.
Запросы о Foundry-проектах и развёртывании моделей направляются другому скиллу microsoft-foundry, а базы знаний Foundry IQ — foundry-iq.
Какие задачи решает
- диагностика Azure AI
- проверить запросы и индексаторы Azure AI Search
- разобрать журналы Speech SDK и сбои транскрипции
- проверить OCR, извлечение данных и перевод документов
Примеры запросов агенту
- Разбери ошибку гибридного поиска в Azure AI Search и проверь настройки индексатора.
- Проверь журналы Speech SDK для этой ошибки распознавания речи.
- Помоги диагностировать сбой OCR в Document Intelligence.
Как установить azure-ai
1Через Skills CLI (Vercel)
npx skills add microsoft/azure-skills --skill azure-ai -a claude-code2Вручную: положить файлы
~/.claude/skills/azure-ai/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/azure-ai/
1Через Skills CLI (Vercel)
npx skills add microsoft/azure-skills --skill azure-ai -a codex2Вручную: положить файлы
.agents/skills/azure-ai/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add microsoft/azure-skills --skill azure-ai -a cursor2Вручную: положить файлы
.cursor/skills/azure-ai/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install microsoft/azure-skills skills/azure-ai2Вручную: положить файлы
.github/skills/azure-ai/SKILL.md1Через Skills CLI (Vercel)
npx skills add microsoft/azure-skills --skill azure-ai -a gemini-cli2Командой платформы
gemini skills install https://github.com/microsoft/azure-skills --path skills/azure-aiВручную: положить файлы
.devin/skills/azure-ai/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add microsoft/azure-skills --skill azure-ai -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об azure-ai
Как установить azure-ai в Claude Code?
Выполни npx skills add microsoft/azure-skills --skill azure-ai -a claude-code. Файл скилла находится по пути ~/.claude/skills/azure-ai/SKILL.md.
Что делает azure-ai?
Скилл помогает создавать и диагностировать приложения с Azure AI Search, Speech, Document Intelligence, Content Understanding, Translator, Content Safety и OpenAI. Он также содержит справочные материалы по SDK и проверкам сервисов.
Что нужно для работы azure-ai?
Для диагностики через Azure MCP его нужно включить в конфигурации хоста. В Claude Code можно открыть /mcp; локальные предварительные проверки выполняются без Azure MCP и входа в Azure.
Исходный текст
SKILL.md · MIT
--- name: azure-ai description: "Build and troubleshoot Azure AI Search, Speech, Document Intelligence, Content Understanding, Translator, Content Safety, and OpenAI apps. WHEN: AI Search, vector search, hybrid search, semantic search, indexer, speech-to-text, text-to-speech, fast or batch transcription, Speech SDK logs, session ID, result ID, OCR, document translation, glossary." license: MIT metadata: author: Microsoft version: "1.2.6" --- # Azure AI Services ## Scope and Handoffs | Request Scope | Route To | |---------------|----------| | Foundry projects, agents (Prompt/Hosted/Voice), model deployments, fine-tuning, quota, project RBAC, Foundry VNet | `microsoft-foundry` | | Foundry IQ knowledge bases and connectors | `foundry-iq` (separate `foundry-iq-skills` plugin; if absent, say so) | | Azure API Management AI Gateway policies (`llm-content-safety`, semantic cache, token limits) | `azure-aigateway` | | Classic AI Search, Speech SDK/REST/batch, Document Intelligence, Content Understanding, Translator, standalone Content Safety, OpenAI SDK | Stay in `azure-ai` | | Roles, private endpoints, Studio storage or data handling for Document Intelligence or Content Understanding calls (including CU in the Foundry portal) | Stay in `azure-ai` | ## Services and Diagnostic Workflows Read the matching reference before diagnosing errors, validating local inputs, or collecting support evidence: | Service | MCP / CLI | Preflight & Diagnostics | |---------|-----------|-------------------------| | **AI Search** (classic indexes, vector/hybrid/semantic queries, indexers/skillsets) | `azure__search` (`search_service_list`, `search_index_get`, `search_index_query`), `az search` | [Index, query, and indexer diagnostics](references/search/index-and-query-diagnostics.md) | | **Speech** (STT, TTS, Fast/Batch Transcription, Batch Synthesis, SDK logs) | `azure__speech` (`speech_stt_recognize`, `speech_tts_synthesize`), `az cognitiveservices` | [Speech SDK client diagnostics](references/speech/diagnostics.md) \| [Audio & REST/batch preflight](references/speech/transcription-and-audio-preflight.md) | | **Document Intelligence** (`v4.0` Analyze, layout/OCR, custom extraction, classifiers, composed models) | `az cognitiveservices` | [Input, v4 migration, and Analyze diagnostics](references/document-intelligence/preflight-and-diagnostics.md) \| [Custom models, labels, and confidence](references/document-intelligence/custom-models.md) | | **Content Understanding** (analyzers, CU Studio, model defaults, custom analyzers) | `az cognitiveservices` | [Setup, API versions, and defaults](references/content-understanding/overview-and-setup.md) \| [Custom analyzers](references/content-understanding/custom-analyzers.md) \| [Diagnostics](references/content-understanding/diagnostics.md) | | **Access, network, and data** for Document Intelligence and Content Understanding | `azure__role` (`role_assignment_list`), `az role`, `az network` | [Roles and auth](references/foundry-tools/access-and-roles.md) \| [Studio storage](references/foundry-tools/storage-and-studio.md) \| [Private networking](references/foundry-tools/private-network.md) \| [Data handling](references/foundry-tools/data-handling.md) \| [Evidence without content](references/foundry-tools/evidence-without-content.md) | | **Translator** (Text & Document Translation, glossaries, Blob auth) | `az cognitiveservices` | [Document Translation & glossary preflight](references/translator/document-translation-preflight.md) | | **Content Safety** (standalone `text:analyze`, `image:analyze`, `text:shieldPrompt`, blocklists) | `az cognitiveservices` | [Standalone API preflight & diagnostics](references/content-safety/api-preflight-and-diagnostics.md) | | **OpenAI** (direct SDK/API usage) | `az cognitiveservices` | [.NET SDK](references/sdk/azure-ai-openai-dotnet.md) | **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. Offline local preflight scripts do not require Azure MCP or Azure sign-in. For keyless authentication patterns across Azure AI SDKs, read [Azure Authentication Best Practices](references/auth-best-practices.md). ## SDK Quick References - **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 Documentation - [Azure AI Search documentation](https://learn.microsoft.com/azure/search/search-what-is-azure-search) - [Azure AI Speech documentation](https://learn.microsoft.com/azure/ai-services/speech-service/overview) - [Azure AI Document Intelligence documentation](https://learn.microsoft.com/azure/ai-services/document-intelligence/overview) - [Azure Content Understanding documentation](https://learn.microsoft.com/azure/ai-services/content-understanding/overview) - [Azure AI Translator documentation](https://learn.microsoft.com/azure/ai-services/translator/overview) - [Azure AI Content Safety documentation](https://learn.microsoft.com/azure/ai-services/content-safety/overview)
© Microsoft · MIT · microsoft/azure-skills