Index of every page on this site: llms.txt
All skills
microsoft avatar

/azure-ai

@147c081 official
Run it yourself

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.

Use this Skill: https://skilld.dev/gh/microsoft/github-copilot-for-azure/azure-ai

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈90 tokens for metadata: the name and description. ≈1.4k when used: this file. ≈34k more on demand in 42 files.

Description uses 4.5% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈360 characters, or 4.5%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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

Service Documentation

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning15d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill provides tools and documentation for building and troubleshooting Azure AI applications. It includes a specialized log analyzer for Speech SDK diagnostics that is designed to safely process untrusted log data by extracting only allowlisted fields. While the skill facilitates the installation of Azure SDKs and processes external log files, these actions are performed within the scope of its intended functionality and follow security best practices.

  • Socket15d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer8mo

    9/16 files flagged

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 147c081. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 days ago
metadata
{
  "author": "Microsoft",
  "version": "0.0.0-placeholder"
}
  • azure
  • ai-search
  • vector-search
  • speech-to-text
  • text-to-speech
  • ocr
  • document-intelligence
  • semantic-search
  • transcription
  • embeddings

README badge

README badge for microsoft/github-copilot-for-azure/azure-ai

Provides access to Azure AI services including Search (full-text, vector, hybrid), Speech (transcription, synthesis), OpenAI models, and Document Intelligence via MCP tools or CLI commands. Use this skill when working with Azure AI Search indexes, speech-to-text/text-to-speech workflows, or document extraction tasks.

Generated from the current SKILL.md.

What Azure AI services does this skill cover?
AI Search (full-text, vector, hybrid search), Speech (speech-to-text, text-to-speech), OpenAI (GPT models, embeddings), and Document Intelligence (form extraction, OCR).
Does this skill require Azure MCP to be enabled?
MCP is preferred for AI Search and Speech tools, but not required. Without it, you can run `/azure:setup` or enable via `/mcp` to activate MCP tools.
What programming languages are supported?
The skill references SDKs for Python, TypeScript, .NET, and Java depending on the service—check the SDK quick references for your target service and language.
Can this skill handle vector search and semantic similarity?
Yes. AI Search supports vector search with embeddings, hybrid search combining keyword and vector matching, and semantic search for relevance ranking.

Generated from the current SKILL.md. These answers refresh after source changes.