Azure Ai
Published by microsoft in azure-skills
What this skill does
Use Azure AI services to search indexes, transcribe or synthesize speech, and work with OpenAI and document processing SDKs. The agent can help query data and build search, speech, OCR, and AI features into applications. Best for Developers adding Azure search, speech, OpenAI, or document processing to an application.
Add Azure Ai to your agent
Review the source and files first. When you are ready, copy the prompt instruction or use the CLI command supported by your environment.
Install with a prompt
Paste this into a compatible coding agent:
add this skill "azure-ai" from https://github.com/microsoft/azure-skillsInstall with the CLI
Run this command in a controlled environment after reviewing the repository:
npx skills add https://github.com/microsoft/azure-skills --skill azure-aiSkill instructions
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 |
| Speech (STT, TTS, Fast/Batch Transcription, Batch Synthesis, SDK logs) | azure__speech (speech_stt_recognize, speech_tts_synthesize), az cognitiveservices | Speech SDK client diagnostics | Audio & REST/batch preflight |
Document Intelligence (v4.0 Analyze, layout/OCR, custom extraction, classifiers, composed models) | az cognitiveservices | Input, v4 migration, and Analyze diagnostics | Custom models, labels, and confidence |
| Content Understanding (analyzers, CU Studio, model defaults, custom analyzers) | az cognitiveservices | Setup, API versions, and defaults | Custom analyzers | Diagnostics |
| Access, network, and data for Document Intelligence and Content Understanding | azure__role (role_assignment_list), az role, az network | Roles and auth | Studio storage | Private networking | Data handling | Evidence without content |
| Translator (Text & Document Translation, glossaries, Blob auth) | az cognitiveservices | Document Translation & glossary preflight |
Content Safety (standalone text:analyze, image:analyze, text:shieldPrompt, blocklists) | az cognitiveservices | Standalone API preflight & diagnostics |
| OpenAI (direct SDK/API usage) | az cognitiveservices | .NET SDK |
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.
SDK Quick References
- 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 Documentation
Files included
- references/auth-best-practices.md
- references/content-safety/api-preflight-and-diagnostics.md
- references/content-understanding/custom-analyzers.md
- references/content-understanding/diagnostics.md
- references/content-understanding/overview-and-setup.md
- references/document-intelligence/custom-models.md
- references/document-intelligence/preflight-and-diagnostics.md
- references/document-intelligence/without-node.md
- references/foundry-tools/access-and-roles.md
- references/foundry-tools/data-handling.md
- references/foundry-tools/evidence-without-content.md
- references/foundry-tools/private-network.md
- references/foundry-tools/storage-and-studio.md
- references/foundry-tools/without-node.md
- references/sdk/azure-ai-contentsafety-java.md
- references/sdk/azure-ai-contentsafety-py.md
- references/sdk/azure-ai-contentsafety-ts.md
- references/sdk/azure-ai-document-intelligence-dotnet.md
- references/sdk/azure-ai-document-intelligence-ts.md
- references/sdk/azure-ai-openai-dotnet.md
- references/sdk/azure-ai-transcription-py.md
- references/sdk/azure-ai-translation-text-py.md
- references/sdk/azure-ai-translation-ts.md
- references/sdk/azure-ai-vision-imageanalysis-java.md
- references/sdk/azure-ai-vision-imageanalysis-py.md
- references/sdk/azure-search-documents-dotnet.md
- references/sdk/azure-search-documents-py.md
- references/sdk/azure-search-documents-ts.md
- references/search/index-and-query-diagnostics.md
- references/speech/audio-without-node.md
- references/speech/azure-checks.md
- references/speech/collection.md
- references/speech/diagnostics.md
- references/speech/interpretation.md
- references/speech/logging-apis.md
- references/speech/output.md
- references/speech/source-contract.md
- references/speech/transcription-and-audio-preflight.md
- references/speech/without-node.md
- references/translator/document-translation-preflight.md
- references/translator/without-node.md
- scripts/analyze-speech-sdk-log.mjs
- scripts/analyze-speech-sdk-log.ps1
- scripts/analyze-speech-sdk-log.sh
- scripts/audit-di-training-set.mjs
- scripts/audit-di-training-set.ps1
- scripts/audit-di-training-set.sh
- scripts/check-foundry-tools-access.mjs
- scripts/check-foundry-tools-access.ps1
- scripts/check-foundry-tools-access.sh
- scripts/check-foundry-tools-network.mjs
- scripts/check-foundry-tools-network.ps1
- scripts/check-foundry-tools-network.sh
- scripts/inspect-document-input.mjs
- scripts/inspect-document-input.ps1
- scripts/inspect-document-input.sh
- scripts/inspect-speech-audio.mjs
- scripts/inspect-speech-audio.ps1
- scripts/inspect-speech-audio.sh
- scripts/json-file.mjs
- scripts/sanitize-har.mjs
- scripts/sanitize-har.ps1
- scripts/sanitize-har.sh
- scripts/validate-content-safety-request.mjs
- scripts/validate-content-safety-request.ps1
- scripts/validate-content-safety-request.sh
- scripts/validate-document-translation.mjs
- scripts/validate-document-translation.ps1
- scripts/validate-document-translation.sh
- scripts/validate-search-schema.mjs
- scripts/validate-search-schema.ps1
- scripts/validate-search-schema.sh
- SKILL.md

