azure-ai
Build and troubleshoot Azure AI Search, Speech, OpenAI, and Document Intelligence apps. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, Speech SDK logs, session ID, result ID, OCR, convert text to speech.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 267
01 前言 Front Matter
- name
- azure-ai
- license
- MIT
- metadata
- { "author": "Microsoft", "version": "1.2.3" }
- description
- Build and troubleshoot Azure AI Search, Speech, OpenAI, and Document Intelligence apps. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, Speech SDK logs, session ID, result ID, OCR, convert text to speech.
02 资源文件 26
- 参考文档references/auth-best-practices.md6.1 KB
- 参考文档references/sdk/azure-ai-contentsafety-java.md1.4 KB
- 参考文档references/sdk/azure-ai-contentsafety-py.md1.3 KB
- 参考文档references/sdk/azure-ai-contentsafety-ts.md1.4 KB
- 参考文档references/sdk/azure-ai-document-intelligence-dotnet.md1.4 KB
- 参考文档references/sdk/azure-ai-document-intelligence-ts.md1.5 KB
- 参考文档references/sdk/azure-ai-openai-dotnet.md1.4 KB
- 参考文档references/sdk/azure-ai-transcription-py.md1.2 KB
- 参考文档references/sdk/azure-ai-translation-text-py.md1.3 KB
- 参考文档references/sdk/azure-ai-translation-ts.md1.3 KB
- 参考文档references/sdk/azure-ai-vision-imageanalysis-java.md1.3 KB
- 参考文档references/sdk/azure-ai-vision-imageanalysis-py.md1.3 KB
- 参考文档references/sdk/azure-search-documents-dotnet.md1.3 KB
- 参考文档references/sdk/azure-search-documents-py.md1.5 KB
- 参考文档references/sdk/azure-search-documents-ts.md1.2 KB
- 参考文档references/speech/azure-checks.md3.5 KB
- 参考文档references/speech/collection.md3.5 KB
- 参考文档references/speech/diagnostics.md3.9 KB
- 参考文档references/speech/interpretation.md3.8 KB
- 参考文档references/speech/logging-apis.md3.8 KB
- 参考文档references/speech/output.md3.5 KB
- 参考文档references/speech/source-contract.md3.8 KB
- 参考文档references/speech/without-node.md1.9 KB
- 脚本scripts/analyze-speech-sdk-log.mjs17.7 KB
- 脚本scripts/analyze-speech-sdk-log.ps11.4 KB
- 脚本scripts/analyze-speech-sdk-log.sh1.3 KB
03 SKILL.md 正文
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, SDK logs | 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 |
| Client SDK diagnostics | Speech SDK client diagnostics for log collection, offline analysis, features, and session/result IDs (no MCP or login required) |
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
- Speech SDK client logs and troubleshooting -> Speech SDK client diagnostics
04 同仓库更多 Skills
python-appservice-deploy
Deploy Python (Flask/Django/FastAPI) code to Azure App Service Linux. WHEN: "Flask App Service", "Django App Service", "FastAPI App Service", "deploy Python to App Service". DO NOT USE FOR: Container Apps, Functions, non-Python, Terraform/Bicep/IaC, full infra — use azure-prepare.
preset
Intelligently deploys Azure OpenAI models to optimal regions by analyzing capacity across all available regions. Automatically checks current region first and shows alternatives if needed. USE FOR: quick deployment, optimal region, best region, automatic region selection, fast setup, multi-region capacity check, high availability deployment, deploy to best location. DO NOT USE FOR: custom SKU selection (use customize), specific version selection (use customize), custom capacity configuration (use customize), PTU deployments (use customize).
customize
Interactive guided deployment flow for Azure OpenAI models with full customization control. Step-by-step selection of model version, SKU (GlobalStandard/Standard/ProvisionedManaged), capacity, RAI policy (content filter), and advanced options (dynamic quota, priority processing, spillover). USE FOR: custom deployment, customize model deployment, choose version, select SKU, set capacity, configure content filter, RAI policy, deployment options, detailed deployment, advanced deployment, PTU deployment, provisioned throughput. DO NOT USE FOR: quick deployment to optimal region (use preset).
capacity
Discovers available Azure OpenAI model capacity across regions and projects. Analyzes quota limits, compares availability, and recommends optimal deployment locations based on capacity requirements. USE FOR: find capacity, check quota, where can I deploy, capacity discovery, best region for capacity, multi-project capacity search, quota analysis, model availability, region comparison, check TPM availability. DO NOT USE FOR: actual deployment (hand off to preset or customize after discovery), quota increase requests (direct user to Azure Portal), listing existing deployments.
deploy-model
Unified Azure OpenAI model deployment skill with intelligent intent-based routing. Handles quick preset deployments, fully customized deployments (version/SKU/capacity/RAI policy), and capacity discovery across regions and projects. USE FOR: deploy model, deploy gpt, create deployment, model deployment, deploy openai model, set up model, provision model, find capacity, check model availability, where can I deploy, best region for model, capacity analysis. DO NOT USE FOR: listing existing deployments (use foundry_models_deployments_list MCP tool), deleting deployments, agent creation (use agent/create), project creation (use project/create).
finetuning
Fine-tune models on Microsoft Foundry using SFT (supervised), DPO (preference), or RFT (reinforcement with graders). Covers dataset preparation, training job submission, deployment, and evaluation. USE FOR: fine-tune, SFT, DPO, RFT, training data, grader, distillation, fine-tuned model, training job, large file upload, calibrate grader, deploy fine-tuned model, evaluate fine-tuned model. DO NOT USE FOR: general model deployment without fine-tuning (use deploy-model), agent creation (use agents), prompt optimization without training (use prompt-optimizer).