# Azure AI Services

> Azure AI services Skill

- Skill: `comeonoliver/azure-ai-services` (Agent Skill)
- Install (CLI): `npx skillmds@latest add comeonoliver/azure-ai-services`
- Raw SKILL.md: https://api.skillmd.com/api/skills/comeonoliver/azure-ai-services/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: ComeOnOliver (https://skillmd.com/u/comeonoliver)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/comeonoliver/azure-ai-services

---

# Azure AI services Skill

This skill provides expert guidance for Azure AI services. Covers troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

## How to Use This Skill

> **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file

> **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)

This skill requires **network access** to fetch documentation content:
- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.
- **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.

## Category Index

| Category | Lines | Description |
|----------|-------|-------------|
| Troubleshooting | L36-L40 | Diagnosing and fixing common Content Understanding issues, including model errors, data ingestion problems, configuration mistakes, and troubleshooting steps for failed analyses. |
| Best Practices | L41-L46 | Best practices for Azure AI Content Understanding: designing extraction workflows, tuning models, improving document parsing accuracy, and handling complex or low‑quality documents. |
| Decision Making | L47-L56 | Guidance on choosing pricing tiers and tools (Foundry vs Content Understanding vs Document Intelligence/LLMs), standard vs pro modes, migration steps, and estimating Content Understanding costs. |
| Limits & Quotas | L57-L64 | Rate limits, quotas, and scaling for Foundry and Content Moderator/Understanding: autoscale strategies, image/term list limits, and how to stay within service quotas. |
| Security | L65-L80 | Securing Azure AI/Foundry: auth (Entra, keys, Key Vault), encryption (CMK, data-at-rest), DLP for outbound calls, VNet rules, policy-based governance, and secure analyzer access. |
| Configuration | L81-L99 | Configuring Foundry endpoints, credentials, containers, logging, and Content Understanding analyzers (classification, layout, audiovisual), routing, outputs, and resource recovery/purge. |
| Integrations & Coding Patterns | L100-L109 | Using Azure Content Moderator and Content Understanding via REST/.NET: text/image/video moderation, custom term lists, and building custom multimodal analyzers and workflows. |
| Deployment | L110-L117 | How to package and run Foundry tools/containers on Azure (ACI, Docker Compose, disconnected), and deploy Foundry resources using Azure AI containers and ARM templates |

### Troubleshooting
| Topic | URL |
|-------|-----|
| Resolve common issues with Content Understanding | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/faq |

### Best Practices
| Topic | URL |
|-------|-----|
| Apply best practices for Content Understanding workloads | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/best-practices |
| Improve Content Understanding document extraction quality | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/document/analyzer-improvement |

### Decision Making
| Topic | URL |
|-------|-----|
| Choose and use Foundry commitment tier pricing | https://learn.microsoft.com/en-us/azure/ai-services/commitment-tier |
| Choose between Content Understanding, Document Intelligence, and LLMs | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/choosing-right-ai-tool |
| Choose between standard and pro modes in Content Understanding | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/standard-pro-modes |
| Choose between Foundry and Content Understanding Studio | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/foundry-vs-content-understanding-studio |
| Migrate Content Understanding analyzers from preview to GA | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/how-to/migration-preview-to-ga |
| Estimate and plan costs for Content Understanding | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/pricing-explainer |

### Limits & Quotas
| Topic | URL |
|-------|-----|
| Use autoscale to increase Foundry rate limits | https://learn.microsoft.com/en-us/azure/ai-services/autoscale |
| Use Content Moderator image lists within quota limits | https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/image-lists-quickstart-dotnet |
| Understand Content Moderator image and term list limits | https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/samples-dotnet |
| Review Content Understanding service quotas and limits | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/service-limits |

### Security
| Topic | URL |
|-------|-----|
| Configure authentication for Foundry Tools requests | https://learn.microsoft.com/en-us/azure/ai-services/authentication |
| Configure data loss prevention for Foundry outbound calls | https://learn.microsoft.com/en-us/azure/ai-services/cognitive-services-data-loss-prevention |
| Secure Foundry resources with virtual network rules | https://learn.microsoft.com/en-us/azure/ai-services/cognitive-services-virtual-networks |
| Understand Content Moderator data-at-rest encryption behavior | https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/encrypt-data-at-rest |
| Configure secure access for Content Understanding analyzers | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/secure-communications |
| Enforce Entra-only auth by disabling local keys | https://learn.microsoft.com/en-us/azure/ai-services/disable-local-auth |
| Configure customer-managed encryption keys for Foundry | https://learn.microsoft.com/en-us/azure/ai-services/encryption/cognitive-services-encryption-keys-portal |
| Use built-in Azure Policies for Foundry governance | https://learn.microsoft.com/en-us/azure/ai-services/policy-reference |
| Rotate Foundry API keys without downtime | https://learn.microsoft.com/en-us/azure/ai-services/rotate-keys |
| Apply Azure Policy compliance controls to Foundry | https://learn.microsoft.com/en-us/azure/ai-services/security-controls-policy |
| Apply security features for Foundry Tools resources | https://learn.microsoft.com/en-us/azure/ai-services/security-features |
| Secure Foundry applications using Azure Key Vault | https://learn.microsoft.com/en-us/azure/ai-services/use-key-vault |

### Configuration
| Topic | URL |
|-------|-----|
| Configure custom subdomains for Foundry endpoints | https://learn.microsoft.com/en-us/azure/ai-services/cognitive-services-custom-subdomains |
| Use environment variables for Foundry credentials | https://learn.microsoft.com/en-us/azure/ai-services/cognitive-services-environment-variables |
| Create reusable Azure AI container images with presets | https://learn.microsoft.com/en-us/azure/ai-services/containers/container-reuse-recipe |
| Configure Content Understanding analyzers and parameters | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/analyzer-reference |
| Configure classification and splitting in Content Understanding | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/classifier |
| Connect Content Understanding analyzers to Foundry model deployments | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/models-deployments |
| Use and customize Content Understanding prebuilt analyzers | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/prebuilt-analyzers |
| Configure document layout and data extraction with Content Understanding | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/document/elements |
| Interpret Content Understanding document Markdown output | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/document/markdown |
| Configure classification and routing in Content Understanding Studio | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/how-to/classification-content-understanding-studio |
| Copy Content Understanding custom analyzers across resources | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/how-to/copy-analyzers |
| Configure audiovisual analysis for audio and video inputs | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/video/elements |
| Interpret audiovisual Markdown output from Content Understanding | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/video/markdown |
| Configure diagnostic logging for Foundry resources | https://learn.microsoft.com/en-us/azure/ai-services/diagnostic-logging |
| Recover or purge deleted Foundry resources | https://learn.microsoft.com/en-us/azure/ai-services/recover-purge-resources |

### Integrations & Coding Patterns
| Topic | URL |
|-------|-----|
| Reference for Azure Content Moderator REST APIs | https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/api-reference |
| Call Content Moderator image moderation APIs | https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/image-moderation-api |
| Use custom term lists with Content Moderator .NET SDK | https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/term-lists-quickstart-dotnet |
| Use Content Moderator text moderation APIs | https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/text-moderation-api |
| Integrate Content Moderator video scanning in .NET | https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/video-moderation-api |
| Create custom Content Understanding analyzers via REST | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/tutorial/create-custom-analyzer |

### Deployment
| Topic | URL |
|-------|-----|
| Run Foundry Tools using Azure AI containers | https://learn.microsoft.com/en-us/azure/ai-services/cognitive-services-container-support |
| Deploy Foundry containers to Azure Container Instances | https://learn.microsoft.com/en-us/azure/ai-services/containers/azure-container-instance-recipe |
| Run Foundry containers in disconnected environments | https://learn.microsoft.com/en-us/azure/ai-services/containers/disconnected-containers |
| Deploy multiple Azure AI containers with Docker Compose | https://learn.microsoft.com/en-us/azure/ai-services/containers/docker-compose-recipe |
| Deploy Foundry resources using ARM templates | https://learn.microsoft.com/en-us/azure/ai-services/create-account-resource-manager-template |