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

/azure-ai

@0d60658
by microsoftmicrosoft/skills3.2k stars
373
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/skills/azure-ai

Nothing lands on disk. Nothing to clean up.

Fork this Skill

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

referencescontent-understandingoverview-and-setup.md

≈1.2k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Content Understanding setup: surfaces, API versions, endpoints and model defaults

For Azure Content Understanding (CU) in Foundry Tools: which tool to use, which API version, how to call an analyzer, and how CU uses your model deployments. Custom analyzer design is in custom analyzers; errors in diagnostics; roles, network and data handling in access and roles, private networking and data handling. Foundry IQ ingestion that uses CU belongs to foundry-iq.

Surfaces and versions

Surface Use for
Content Understanding Studio (https://contentunderstanding.ai.azure.com) GA and preview; custom analyzer authoring, labeling, testing
Microsoft Foundry (new) portal CU playground Preview API only, partial analyzer catalog; no custom analyzer authoring or labeling
Foundry (classic) No longer a CU experience (deprecated July 15, 2026)
  • GA REST API 2025-11-01 is the default for production. Use 2026-06-01-preview only for preview features: agentic mode (config.workflow), synchronous read/layout, signature detection, document metadata, layout-based classification and segmentation, training that distills labeled samples, automatic diagnostics.
  • Pin the same api-version on create, analyze and every poll.

Resource, endpoint and calls

  • CU needs a Microsoft Foundry resource in a supported region. Learn samples use both https://<name>.services.ai.azure.com/ and https://<name>.cognitiveservices.azure.com/; use the resource's custom subdomain endpoint, not a project endpoint.
  • Auth: key, or Microsoft Entra ID with scope https://cognitiveservices.azure.com/.default and a CU role at the resource scope.
  • A custom analyzer has no separate endpoint. Create it, then call POST {endpoint}/contentunderstanding/analyzers/{analyzerId}:analyze?api-version=2025-11-01 (URL input; GA accepts one input) or :analyzeBinary (file bytes). Both return 202 with Operation-Location; poll GET {endpoint}/contentunderstanding/analyzerResults/{resultId} until the body status is Succeeded. Results are kept up to 24 hours.

Model deployments and defaults

  • Generative steps run on your model deployments; their tokens are billed there and their deployment type affects where processing happens.
  • Read defaults with GET {endpoint}/contentunderstanding/defaults; set them with PATCH (REST media type application/merge-patch+json), in Studio settings, or per request with modelDeployments.
  • An analyzer's models lists catalog model names (from its supportedModels, visible with GET on the analyzer), not deployment names. prebuilt-read, prebuilt-layout and prebuilt-digitalParse need no language or embedding model. Learn conflict: the model deployment page says CU "requires a chat completion model and an embeddings model", while the read/layout pages need neither.
  • A deployment on another resource is referenced as {ConnectionName}/{DeploymentName}; with managed identity the CU resource identity needs Cognitive Services User on that resource, and key auth needs public network access on it.

Read-only checks

Check Azure MCP (if enabled) Without MCP
Resource kind, region, endpoint foundryextensions_resource_get az cognitiveservices account show -n <name> -g <rg> --query "{kind:kind, location:location, endpoint:properties.endpoint}"
Model deployments foundryextensions_openai_models-list az cognitiveservices account deployment list -n <name> -g <rg> --query "[].{name:name, model:properties.model.name, sku:sku.name}" -o table
CU defaults none GET {endpoint}/contentunderstanding/defaults?api-version=2025-11-01 with an Entra token

Choosing between Document Intelligence and CU: see choose the right tool.

Sources (retrieved 2026-11-18): CU overview · Foundry vs CU Studio · Models and deployments · CU REST quickstart · Service limits

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 warning11d4 checks · Risk SAFE
  • Gen Agent Trust Hub11d

    This skill provides tools and guidance for developing and troubleshooting Azure AI services. It includes a local diagnostic script for analyzing Speech SDK logs with robust safety controls, along with comprehensive references for official Azure SDKs and secure authentication practices.

  • Socket11d

    No alerts

  • Snyk11d

    Risk: LOW · No issues

  • Runlayer9mo

    15/15 files flagged

Signed by skilld at 0d60658. 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": "1.2.6"
}

README badge

README badge for microsoft/skills/azure-ai