Expert knowledge for Microsoft Foundry Tools (aka Azure AI services, Azure Cognitive Services) development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. Use when using Content Moderator, Content Understanding analyzers, document layout extraction, face detection, or REST/.NET APIs, and other Microsoft Foundry Tools related development tasks. Not for Microsoft Foundry (use microsoft-foundry), Microsoft Foundry Classic (use microsoft-foundry-classic), Microsoft Foundry Local (use microsoft-foundry-local).
v1.0Latest
New~2.2kUpdated Jun 26, 2026
Microsoft Foundry Tools Skill
This skill provides expert guidance for Microsoft Foundry Tools. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. 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
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
Troubleshooting steps and FAQs for Content Understanding features, including diagnosing model issues, configuration problems, and resolving common errors in content analysis workflows.
Best Practices
L41-L46
Guidance on improving Content Understanding accuracy, grounding and confidence in document extraction, and migrating from preview to GA Content Understanding APIs.
Decision Making
L47-L54
Guidance on choosing and migrating Azure AI/Foundry document processing and Content Understanding tools, plus estimating and planning their pricing.
Architecture & Design Patterns
L55-L59
Guidance on choosing and configuring deployment options (serverless, managed, custom) for Content Understanding models, including trade-offs, scalability, and integration patterns.
Limits & Quotas
L60-L67
Quotas, limits, and supported languages for Content Moderator image/list APIs and Content Understanding, plus .NET samples showing how to stay within list and usage limits.
Security
L68-L72
Securing Azure Content Understanding analyzers and data: auth options, network isolation, encryption, access control, and best practices for protecting analyzer inputs/outputs.
Configuration
L73-L82
Configuring and customizing Content Understanding analyzers (prebuilt and custom), document layout, face detection, and cross-resource capacity settings.
Integrations & Coding Patterns
L83-L97
Using Content Moderator and Content Understanding via REST/.NET: text/image/video moderation, term lists, multimodal analysis, and consuming Markdown/structured outputs
Troubleshooting
Topic
URL
Troubleshoot and answer FAQs for Content Understanding
This skill is a reference guide for Microsoft Foundry Tools (Azure AI services) development. It provides curated navigation to Microsoft Learn documentation covering troubleshooting, best practices, decision-making, architecture patterns, quotas, security, configuration, and integration guidance for Content Understanding and Content Moderator APIs. The skill combines a local category index with remote documentation fetching via MCP tools or standard web fetch methods.
Detected Capabilities
documentation retrieval via MCP or HTTPnetwork access to learn.microsoft.comremote markdown content fetching
Trigger Keywords
Phrases that MCP clients use to match this skill to user intent.
azure content understandingcontent moderator troubleshootingdocument extraction configurationazure ai securitycontent understanding apifoundry tools best practicesdocument analyzer setup
Risk Signals
INFO
Network access required to learn.microsoft.com for remote documentation fetching
compatibility, How to Use This Skill sections
INFO
Relies on external MCP tool (mcp_microsoftdocs) availability; fallback to generic fetch_webpage
How to Use This Skill section
INFO
Metadata expiration check (3 months) suggests documentation may become stale
How to Use This Skill section
Referenced Domains
External domains referenced in skill content, detected by static analysis.
github.comlearn.microsoft.com
Use Cases
Troubleshooting Content Understanding model and configuration issues
Learning best practices for document extraction accuracy and confidence
Deciding between Azure AI document processing tools
Planning deployment options and scalability for Content Understanding
Understanding service quotas, limits, and supported languages
Securing Content Understanding analyzers and data pipelines
Configuring prebuilt and custom analyzers
Implementing Content Moderator and Content Understanding via REST or .NET APIs
Quality Notes
Positive: Well-structured category index with clear line ranges and descriptions, making navigation intuitive for agents
Positive: Comprehensive coverage of eight key topic areas (troubleshooting, best practices, decision-making, architecture, limits, security, configuration, integrations)
Positive: Explicit fallback strategy documented for missing MCP tools and network retrieval methods
Positive: Includes metadata tracking (generated_at) to flag when skill content may need refresh
Positive: Scope clearly delineated — distinguishes this skill from related Microsoft Foundry variants (microsoft-foundry, microsoft-foundry-classic, microsoft-foundry-local)
Neutral: Skill is primarily a reference navigator; actual guidance content lives in remote Microsoft Learn docs
Limitation: Line ranges in category index (L36-L40, etc.) do not match actual SKILL.md structure — appears to be placeholder from templating, reducing immediate utility of those references
Limitation: No local content examples or quick-reference snippets — all substantive guidance requires network fetch
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026
Reviews
Add this skill to your library to leave a review.
No reviews yet
Be the first to share your experience.
Use MicrosoftDocs/microsoft-foundry-tools in your dev environment — a Developer account adds skills to your library and syncs them via the SkillRepo CLI.