Skill 寫法圖鑑

azure-ai

Microsoft | 雲端與基礎設施 | 原文 | MIT

Azure AI 服務速查,包含搜尋、語音、OpenAI、文件辨識

中文翻譯

---
name: azure-ai
description: "用於 Azure AI:Search、Speech、OpenAI、Document Intelligence。協助處理搜尋、向量/混合搜尋、語音轉文字、文字轉語音、轉錄、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 服務

## 服務

| 服務 | 使用時機 | MCP 工具 | CLI |
|---------|----------|-----------|-----|
| AI Search | 全文、向量、混合搜尋 | `azure__search` | `az search` |
| Speech | 語音轉文字、文字轉語音 | `azure__speech` | - |
| OpenAI | GPT 模型、embedding、DALL-E | - | `az cognitiveservices` |
| Document Intelligence | 表單擷取、OCR | - | - |

## MCP Server(優先)

啟用 Azure MCP 時:

### AI Search
- `azure__search` 搭配指令 `search_index_list`:列出 search index
- `azure__search` 搭配指令 `search_index_get`:取得 index 詳細資訊
- `azure__search` 搭配指令 `search_query`:查詢 search index

### Speech
- `azure__speech` 搭配指令 `speech_transcribe`:語音轉文字
- `azure__speech` 搭配指令 `speech_synthesize`:文字轉語音

**如果沒有啟用 Azure MCP:** 在 Copilot CLI 或 Claude Code 裡,請使用者執行 `/mcp` 並啟用 Azure MCP;在其他 host,請使用者透過該 host 的 MCP 設定啟用 Azure MCP。

## AI Search 能力

| 功能 | 說明 |
|---------|-------------|
| 全文搜尋 | 語言分析、詞幹還原 |
| 向量搜尋 | 用 embedding 做語意相似度 |
| 混合搜尋 | 關鍵字 + 向量並用 |
| AI 增強 | 實體擷取、OCR、情緒分析 |

## Speech 能力

| 功能 | 說明 |
|---------|-------------|
| 語音轉文字 | 即時和批次轉錄 |
| 文字轉語音 | 神經網路語音、支援 SSML |
| 說話者分離 | 辨識誰在什麼時候說話 |
| 自訂模型 | 特定領域的詞彙 |

## SDK 速查

要用程式存取這些服務,請看精簡版的 SDK 指南:

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

## 服務詳細資料

要看特定服務的深入文件:

- AI Search 的索引和查詢 -> [Azure AI Search documentation](https://learn.microsoft.com/azure/search/search-what-is-azure-search)
- Speech 轉錄的模式 -> [Azure AI Speech documentation](https://learn.microsoft.com/azure/ai-services/speech-service/overview)

英文原文

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