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
- 所属仓库
- microsoft/skills
- 最近更新
- 2026-11-11
- Stars
- ★ 3.2k
- Forks
- 364
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
skill-creator
Guide for creating effective skills for AI coding agents working with Azure SDKs and Microsoft Foundry services. Use when creating new skills or updating existing skills.
podcast-generation
Generate AI-powered podcast-style audio narratives using Azure OpenAI's GPT Realtime Mini model via WebSocket. Use when building text-to-speech features, audio narrative generation, podcast creation from content, or integrating with Azure OpenAI Realtime API for real audio output. Covers full-stack implementation from React frontend to Python FastAPI backend with WebSocket streaming.
microsoft-docs
Understand Microsoft technologies by querying official documentation. Use whenever the user asks how something works, wants tutorials, needs configuration options, limits, quotas, or best practices for any Microsoft technology (Azure, .NET, M365, Windows, Power Platform, etc.)—even if they don't mention "docs." If the question is about understanding a concept rather than writing code, this is the right skill.
mcp-builder
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP), Node/TypeScript (MCP SDK), or C#/.NET (Microsoft MCP SDK).
kql
KQL language expertise for writing correct, efficient Kusto Query Language queries. Covers syntax gotchas, join patterns, dynamic types, datetime pitfalls, regex patterns, serialization, memory management, result-size discipline, and advanced functions (geo, vector, graph). USE THIS SKILL whenever writing, debugging, or reviewing KQL queries — even simple ones — because the gotchas section prevents the most common errors that waste tool calls and cause expensive retry cascades. Trigger on: KQL, Kusto, ADX, Azure Data Explorer, Fabric Real-Time Intelligence, EventHouse, Log Analytics, log analysis, data exploration, time series, anomaly detection, summarize, where clause, join, extend, project, let statement, parse operator, extract function, any mention of pipe-forward query syntax.
github-issue-creator
Convert raw notes, error logs, voice dictation, or screenshots into crisp GitHub-flavored markdown issue reports. Use when the user pastes bug info, error messages, or informal descriptions and wants a structured GitHub issue. Supports images/GIFs for visual evidence.